Connect Claude Code

One claude mcp add command, with an API key or by signing in.

Replace https://panel.example.com/mcp with your panel's MCP address.

API key

Make an API key and put it in your shell's environment as MINIMUS_API_KEY. Then:

claude mcp add --transport http --scope user \
  --header "Authorization: Bearer $MINIMUS_API_KEY" \
  minimus https://panel.example.com/mcp

Your shell puts the key into the command, so Claude Code stores it in ~/.claude.json. Revoke the key in the dashboard to disconnect.

Sign in

claude mcp add --transport http --scope user minimus https://panel.example.com/mcp

Then, in a Claude Code session, type /mcp, choose minimus and sign in in the browser that opens (or run claude mcp login minimus from your shell). Claude Code keeps the sign-in and renews it on its own.

Shared with a project

To share the server with everyone working in a repository, without sharing a key, add .mcp.json at the repository's root. Each person keeps their own key in their own MINIMUS_API_KEY:

.mcp.json

{
  "mcpServers": {
    "minimus": {
      "type": "http",
      "url": "https://panel.example.com/mcp",
      "headers": { "Authorization": "Bearer ${MINIMUS_API_KEY}" }
    }
  }
}

Claude Code asks each person to approve a project's servers the first time.

Check it

claude mcp list

minimus should show as connected. Needs authentication means you still need to sign in with /mcp.

Scopes of the command

`--scope`	Who gets the server	Saved in
`local` (default)	You, in this project only	`~/.claude.json`
`user`	You, in every project	`~/.claude.json`
`project`	Everyone in the repository	`.mcp.json`

These are Claude Code's scopes (where the server is saved), not the panel's read, write and manage.

Beyond the tools

Claude Code can also write and run scripts against the API with the same key: ask it to "list every expired line with the Minimus API and save them to a CSV".