Client Configurations

No credential goes in any of these files. Your client signs you in to Morphic the first time it needs it — see Authentication.

Claude Code

claude mcp add --transport http morphic \
  https://mcp.morphic.io/v2/mcp

Verify with: "ping morphic" → pong — morphic-mcp v0.x.x

Claude Desktop

Edit the config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "morphic": {
      "url": "https://mcp.morphic.io/v2/mcp"
    }
  }
}

Restart Claude Desktop after saving.

Claude.ai web connector

Open Claude.ai → Customize → Connectors → Add custom connector
URL: https://mcp.morphic.io/v2/mcp → click Connect
Sign in to Morphic on the page that opens, choose workspaces, and approve
Redirected back to Claude.ai — setup complete

After the one-time setup, Claude.ai renews a short-lived token on its own. You won’t be asked to sign in again until you revoke the connection.

Cursor

In Cursor: Settings → MCP

{
  "mcpServers": {
    "morphic": {
      "url": "https://mcp.morphic.io/v2/mcp"
    }
  }
}

ChatGPT

Open Settings → Connectors and add a custom MCP connector
URL: https://mcp.morphic.io/v2/mcp
Connect, then sign in to Morphic and approve

OpenClaw

OpenClaw should discover OAuth from the connect URL. Do not put an API key on /v2/mcp — that endpoint refuses sk_ keys.

{
  "mcp": {
    "servers": {
      "morphic": {
        "url": "https://mcp.morphic.io/v2/mcp",
        "transport": "streamable-http"
      }
    }
  }
}

First-party Morphic agents (Revenue Agent, embedded agents) keep using the internal /v1/mcp transport, which is not this URL.

Hermes

mcp_servers:
  morphic:
    url: "https://mcp.morphic.io/v2/mcp"

Same rule: no Authorization header on v2. The client runs the sign-in.

Any MCP client

Parameter	Value
URL	`https://mcp.morphic.io/v2/mcp`
Transport	Streamable HTTP
Auth	OAuth 2.1 + PKCE, run by the client. No header to set
Content-Type	`application/json`

Trimming the tool surface

Every config above advertises the full default tool surface — 100 tools. Append ?tools= to the URL to advertise only the groups you need, which cuts a large amount of context out of every connect:

https://mcp.morphic.io/v2/mcp?tools=schema,entities,activities,kb

The three paid add-on tools (parallel_search, flint_action, agentmail_action) are excluded by default and must be requested explicitly with ?tools=addons, even by workspaces that own them. See Tool Groups for the full group list and spec syntax.

Choosing a workspace

A connection identifies you, not a workspace, and only reaches the workspaces you ticked on approval. If you approved several, the assistant can pass a workspace argument on any tool call — list_workspaces returns the slugs it may use, and no reconnect is needed to switch. Add ?workspace=<slug> when you would rather pin a server entry to one:

https://mcp.morphic.io/v2/mcp?workspace=acme

With a single workspace it is selected automatically. See Authentication.

​Claude Code

​Claude Desktop

​Claude.ai web connector

​Cursor

​ChatGPT

​OpenClaw

​Hermes

​Any MCP client

​Trimming the tool surface

​Choosing a workspace

Claude Code

Claude Desktop

Claude.ai web connector

Cursor

ChatGPT

OpenClaw

Hermes

Any MCP client

Trimming the tool surface

Choosing a workspace