ModaDocs

Setup

Connect Moda to Claude Desktop, claude.ai, Claude Code, Claude mobile, Cursor, or VS Code.

The Moda MCP server at mcp.moda.app requires no local installation. Authentication is handled via OAuth — you sign in through your browser on first use.

This page focuses on the most common setups for Moda today: Claude, Cursor, and VS Code. Other MCP-capable clients can connect to the same hosted server too, as long as they support remote MCP.

Connect your editor

Go to Settings > Connectors and add Moda as a custom connector with the URL https://mcp.moda.app. You'll be prompted to sign in on first use.

To verify, click the + button in the chat box, then Connectors — you should see Moda listed.

Go to Settings > Connectors on claude.ai and add Moda as a custom connector with the URL https://mcp.moda.app. You'll authorize via OAuth on first use.

Team and Enterprise plans: An admin must first add the Moda connector in Admin Settings > Connectors. After that, individual members can connect from their personal Settings > Connectors.

Run this command in your terminal:

claude mcp add --transport http moda https://mcp.moda.app

Verify the connection:

claude /mcp

You should see moda listed as a connected server. When you first use an MCP tool, Claude Code will open your browser for sign-in.

To remove the server later:

claude mcp remove moda

Connectors set up on claude.ai sync to the Claude mobile app automatically.

  1. Go to claude.ai/settings on your computer
  2. Add the Moda connector (see the Claude.ai (browser) tab)
  3. Open the Claude app on your phone — Moda will be available

This lets you create designs from your phone by chatting with Claude.

Open Cursor Settings > MCP and add a new server, or add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "moda": {
      "type": "streamable-http",
      "url": "https://mcp.moda.app"
    }
  }
}

You can also use a project-level config at .cursor/mcp.json in your project root.

Cursor handles the OAuth flow automatically when you first connect.

Add to your VS Code settings (settings.json):

{
  "mcp": {
    "servers": {
      "moda": {
        "type": "streamable-http",
        "url": "https://mcp.moda.app"
      }
    }
  }
}

Verifying the connection

After setting up the server, test it by asking the AI agent to describe a Moda design:

What's in this Moda design? https://moda.app/s/your-share-token

The agent should call the get_moda_design tool and return a description of the canvas contents.

Troubleshooting

Server not connecting

  • Claude Desktop: Check that Moda appears under Connectors (click the + button in the chat box). If not, go to Settings > Connectors and re-add it. Try restarting the app.
  • Claude.ai: Check that the connector appears in claude.ai/settings under Connectors. Try removing and re-adding it.
  • Claude Code: Run claude /mcp to verify the server is listed. Try claude mcp remove moda and re-add it.
  • Claude Mobile: Connectors sync from claude.ai. Make sure the connector is set up in claude.ai/settings under Connectors first, then restart the mobile app.
  • Cursor: Check that the MCP server shows as "connected" in Cursor Settings > MCP. Try restarting the MCP server from the settings panel.
  • VS Code: Ensure the MCP configuration is in your user or workspace settings.json. Restart VS Code after adding the config.

On this page