Dashboard

Integrations

Connect your AI assistant to read, search, and update your knowledge graph.

MCP server

One endpoint for every compatible client

https://mcp.knowen.md/mcp

Choose your assistant

Claude Desktop

Claude Desktop connects as a custom connector using OAuth. No API token is needed.

  1. Open Settings → Connectors in Claude on the web or desktop. Custom connectors cannot be added from mobile; once connected, they should be available there.
  2. Click Add custom connector (it may be under “Browse connectors” or an Add menu, depending on your plan).
  3. Enter a name such as Knowen , then set the server URL shown above.
  4. Save, click Connect , then sign in to Knowen and approve access.
  5. Enable Knowen for a new chat from the tools or connectors menu.

Sign in to Knowen when prompted to approve access.

Claude Code

Add the Knowen server with one command:

claude mcp add knowen https://mcp.knowen.md/mcp --transport http --scope user --header "Authorization: Bearer YOUR_KNOWEN_API_TOKEN"

Replace YOUR_KNOWEN_API_TOKEN with an API token from Knowen. Keep it private.

This setup uses a bearer API token.

Claude Code for VS Code

Add Knowen as a remote HTTP MCP server in the Claude Code extension.

  1. Install and open the Claude Code extension from the VS Code Extensions panel.
  2. Open the command menu with “/” and choose Customize → MCP servers.
  3. Choose Add server, then enter these values:
NameKnowen
TransportHTTP (remote)
URLhttps://mcp.knowen.md/mcp
Authorization headerAuthorization: Bearer YOUR_KNOWEN_API_TOKEN
Scopeuser
  1. Start a new session and check that Knowen shows as Connected.

Get a token from Settings → API Tokens. Keep it private.

This setup uses a bearer API token.

Cursor

Cursor supports remote MCP servers in the editor and Cursor CLI. Add Knowen to your project’s .cursor/mcp.json or ~/.cursor/mcp.json:

{
  "mcpServers": {
    "knowen": {
      "url": "https://mcp.knowen.md/mcp"
    }
  }
}

Add an Authorization header with your API token if you prefer token authentication. You can also connect with OAuth when your client prompts you to sign in to Knowen.

Choose Knowen sign-in or a bearer API token.

ChatGPT

Connect Knowen as a remote MCP server using the URL shown above. Select the authentication method offered for the Knowen connection.

  1. In ChatGPT, open Settings → Security and login and turn on Developer mode. Availability depends on your account and workspace policy.
  2. Open ChatGPT Plugins, select the plus button, and enter a name and description for the connection.
  3. Under Connection, enter the server URL shown above and choose the authentication method.
  4. Create the connection and review the tools ChatGPT discovers.
  5. Start a new conversation, add Knowen from the tools menu, and try a search in your knowledge graph.

OpenAI’s current connection guide has the latest setup steps. Confirm write actions when ChatGPT asks.

Follow the authorization prompt when connecting Knowen.

Other MCP clients

Any MCP client that supports Streamable HTTP can connect to Knowen.

TransportStreamable HTTP
Endpoint URLhttps://mcp.knowen.md/mcp
AuthenticationAuthorization: Bearer YOUR_KNOWEN_API_TOKEN

Refer to your client’s documentation for how to add a remote MCP server.

Create and manage tokens in Settings → API Tokens. Keep config containing tokens out of version control.

This setup uses a bearer API token.

Troubleshooting
“Authentication required”
Verify that you signed into the correct account or that your API token has not been revoked. Create a new token from Settings → API Tokens if needed.
My client cannot see my private trees
Confirm that you connected using the account that owns those trees.
Connection refused or timeout
Ensure your network allows outbound HTTPS to mcp.knowen.md.
Tools are not appearing
Restart your MCP client and start a new session so it can discover the server tools.