Connect an AI tool over MCP

Add the OpenKnowledge Cloud MCP server to Claude, Claude Code, ChatGPT, Codex or Cursor.

The MCP server URL

https://app.openknowledge.com/mcp

This one address reaches every brain your account can open. Use it unless you want an AI tool limited to a single brain.

You can also copy it from the app:

In the browser: open Settings from the account menu, then Agent connections. Click Copy MCP address.
In the desktop app: open Settings, then Agent connections. Under MCP addresses, click Copy Cloud MCP address.
For one brain only: open the brain's Brain settings, then General. Under Brain details, the MCP address row has that brain's own address, such as https://app.openknowledge.com/example-workspace/example-project/mcp.

You sign in with your OpenKnowledge account through OAuth. You don't need an API key or a client ID.

Add the MCP server URL to your AI tool, as described below.
The tool opens an OpenKnowledge sign-in page in your browser. Sign in, and approve the tool's access.
The tool can now use the brains you can open, with your role in each one.

The server supports OAuth dynamic client registration and client ID metadata documents, so each AI tool registers itself. It accepts only the openid, profile, email and offline_access scopes. A sign-in stays valid for 30 days and renews each time the tool uses it.

There is no read-only sign-in. The tool gets the same access you have; see What the connector can do.

Claude (claude.ai and Claude Desktop)

Connectors you add on claude.ai also work in Claude Desktop and the Claude mobile apps.

On a Free, Pro or Max plan:

In Claude, go to Customize > Connectors.
Click Add custom connector.
Enter a name, such as OpenKnowledge, and the URL https://app.openknowledge.com/mcp. Leave the OAuth settings empty.
Click Add, then Connect, and sign in to OpenKnowledge.

On a Team or Enterprise plan, an Owner adds the connector once:

Go to Organization settings > Connectors.
Select Add, then Custom. If asked for a type, choose Web.
Enter the URL https://app.openknowledge.com/mcp and click Add.

Each member then goes to Customize > Connectors, finds the connector with the Custom label, and clicks Connect to sign in with their own OpenKnowledge account.

In a chat, turn the connector on or off from the + button, under Connectors.

Claude Code

claude mcp add --transport http openknowledge https://app.openknowledge.com/mcp

Then start Claude Code, run /mcp, choose openknowledge, and sign in.

ChatGPT

Custom MCP connectors in ChatGPT need developer mode, which is available on Plus, Pro, Business, Enterprise and Edu plans. On Business and Enterprise, a workspace admin may need to turn developer mode on first.

In ChatGPT, open Settings > Apps & Connectors > Advanced settings and turn on Developer mode.
Back in Apps & Connectors, click Create.
Enter a name, such as OpenKnowledge, and the MCP server URL https://app.openknowledge.com/mcp. Set Authentication to OAuth.
Confirm that you trust the connector, then click Create and sign in to OpenKnowledge.
In a new chat, choose Developer mode from the tools menu and turn on the OpenKnowledge connector.

Codex

codex mcp add openknowledge --url https://app.openknowledge.com/mcp
codex mcp login openknowledge

codex mcp login opens the OpenKnowledge sign-in in your browser. The first command writes this to ~/.codex/config.toml, which you can also add by hand:

[mcp_servers.openknowledge]
url = "https://app.openknowledge.com/mcp"

The Codex IDE extension and the Codex app read the same configuration.

Cursor

Add the server to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json in one project:

{
  "mcpServers": {
    "openknowledge": {
      "url": "https://app.openknowledge.com/mcp"
    }
  }
}

Open Cursor Settings > MCP. The openknowledge server shows that it needs sign-in; click it and sign in to OpenKnowledge.

From the OpenKnowledge desktop app

The desktop app can set up Claude Code, Codex and Cursor on your computer for you. Open Settings, then Agent connections. Under Your AI tools, click Connect next to the tool, and the app adds OpenKnowledge to that tool's configuration.

Check the connection

Ask your AI tool: "List my OpenKnowledge projects." It should call the projects tool and show your brains. If it can't, see Troubleshooting.

On this page