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 andy_identity_status.

Minimum version

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

Install

Recommended — key stays out of the shell history; Claude expands ${ANDY_API_KEY} from the environment when using 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__andy_identity_status with empty args. Report data.status and meta.requestId.' \
  | claude -p --allowedTools "mcp__andy__andy_identity_status"

Next step

Confirm tools list includes andy_*, then open Auth and scopes or the Tool catalog.

On this page