Skip to main content
The Moda connector is the path for hosts where your agent cannot run a shell — claude.ai in the browser, Claude Desktop, and other chat-first surfaces. It is a hosted MCP server: you paste one URL, sign in once, and your assistant can create, read, edit, and export real Moda canvases. If your agent does have a terminal, use the CLI instead. It is cheaper in context, faster, and it can see the files on your machine. The connector exists so nobody is stuck without Moda, not as the recommended default.
The connector and the CLI call the same Moda service, so plan entitlements, credits, brand kits, and canvases are identical across both. Nothing is gated on which transport you picked.

​
Connector URL

​
Set it up on claude.ai

Open connector settings

Go to Customize → Connectors, click +, and choose Add custom connector.

Add Moda

Name it Moda, paste the connector URL above, and click Add.

Connect and sign in

Click Connect. Moda opens an OAuth sign-in in your browser; approve the scopes. Tokens are held by Claude — the model never sees a credential.

Choose a workspace

If your Moda account belongs to more than one workspace, Moda asks which one this connection should act in. One workspace and the step is skipped. Your agent can still act in another of your teams on an individual call; changing the default means disconnecting and reconnecting.

Turn it on in the chat

In a conversation, click + at the lower left (or type /), hover Connectors, and toggle Moda on.
The same URL works in Claude Desktop: Customize → + → Add custom connector.

​
Plan and workspace notes

Every member holds their own grant, so each one only ever sees the canvases, orgs, and credits their own Moda account has access to.

​
Set it up on ChatGPT

ChatGPT reaches the same connector once its developer switch is on:

Turn on developer mode

Settings → Security and login → Developer mode. Once per account.

Create the connector

Open ChatGPT Plugins, click +, and create a developer-mode app for a remote MCP server using the connector URL above.
Two things to expect there. Write actions ask for confirmation on each call by default — that is ChatGPT’s behaviour, not Moda’s, and you can tell it to remember your choice for the conversation. And developer-mode availability differs by plan, so check OpenAI’s own documentation if the switch is missing. Moda is not published as a ChatGPT deep-research connector — that needs a different search/fetch tool shape, which this surface does not expose. Developer mode is the supported route.

​
First calls

The connector expects two calls before real work:
  1. moda_bootstrap — the handshake. Returns your identity and teams, plan tier, scopes, entitlements, and the current media model matrix in one payload, so the assistant can skip a pile of lookups. (Brand kits come from brand_list.)
  2. load_skill — Moda’s full authoring guides, served live by the server. Call it before authoring a format you have not authored yet in this conversation. See Skills.
After that it is the normal loop: create or find a canvas, apply markup or an edit batch, screenshot it, repair, export.

​
What the connector can and cannot reach

The connector runs in the host’s cloud and talks to Moda’s servers. It never touches your machine. It can use: conversation context, attachments the host passes to tools, URLs you paste, and files already in your Moda workspace. It cannot use: local paths, local folders, repositories on your disk, or writing an export to a folder you choose. No connector tool takes a file path. Two consequences worth knowing:
  • Content goes inline. Markup and edit programs are passed as string arguments, not read from a file.
  • Results come back as links. Every mutation returns the canvas’s editor URL, and exports return a download link rather than writing a file. Opening it in the browser is the connector’s equivalent of the CLI writing the file next to your source.
If a host cannot pass an attachment’s bytes to a tool, the upload tool falls back to an in-conversation upload control, and failing that, to uploading the file at moda.app and telling the assistant to look for it.

​
The tool surface

The connector exposes one focused profile rather than everything Moda can do — a tool list an assistant can actually hold in its head: Work that takes a while — a video render, a large export — returns a task handle immediately; the assistant polls task_status rather than blocking the conversation. There is no tool for handing a whole design brief to Moda’s own design agent: on this surface the assistant authors the canvas itself with the tools above.

​
Troubleshooting

Still stuck? support@moda.app.