Prerequisites
- Claude Code installed (
npm install -g @anthropic-ai/claude-code) - A Kavio account with an active trial or subscription (no card required to start)
Setup
1
Add the Kavio MCP server
Run the following command in your terminal:This registers the server in the project’s
.mcp.json. Append --scope user to make it available across all projects.2
Sign in through your browser
Start Claude Code and trigger the first Kavio call:Claude Code opens a browser window asking you to sign in to Kavio and authorize the connection. Click Allow — Claude Code stores the OAuth token and refreshes it automatically from then on.
Manual configuration
If you prefer to edit the config file directly, this is whatclaude mcp add writes (no Authorization header — OAuth is discovered from the URL):
.mcp.json for project scope or ~/.claude.json for user scope.
Bearer token fallback (CI, scripts, no browser available)
Bearer token fallback (CI, scripts, no browser available)
When you can’t open a browser — CI runners, remote SSH boxes, scripts — use a Personal Access Token instead:Create the key from Settings > API Keys in the Kavio dashboard. Store it in your secrets manager, not in a committed file.

