Integration
Claude Desktop
One address in the settings, one authorisation through your knowmind account — from then on Claude Desktop finds your notes, decisions and documents while it answers. No terminal, no install, no access key.
Prerequisites
- Claude Desktop installed and signed in
- A Claude account that may add custom connectors
- An email address for the knowmind account
Steps
- 1
Create your knowmind account
Enter your email address at knowmind.de. You receive a sign-in link by mail and use it to sign in. There is no password.
Then create your workspace: name, short name and plan. The Private plan costs 0 € and is enough for this guide; the pricing page lists the others.
Outcome: The welcome screen is open, offering “start by writing” and “connect my AI tool”. Three starter cards are already in your workspace.
- 2
Add the connector
Open the settings in Claude Desktop, go to the connectors and add a custom connector. Use this address:
texthttps://knowmind.de/api/mcp/v1No other field is needed. This route uses no access key — you sign in with your knowmind account.
Outcome: knowmind appears in the list of connectors.
- 3
Authorise access
On the first connection Claude Desktop opens a browser window with the knowmind sign-in. You sign in with your sign-in link and confirm which permissions Claude Desktop receives. The browser then returns you to the app.
Outcome: Claude Desktop reports knowmind as connected, and the app appears in the Cockpit under connected applications.
- 4
First recall
Open a new chat and ask: “What does knowmind know about my current project?” Claude calls
knowmind_recall_memoriesfor that.In a fresh workspace the recall returns the three starter cards and marks them as a starting point rather than a solid hit. So save something first: “Save to knowmind: our project round is Fridays at 9.” The next question hits straight away.
Outcome: Claude answers from your own content and shows the tool call in the chat.
Verify the result
The integration works when all three hold:
- Claude Desktop lists knowmind as a connected connector.
- In a new chat the knowmind tools appear under the tools icon.
- The Cockpit shows the app under connected applications and the recall in the timeline.
Troubleshooting
| Error message | Cause | Resolution |
|---|---|---|
| knowmind is missing from the tool list | The app read the connection only at startup. | Quit Claude Desktop completely through the menu, not just the window, and open it again. |
| The sign-in browser window stays empty | A popup blocker or browser extension holds back the redirect. | Allow popups for knowmind.de and connect the connector again. |
| Tools are visible, calls return 401 | The authorisation was revoked in the Cockpit or no longer applies. | Disconnect it under connected applications and connect again in Claude Desktop. |
| Custom connectors cannot be added | The Claude plan or the workspace administration does not allow them. | Which Claude plans allow custom connectors is set by Anthropic. In a managed workspace the administrator enables them. |
Keep the connection in the app configuration instead
To have knowmind in the Claude Desktop configuration file, create an access key under keys and run:
npx -y knowmind install claude-desktop --token kmt_YOUR_KEYThe command writes the entry itself and needs Node.js 20 or newer. With --print it only shows the entry. The file is called claude_desktop_config.json and lives in ~/Library/Application Support/Claude/ on macOS and in %APPDATA%\Claude\ on Windows.