Skip to content
DocumentationQuickstartIntegrationsReferenceTroubleshooting
DEEN

Tutorial

Set up knowmind

Your AI remembers what you tell it, across all conversations and across tools. What you told Claude is known to ChatGPT afterwards. This guide takes you from creating an account to a connected AI tool. You need no second subscription and no credit card.

Audience
Written for people setting up knowmind for the first time. Most tools connect without a terminal; where a command is needed, the guide shows it.

Prerequisites

  • An email address you can reach permanently. If you store business content, use your business address.
  • A mailbox that accepts mail from info@knowmind.de. The sign-in link comes from there.
  • A current browser with JavaScript and cookies allowed for knowmind.de
  • In company networks: outbound connections to knowmind.de over HTTPS (port 443)

For companies: the data processing agreement applies to every business customer together with the terms of service, on every plan. You find it under data processing (German).

Steps

  1. 1

    Create your account

    Open knowmind.de/signin and enter your email address. You do not need a password. The Private plan costs nothing and does not expire; no credit card is requested.

    Outcome: knowmind tells you that the sign-in link has been sent.

  2. 2

    Open the sign-in link

    You receive an email from info@knowmind.de with a link. Click it and you are signed in. The link is valid for 24 hours and works once.

    If no email arrives, check your spam folder and request a new sign-in link. Three requests per address are possible in ten minutes.

    Outcome: You are signed in and asked to set up your workspace.

  3. 3

    Set up your workspace

    A workspace is your own, closed store at knowmind. Everything your AI remembers is kept there. knowmind asks for two things: the name of the workspace, which is the label you see later, and a short name that appears in addresses (lower-case letters, digits and hyphens). Both can be changed later.

    The Private plan is preselected and is enough to begin with. It holds 2,500 memories permanently.

    Outcome: knowmind asks which tool you work with.

  4. 4

    Choose your tool

    Pick your tool and knowmind shows the line to copy for it. Claude Code, Claude Desktop and Claude.ai sign in through your knowmind account. ChatGPT, Cursor and Gemini CLI get an API token, which knowmind creates for you at this point. You see the token only once, so copy it right away. It is as important as a password.

    You can connect further tools at any time. All of them use the same store.

  5. 5

    Connect the tool

    Claude Code: run the command in a terminal, then call /mcp once in Claude Code, select knowmind and confirm the access.

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

    Claude Desktop and Claude.ai: go to Settings → Connectors → Add custom connector and paste this address. On the first connection Claude asks for access through your knowmind account.

    text
    https://knowmind.de/api/mcp/v1

    ChatGPT: under Settings → Connectors → New custom connector enter the address and the token. Custom connectors depend on your ChatGPT plan; the ChatGPT guide has the details.

    Cursor: run the command shown in a terminal and restart Cursor. If npx is missing, install Node.js from nodejs.org.

    bash
    npx -y knowmind install cursor --token kmt_YOUR_TOKEN

    Outcome: Your tool lists knowmind as connected.

  6. 6

    Check that it works

    Tell your AI a sentence to remember, for example: “Remember that our standard contract has a notice period of three months.” Then open a new conversation and ask: “How long is our notice period?”

    Outcome: The right answer comes back. In the Cockpit, the web interface of knowmind, the counter shows how many memories are stored.

For scripts and automation

If you call knowmind from your own scripts or workflows, use an API token and the command line. API tokens are included in every plan. In the Cockpit under API tokens create a token with the rights read and write, install the client and sign in:

bash
npm install -g knowmind
knowmind login --token kmt_…

Verify the result

Setup is complete when both conditions are met:

  • Your AI tool answers the question from step 6 from your knowmind store.
  • The Cockpit shows at least one stored memory.

Troubleshooting

Error messageCauseResolution
The AI finds nothingThe tool never wrote to knowmind; the connection is not right.Check in the Cockpit whether any memories have arrived. If the counter shows zero, repeat step 5.
The tool does not know knowmindClaude Desktop, Cursor and Gemini CLI read their settings only at startup.Restart the tool after running the command or adding the connector.
The command stops with a message about npxNode.js is missing.Install Node.js from nodejs.org and run the command again.
The sign-in link does not arriveThe mail is in the spam folder, or your provider blocks the sender.Check your spam folder, allow mail from info@knowmind.de and request the sign-in link again as in step 2.
The token is lostA token is shown only once.Create a new one in the Cockpit under API tokens and delete the old one.

Related