GlossiDocs
Start free
Agents (MCP)

Connect an AI agent

Connect Claude, ChatGPT, Cursor or any MCP client to Glossi and ask it to upload models, build scenes, render and swap materials.

Glossi is an MCP server. Connect your agent once and it can take a product from a 3D file to finished renders without you opening the app: import models, build projects from templates, render every shot, make variants, change a scene in the Studio, and hand back the images. It works through the same services as the REST API.

There is nothing to install and no key to copy. You sign in with your Glossi account, and the agent acts as you, in your workspace, with your permissions.

Enterprise. Agent access is available on Enterprise. It uses the same plan gate as REST API keys.

What an agent can do

  • Get products in. Upload models, props, decals and texture folders, import from a link, or create a model from photos.
  • Build and render. Create projects from templates, render shots, clips and variants, and restyle finished renders.
  • Change a scene. Place props, move the camera, light the scene and save shots in a Studio you have open, or in a cloud Studio. See Control the Studio from an agent.
  • Organize the library. Make variants, swap and find materials, set properties, and share models.
  • Run automations. Start an automation and follow its run.

Every tool is listed in the Agent tool reference.

Connect your agent

The server URL is the same for every client:

https://api.glossi.io/mcp

Claude Code

  1. Run:
    claude mcp add --scope user --transport http glossi https://api.glossi.io/mcp
  2. In a Claude Code session, run /mcp, select glossi and choose Authenticate.
  3. Sign in to Glossi in the browser that opens, allow access, and go back to the terminal.

Claude Code has a shell, so it can bulk-import a folder of models, props, decals and texture packs from your disk. See Populate the library.

Claude.ai and Claude Desktop

  1. Open Settings → Connectors and choose Add custom connector.
  2. Enter https://api.glossi.io/mcp as the URL. Leave the client ID and secret empty.
  3. Click Add, then Connect, and sign in to Glossi.

A connector added in Claude.ai is also available in Claude Desktop. In both, the agent can show an upload panel in the chat, so you can drop models, a folder of textures or a reference photo straight from your computer.

ChatGPT

Custom MCP servers in ChatGPT need Developer mode, which is available on Plus, Pro, Business, Enterprise and Edu plans.

  1. Open Settings → Plugins → Advanced settings and turn on Developer mode.
  2. Choose Create, enter https://api.glossi.io/mcp as the server URL, and select OAuth as the authentication type. Leave the client ID and secret empty.
  3. Save, then connect and sign in to Glossi.

On a ChatGPT Business or Enterprise workspace, an admin has to enable custom connectors first, and the connector goes through a draft and publish step before members see it.

Cursor

  1. Add Glossi to your MCP settings (~/.cursor/mcp.json):
    { "mcpServers": { "glossi": { "url": "https://api.glossi.io/mcp" } } }
  2. Open Cursor's MCP settings and sign in to Glossi when prompted.

Other MCP clients

Any client that speaks streamable HTTP and OAuth 2.1 with dynamic client registration can connect. Point it at https://api.glossi.io/mcp with no client credentials; discovery is automatic through the standard protected-resource metadata. Glossi only issues tokens to known agent products and to clients that use a loopback (localhost) callback, so a client with any other redirect URL is refused at sign-in.

What to ask for

Render a model from a link

Import the chair from https://cdn.example.com/chair.glb, set it up with the Studio White template, and render every shot. Show me the results when they're done.

Make colourways

Take the Aurora Sofa project and make three colourways: swap every leather slot to cognac, then to black, then to oatmeal. Render the hero shot of each.

Put a material on a part

Add a purple suede to the shoe's tongue.

The agent finds which part is the tongue, then looks for purple suede in your library, the Glossi catalog, and the free CC0 libraries Poly Haven and ambientCG. Suede in another colour is copied and recoloured. Only when nothing fits does it offer to generate one, and it asks first because that uses usage.

Make a material from a photo

Here's a photo of the leather we use on the Aurora Sofa. Make a material from it, a little warmer than the photo, and put it in the Leathers folder.

Turn one scene into a catalogue template

Save the Aurora Sofa project as a template called "Living room hero", then build the other six sofas into it and render the hero shot of each.

Restyle last week's renders

Find the hero renders of the Aurora Sofa from last week and put each one in our Autumn Loft brand style. Show me the edits.

Upload a material library (Claude.ai and Claude Desktop)

Let me upload our fabric materials. I'll drop the folder; some of the packs are zipped.

The panel opens any .zip files, groups the maps into materials, and lists what it found and anything it skipped before you upload. Tick Generate missing maps to fill in maps a pack lacks; that uses usage.

Bulk-import a supplier drop (Claude Code or another client with a shell)

Import everything in ~/Downloads/spring-collection into the library, including the zipped packs. Group the textures into materials by name. Tell me when it's all ready and list anything that failed.

What the agent asks first

  • Usage. Renders, render edits, generated materials and model prep passes, Studio prompts and generated animation, automation runs and production view captures use your workspace's usage, as they do in the app. The agent confirms before large batches. A cloud Studio session uses Studio time while it runs.
  • Purchases. A full model prep (splitting a model into parts) is a one-off purchase charged to the workspace's saved card. A model from photos may be priced per model and paid when you approve it. The agent tells you the price and asks first. If your bank asks to confirm a payment, finish it on the model page in Glossi.
  • Deletes and replacements. Tools marked destructive in the tool reference can't be undone. The agent names what will go and asks first. A project's renders stay in the library when the project is deleted.
  • Workspace. If you belong to more than one workspace, say which. Otherwise the agent uses your default and tells you.

Troubleshooting

"Workspace ... is on a plan without agent access." Agent access comes with Enterprise. Contact sales, or ask a workspace owner.

"This application is not one Glossi supports for agent access." The client registered with a callback address Glossi doesn't recognise. Connect from Claude, ChatGPT or Cursor, or from a client that uses a loopback (localhost) callback.

The connector shows under "Custom" after an update. Remove it and add it again with the same URL. Existing connections keep working meanwhile.

Uploads from the in-chat panel fail. The panel only exists in Claude.ai and Claude Desktop. In other clients, ask the agent to import from a link, or use a client with a shell so it can upload from disk.

On this page