Connect to Claude
How to connect Symbol to Claude Desktop, Claude.ai, or Claude Code.
Symbol works with Claude Desktop (the app), Claude.ai (the website), and Claude Code (the CLI). Choose the one you use.
Claude Desktop
Claude Desktop supports remote MCP servers via its settings UI. No API key or config file editing required — sign-in is handled automatically via OAuth the first time you connect.
Open Claude Desktop settings
Click the Claude menu (Mac) or the hamburger menu (Windows) and select Settings. Go to the Integrations tab.
Add Symbol as a custom connector
Click Add custom connector and enter:
- Name: Symbol
- URL:
https://mcp.symbol.chat/mcp
Save the connector.
Authorize Symbol
Claude Desktop will open a Symbol sign-in page. Sign in and approve the connection. You only need to do this once.
Verify the connection
Ask Claude: "List my Symbol types"
If it responds with your types (or says you have none yet), you're connected.
Claude.ai
Claude.ai supports MCP through its Integrations (or Connectors) settings. No API key needed — sign-in is handled automatically via OAuth the first time you connect.
Custom integrations require a Claude Pro, Max, Team, or Enterprise plan. If you don't see an Integrations or Connectors tab, check that your plan includes it.
Open Claude.ai Integrations
- Go to claude.ai and sign in
- Click your profile icon → Settings
- Go to the Integrations or Connectors tab
- Click Add integration (or Add custom connector)
Enter the Symbol MCP details
- Name: Symbol
- URL:
https://mcp.symbol.chat/mcp
Leave the authentication field set to OAuth (the default).
Authorize Symbol
Claude.ai will open a Symbol sign-in page. Sign in and approve the connection. You only need to do this once.
Verify the connection
Start a new conversation and ask: "List my Symbol types"
Claude Code
If you use Claude Code in your terminal, add Symbol with a single command. OAuth sign-in is handled automatically in your browser.
Add the Symbol MCP server
Run this in your terminal:
claude mcp add --transport http symbol https://mcp.symbol.chat/mcpClaude Code will open a browser window for you to sign in to Symbol and approve the connection.
Use it
Start a Claude Code session and ask: "List my Symbol types"
By default the server is added at local scope (available only to you in the current project). To make it available across all your projects, add --scope user:
claude mcp add --transport http --scope user symbol https://mcp.symbol.chat/mcpAllow Symbol tools without asking
By default, Claude asks for your approval each time it uses a Symbol tool. You can change this so some or all tools run automatically.
Open tool permissions
Navigate to Customize > Connectors and select Symbol.
Choose which tools to allow
Permissions are grouped by category (e.g., read-only tools, write/delete tools). For each category or individual tool, select one of:
- Always allow — runs without asking
- Needs approval — asks before each use (the default)
- Blocked — completely disabled
To allow everything, set each category to Always allow.
For more details on managing connector permissions, see the official Claude documentation.
Troubleshooting
Claude says it doesn't know about Symbol
Check that the connector is listed and enabled in Claude Desktop settings under Connectors. If it's there but Claude doesn't respond, try removing and re-adding it.
I'm connected but my capsules aren't showing up
Try asking Claude: "What Symbol tools do you have available?" This confirms the connection is working. If tools are listed but capsules are empty, you may not have created any yet. Create your first capsule.
Claude Code: "Incompatible auth server" error
This is rare. Try running the command with a fixed callback port:
claude mcp add --transport http --callback-port 8080 symbol https://mcp.symbol.chat/mcp