For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /guide/connect-over-mcp.md.

Connect over MCP

The hub serves an MCP endpoint at /mcp. An agent connected to it can search, read and save entries itself.

Tools

ToolWhat it does
findFull-text search over every entry, across projects or within one.
list_entriesThe path, kind, scope and labels of the entries, without their text.
read_entryOne entry's settings, hash and full text.
save_entryCreates an entry or stores a new version. Pass the hash from read_entry as baseHash; if the entry changed meanwhile, nothing is stored and the answer says so.

Claude Code

The hub knows Claude Code as the program claude-code, with the callback port 47632.

claude mcp add --scope user --transport http --client-id claude-code --callback-port 47632 korbo http://127.0.0.1:5180/mcp

Then type /mcp in a Claude Code session, pick korbo, and sign in in the browser. claude mcp login korbo does the same from a terminal. To remove it: claude mcp remove korbo -s user.

Use the address exactly as shown. To the hub, localhost in place of 127.0.0.1 is a different address, and it is refused.

Programs that describe themselves

Some programs present a client ID metadata document: an https address that describes the program. The hub fetches it and checks it, then shows you a consent page each time such a program asks for access. Nothing has to be set up by hand.

Claude Code, Codex and Antigravity can do this. So far it has been tested with Claude Code's document only.

See and end access

korbo grants
korbo revoke <client ID or name>

grants lists the programs that can use your hub, and when each last got a token. revoke ends one program's access at once; it can ask again on the sign-in page.