Connect your AI app

OpenBrain exposes an MCP server at /mcp on your OpenBrain host. MCP (Model Context Protocol) lets supported AI apps call tools such as memory_search and memory_ingest on your behalf — no coding required.

What you need

Item	Where to get it
OpenBrain site URL	Your team’s production URL (e.g. https://memory.example.com)
API key	Account & API key
Organization ID	Dashboard → organization settings, or embedded in the key

General checklist

1. Create an API key with at least Ingest and Search for everyday use.
2. Open your AI app’s integrations, connectors, or MCP servers settings (wording varies by product).
3. Add a new MCP server pointing at:
   • URL: https://YOUR_OPENBRAIN_HOST/mcp
   • Authentication: Bearer token = your API key
   • Organization header (if the app supports custom headers): X-Organization-Id: YOUR_ORG_UUID
4. Save and restart the app if it asks you to.
5. Verify: ask the assistant to run the openbrain_health tool or to search memories. You should get a healthy response, not an authentication error.

Platform guides

Steps differ by app. Use the guide that matches where you chat:

• Claude
• ChatGPT
• Gemini
• Other MCP apps

MCP support changes quickly. If your app’s settings do not mention MCP or “connectors,” check that product’s latest help center before forcing a manual configuration.

Authentication

Use an API key (Sanctum personal access token) as the Bearer token. OpenBrain does not support MCP OAuth sign-in; see MCP OAuth (unsupported).

When things fail

Symptom	What to try
401 Unauthorized	Regenerate the key; confirm Bearer prefix; check org ID header matches the key’s organization.
402 Payment Required	Owner must activate a plan under Billing in the dashboard.
429 Too Many Requests	Wait and retry; reduce how often the app ingests in a loop.
Tools missing	Key may be search-only; add Ingest or Admin abilities in the dashboard.

For developers

If you are editing JSON config files or wiring a custom agent, use MCP setup (technical) and the tool reference.