Andy Developer Docs
MCP

Claude Code

Install Andy MCP in Claude Code with project .mcp.json or the CLI.

Outcome

Register the Andy Streamable HTTP MCP server in Claude Code and prove the session with get_context.

Minimum version

Claude Code ≥ 2.1.x (verified on claude 2.1.226).

Install

Recommended — browser OAuth with no client fields or headers:

claude mcp add --transport http andy https://app.andypartner.com/api/mcp

Complete the Andy browser sign-in. For headless/CI use, Claude can instead expand ${ANDY_API_KEY} from the environment in a project .mcp.json:

export ANDY_API_KEY='YOUR_ANDY_API_KEY'

.mcp.json (project scope):

{
  "mcpServers": {
    "andy": {
      "type": "http",
      "url": "https://app.andypartner.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${ANDY_API_KEY}"
      }
    }
  }
}

CLI one-liner (puts the key on the command line — shell history risk):

claude mcp add --transport http andy https://app.andypartner.com/api/mcp \
  --header "Authorization: Bearer YOUR_ANDY_API_KEY"

Optional scope (user = all projects):

claude mcp add --transport http -s user andy https://app.andypartner.com/api/mcp \
  --header "Authorization: Bearer YOUR_ANDY_API_KEY"

Remove:

claude mcp remove andy

Headless probe (read-only):

export ANDY_API_KEY='YOUR_ANDY_API_KEY'
printf '%s\n' 'Call mcp__andy__get_context with empty args. Report data.selection.status and meta.requestId.' \
  | claude -p --allowedTools "mcp__andy__get_context"

Next step

Confirm the tools list shows the 36 Andy tools, then open Auth and scopes or the Tool catalog.

On this page