knowmindknowmind
DokumentationQuickstartAnbindungReferenzFehlerbehebung
DEEN
knowmindknowmind
DocumentationQuickstartIntegrationsReferenceTroubleshooting
DEEN

Integration

Claude Code

One command and a browser sign-in, and every Claude Code chat has access to the eleven knowmind tools — recall, store, link, unlink, stats and six more. No API token and no extra install required.

Audience
Developers working with Claude Code who need a persistent Memory Store across sessions. Works from the free Privat plan onward.

Prerequisites

  • Claude Code installed and up to date (check: claude --version)
  • A knowmind account (the free Privat plan is enough)

Steps

  1. 1

    Connect with a single command

    Run this in your terminal:

    bash
    claude mcp add --transport http knowmind https://knowmind.de/api/mcp/v1

    On the first call, Claude Code opens your browser. You sign in to knowmind (sign-in link by email) and confirm access. knowmind sets up the workspace automatically; the connection is then stored in Claude Code. You do not need to create a token or install anything else.

    Outcome: claude mcp list shows knowmind as Connected.

  2. 2

    Smoke-test from chat

    Start a Claude Code session and ask a question that points at content in your Memory Store. Claude usually recognises the need for a recall on its own. If needed you can ask explicitly: "Look up … in knowmind".

    bash
    $ claude
> What open items are on the Müller contract?

    Outcome: Claude calls knowmind_recall (visible in the tool output) and answers based on the hits from your Memory Store.

  3. 3

    Save a memory from the chat

    In the same chat you can ask Claude to write something into knowmind. Claude picks knowmind_store_memory (for short notes) or knowmind_upload_document (for longer texts that need chunking).

    bash
    > Store as a new memory: "QM training confirmation Maria, 12 March"

    Outcome: Claude confirms the new memory and returns its memory ID. The entry appears immediately in the knowmind dashboard.

Alternative: HTTP transport with your own API token

For unattended setups (CI, servers without a browser), use an API token instead of the browser sign-in — available on every plan, including the free Privat tier. In the dashboard under API Tokens create a token with scopes read and write, then:

bash
claude mcp add knowmind \
  --transport http \
  --url https://knowmind.de/api/mcp/v1 \
  --header "Authorization: Bearer kmt_…"

Verify the result

The integration is healthy when all three conditions hold:

  • claude mcp list shows knowmind as Connected.
  • In the chat, a domain question triggers a knowmind_recall call.
  • The knowmind dashboard "Recent activity" lists the actions you took.

Troubleshooting

Error messageCauseResolution
Browser sign-in does not open / mcp list shows FailedOutdated Claude Code version without OAuth, or the address was entered incompletely.Update Claude Code and enter the address exactly as https://knowmind.de/api/mcp/v1. If your setup has no browser (CI/server), use the token route described above.
Tool calls time outFirst request in a cold-start situation or network latency.Retry the request. If it persists, run knowmind health to verify service reachability.
Memory type unknownClaude passed an invalid memory_type value.Valid values: semantic, episodic, procedural, reference. Be explicit with Claude on the next save.

Related