Use AC with Claude Desktop

Prerequisites

• Claude Desktop installed (macOS or Windows).
• Node ≥ 20 available on your PATH — needed for npx.
• An ac_live_… key from /agent in the AC app.

1 · Open the MCP config

On macOS:

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows:

notepad "$env:APPDATA\Claude\claude_desktop_config.json"

If the file doesn’t exist yet, create it. The minimum valid contents are { "mcpServers": {} }.

2 · Add the server block

{
  "mcpServers": {
    "advisors-crypto": {
      "command": "npx",
      "args": ["-y", "@advisors-crypto/mcp"],
      "env": {
        "AC_AGENT_KEY": "ac_live_…"
      }
    }
  }
}

3 · Restart Claude Desktop

Quit fully (⌘Q on macOS — closing the window isn’t enough) and reopen.

4 · Verify

Start a new conversation and ask:

Use the whoami tool from advisors-crypto and tell me what user this key is for.

Claude should show a tool-use card, call whoami, and report back the user id and your active scopes. If it can’t see the tool, check the server logs in Claude Desktop’s diagnostic panel.

5 · Next moves

• Try the review-portfolio prompt — Claude Desktop surfaces prompts in the slash menu.
• Ask the model to “propose a small BTC buy if my policy allows”. Watch it chain get_mandate → validate_trade → propose_trade.
• Open /agent in the AC app. Your key should now show a lastUsedAt timestamp and the attestation queue should have the proposal.

Troubleshooting

• “Tool not found” — the server didn’t start. Check Claude Desktop’s server logs for the npx error.
• 401 on every call — your key is wrong, expired, or revoked. Mint a new one and update AC_AGENT_KEY.
• Missing scope — your key doesn’t carry the scope this tool needs. Revoke + mint a new key with the right scopes.