MCP Server for connecting your context maps to AI assistants
Model Context Protocol

Step 1 — Generate an API Token

  1. Open your map at contextmap.app
  2. Click the AI menu in the map header toolbar
  3. Select "Connect to Claude or ChatGPT"
  4. Give your token a name (e.g. "Claude Desktop") and click Create
  5. Copy the token — it starts with cm_ and is shown only once

Step 2 — Connect to Your AI Assistant

  1. Go to claude.ai → Settings → Connectors
  2. Click "Add custom connector"
  3. Enter a name for the connector (e.g. your map's name)
  4. Paste your MCP URL into the "Remote MCP Server URL" field:
http://mcp.contextmap.ai/t/{your_token}/mcp
Leave the OAuth fields empty — authentication is handled by the token in the URL.
  1. Open Claude Desktop app (not the browser)
  2. Go to Settings → Developer → Edit Config
  3. Add the following to the mcpServers section:
{ "contextmap": { "command": "npx", "args": ["-y", "@contextmap/mcp-server"], "env": { "CONVEX_URL": "https://cloud.contextmap.ai", "CM_API_TOKEN": "your_token_here" } } }
  1. Restart Claude Desktop to pick up the new config
  1. Open ChatGPT and start a new conversation
  2. Click the connectors / tools icon in the message bar
  3. Select "Add an MCP Connector"
  4. Paste your MCP URL:
http://mcp.contextmap.ai/t/{your_token}/mcp
ChatGPT uses Streamable HTTP transport — just paste the URL with your token.