Skip to content

Connect OpenBrain to Claude

Anthropic’s Claude apps (Desktop and supported web experiences) can attach MCP servers so Claude can search and save memories in OpenBrain.

Before you start

Claude Desktop (MCP)

  1. Install or update Claude Desktop to a version that supports MCP connectors.
  2. Open Settings → Connectors (or Developer → MCP, depending on your app version).
  3. Add a custom MCP server:
    • Server URL: https://YOUR_OPENBRAIN_HOST/mcp
    • Authentication: provide your OpenBrain API key when prompted, or use Sign in with OpenBrain if OAuth is offered (MCP OAuth).
  4. If the UI asks for extra headers, add:
    • X-Organization-Id: your organization UUID
  5. Enable the OpenBrain connector for new chats.
  6. Test: ask Claude to “check OpenBrain health” or “search my memories for …” and confirm it calls openbrain_health or memory_search.

Claude on the web

Web Claude may expose MCP or connectors only on certain plans or betas. If you do not see connector settings:

  • Use Claude Desktop for MCP today, or
  • Check Anthropic’s current documentation for “MCP” or “connectors.”

Tips for everyday use

  • Tell Claude explicitly when to remember something (“save this to OpenBrain”) so it calls memory_ingest.
  • Before long sessions, ask it to search OpenBrain for relevant context.
  • Owners can review what was written in the dashboard Audit log (no raw message text is stored in audit metadata).

Troubleshooting

  • OAuth redirect errors: your host must allow the claude:// callback scheme in production (MCP OAuth).
  • Wrong organization: verify X-Organization-Id matches the org that owns the API key.

← Back to Connect your AI app