Skip to main content

Connect Claude

Anthropic's Claude (both claude.ai and the Claude Desktop app) supports remote MCP connectors via the Integrations screen.

Steps​

  1. Open Claude → Settings → Integrations
  2. Scroll to Custom integrations and click Add integration
  3. Choose Custom MCP server
  4. Paste the URL: 
    https://api.sharedmemory.ai/mcp
  5. Click Connect. A browser tab opens to SharedMemory.
  6. Sign in and pick the default project, then click Allow.

Claude now has access to the SharedMemory tool catalog. You can ask Claude to remember, recall, or search any of your memory directly in chat.

How to use it​

"Save this to memory: our team uses BullMQ for background jobs."

"What's the latest decision we made about the auth flow?"

"Tell me everything you know about Project Atlas."

Claude will route those to remember, query, and get_entity automatically.

Project switching​

The connector defaults to the project you chose at consent. To target a different one, mention it by name:

"In project personal, remember my dentist's next appointment is March 12."

Claude Desktop vs Claude Code​

Both work with the same https://api.sharedmemory.ai/mcp URL. The difference:

  • Claude Desktop (the macOS/Windows app) uses the Integrations UI shown above
  • Claude Code (the CLI) reads connectors from ~/.config/claude-code/config.toml — you can also use the local stdio MCP server if you prefer (see the MCP Server SDK page)

For Claude Desktop, the remote connector is usually the better choice because it survives reinstalls and works across devices.

Revoking access​

Open SharedMemory Dashboard → Connectors → Connected apps and click Revoke next to Claude. The next request from Claude will fail with 401 and prompt you to reconnect.

Troubleshooting​

The browser didn't redirect back to Claude — make sure popup blockers aren't preventing the bounce-back. The redirect URI is https://claude.ai/api/mcp/auth_callback and it must complete inside the same browser session as the consent screen.

Tools don't appear in Claude — Claude refreshes its tool catalog when a new connector is added. If tools aren't showing up after 30 seconds, toggle the connector off and on in Settings → Integrations.