Claude Code

Connect the Catio MCP to Claude Code.

Claude Code is Anthropic's agentic coding CLI.

1. Add the server

claude mcp add --transport http catio https://mcp.catio.tech/mcp

By default the server is added for you in the current project. Use --scope user to make it available in all projects, or --scope project to write it to .mcp.json so your team shares it.

To use OAuth, do not set an Authorization header. A header disables the OAuth sign-in. To sign in with an API key instead, see Using an API key instead of OAuth below.

2. Authenticate

Start Claude Code, run /mcp, select catio, and follow the browser flow to select your org and workspace. Or from your shell:

claude mcp login catio

3. Verify

Run claude mcp list and check that catio is connected. Then ask:

Tell me about my Catio session

Using an API key instead of OAuth

If your workflow cannot run the OAuth browser flow, pass a key directly:

claude mcp add --transport http --header "Authorization: Bearer catio_YOUR_KEY" catio https://mcp.catio.tech/mcp

Create the key under Settings → API keys in the console. Skip the /mcp login step: the key authenticates the connection on its own. See API Keys.

Sign in again

claude mcp logout catio
claude mcp login catio

You can also choose Clear authentication in the /mcp menu.


Did this page help you?