Connect AI agents to Knotenhirn via MCP
MCP (Model Context Protocol) is the open standard AI agents use to work with tools. Knotenhirn has a built-in MCP server. Your agent then asks your team's knowledge first and stores new findings there.
What you need
- A Knotenhirn account. Start your team for free if you do not have one yet.
- The address of the MCP server:
https://knotenhirn.dev/mcp
You sign in in the browser with the same Microsoft or Google account you use for Knotenhirn. There is no API key. The agent sees exactly the notes you are allowed to see.
Claude Code
Run this once in the terminal; the server then applies to all your projects:
claude mcp add --transport http --scope user knotenhirn https://knotenhirn.dev/mcp
Then run /mcp in Claude Code, choose knotenhirn and sign in in the browser. After that,
Claude Code renews the token itself.
Claude Desktop and claude.ai
- In Claude, open Customize › Connectors and choose Add custom connector.
- Enter
Knotenhirnas the name andhttps://knotenhirn.dev/mcpas the URL, then add it. - Click Connect and sign in in the browser.
The connector works in Claude Desktop, in the browser and in the app. Claude connects from Anthropic's servers, not from your computer. On the Free plan, one custom connector is possible. On Team and Enterprise, an owner adds the connector for the organisation, and then each person connects themselves.
Other clients
Codex CLI
codex mcp add knotenhirn --url https://knotenhirn.dev/mcp
Then run codex mcp login knotenhirn and sign in in the browser.
Gemini CLI
gemini mcp add --transport http knotenhirn https://knotenhirn.dev/mcp
Then run /mcp auth knotenhirn in Gemini CLI and sign in in the browser.
VS Code with GitHub Copilot
In the command palette, choose MCP: Add Server, then HTTP, and enter the address
https://knotenhirn.dev/mcp and the name knotenhirn. Or in mcp.json:
{
"servers": {
"knotenhirn": { "type": "http", "url": "https://knotenhirn.dev/mcp" }
}
}
On first access, VS Code opens the sign-in in the browser. In Copilot Business and Enterprise, the organisation's “MCP servers in Copilot” policy must be enabled.
Cursor
Add this to ~/.cursor/mcp.json; Cursor then signs in in the browser:
{
"mcpServers": {
"knotenhirn": { "url": "https://knotenhirn.dev/mcp" }
}
}
This applies to Cursor on your computer. Cursor in the browser and the Cursor Agents sign in through an address of their own, which Knotenhirn does not support at the moment.
Other MCP clients
Any client with Streamable HTTP and OAuth sign-in in the browser can connect, as long as it completes the sign-in via
localhost on your computer. ChatGPT uses an address of its own for this and therefore cannot be connected at
the moment.
What your agent can do with it
search_team_knowledge- finds notes by words and meaning, before the agent looks elsewhere
save_note- creates a new note and names similar ones that would be better extended
update_note- changes a note or moves it to another group
read_note- loads a note in full, with its links and backlinks
list_groups- shows the groups in which the agent may store notes
Changes made by the agent appear in the history marked “via MCP”. Searches without results show up in your team's knowledge gaps.
If it does not work
- Sign-in is cancelled: sign in with the account you also use for Knotenhirn in the browser.
- The agent finds nothing: it sees only the groups you may see. Check in Knotenhirn whether the note is in one of your groups.
- Trial is over: without a subscription, access via MCP is closed; in the browser everything stays readable.
As of October 2026. Client menus and commands may change; the documentation of each vendor is what counts.