knowmindknowmind
DokumentationQuickstartAnbindungReferenzFehlerbehebung
DEEN
knowmindknowmind
DocumentationQuickstartIntegrationsReferenceTroubleshooting
DEEN

Integration

Claude.ai (browser)

This guide registers knowmind as a custom connector in the browser version of Claude.ai. The connector uses either a static API token or OAuth with dynamic client registration. Setup takes around three minutes.

Audience
Private and business users on Claude.ai in the browser — typically on Claude Pro or Claude Max. The free tier limits the number of custom connectors.

Prerequisites

  • Claude.ai account on Pro, Max, Team or Enterprise
  • knowmind account on any plan
  • For the token option: an API token of the form kmt_…
  • For the OAuth option: nothing up front, the connector triggers the sign-in itself
Note

OAuth is the recommended option

OAuth is more convenient (no token handling) and safer (short-lived access tokens, automatic refresh). Choose OAuth if your knowmind plan unlocks it. The token option remains for older connector versions and as a fallback.

Steps

  1. 1

    Open the connector dialog

    In Claude.ai, click your profile icon top right, then Settings → Connectors → Add custom connector. The wording varies by UI language.

    Outcome: The connector setup dialog is visible.

  2. 2

    Option A: OAuth (recommended)

    Fill the fields as follows:

    text
    Name:       knowmind
URL:        https://knowmind.de/api/mcp/v1
Auth type:  OAuth (or "Sign in with provider", depending on UI version)

    Claude.ai reads the OAuth discovery metadata from the MCP endpoint and registers itself as a client automatically (Dynamic Client Registration, RFC 7591). You are redirected to knowmind.de/oauth/authorize, sign in with your magic link, confirm the requested permissions and return to Claude.ai.

    Outcome: In the knowmind dashboard, under OAuth Clients, Claude.ai appears as a connected application.

  3. 3

    Option B: API token (fallback)

    If OAuth is not available in your Claude.ai version or your knowmind plan, use the static bearer token.

    text
    Name:       knowmind
URL:        https://knowmind.de/api/mcp/v1
Auth type:  Bearer
Token:      kmt_… (from knowmind dashboard → API Tokens)
  4. 4

    Confirm the connection

    In the connector dialog click "Add" or "Connect". Claude.ai tests the endpoint and calls tools/list to display the available tools.

    Outcome: In every new Claude.ai chat a tools area appears on the right with the ten knowmind tools.

  5. 5

    Smoke test

    Start a new chat and ask a question that targets content in your Memory Store.

    Outcome: Claude answers based on knowmind content. The tool-call area shows knowmind.recall and the result.

Verify the result

The integration is set up correctly when all three conditions hold:

  • In the Claude.ai connectors area, knowmind is shown as connected.
  • In new chats the knowmind tools appear in the tools area.
  • With OAuth: in the knowmind dashboard under OAuth Clients, Claude.ai is listed.

Troubleshooting

Error messageCauseResolution
Cannot add a connectorPlan does not allow custom connectors, or the per-account connector limit is reached.In Claude.ai under Settings → Plan, verify your plan. The free tier limits the number of connectors. Pro and Max raise this limit significantly.
OAuth sign-in failsMagic link did not arrive or the browser blocked the popup.Check your popup blocker. If the magic link is missing, check the spam folder. If needed, fall back to the token option.
401 unauthorized on tool callToken revoked or OAuth session expired.In the knowmind dashboard under OAuth Clients disconnect the client and add it again in Claude.ai. For Option B: create a new token.
Tools not visible in older chatsExisting chats open with the tool inventory of the time they were created.Start a new chat. Existing chats can usually be updated by re-selecting tools.

Related