Skip to main content
Claude Desktop speaks MCP over local stdio — kataven-mcp plugs in directly, no tunnel needed.
Already done Install? Skip to step 3. Otherwise: pip install kataven-mcp, then mint an API key.

1. Open Claude Desktop’s MCP config

Easiest path — let Claude Desktop open the file for you: Settings (gear icon) → DeveloperEdit Config This opens the file in your default editor and creates it if it’s missing. If you’d rather edit directly:

2. Paste the universal entry

If claude_desktop_config.json already had other MCP servers, merge — keep one outer mcpServers object with multiple keys inside it.

3. Fully quit and relaunch

Cmd+Q on Mac (not just close-window — Claude keeps running in the dock). Ctrl+Q on Linux. On Windows, right-click the system-tray icon → Exit, then relaunch.

4. Verify

Open a new chat. The 🔧 hammer icon below the message composer shows tools available — you should see kataven_list_agents, kataven_create_agent, etc. Try:
List all my Kataven agents.
Claude calls kataven_list_agents and replies with the list. If you see “No tools available from kataven” or the server doesn’t appear at all, see Troubleshooting.

5. Verify in the dashboard

After Claude makes changes, sanity-check at the corresponding Hub UI route:

See also