Connect Claude Code

Model Context Protocol (MCP) lets Claude Code use Agent Connect tools. You sign in through your browser. No key is pasted into Claude Code.

Add the Server

Copy the MCP URL from Connect your agent, the setup wizard’s last step, or the dashboard’s Connect MCP Client page. Choose Claude, then Claude Code, or run this in a terminal:

claude mcp add --transport http --scope user agent-connect <URL>

Replace <URL> with the MCP URL shown in Agent Connect, for example https://<your-agent-connect-host>/mcp. --scope user makes the server available in every project; without it, Claude Code adds it only for the folder you ran the command in.

Claude Code in the Claude desktop app’s Code tab reads the same settings, so the command covers it too. For Claude chats and Cowork, add a custom connector instead: see Connect Your Agent.

Sign In

1. Start Claude Code. If it was already open, restart it. Servers added during a session load only in a new session.
2. Type /mcp, choose agent-connect, and choose Authenticate.
3. Your browser opens. Sign in to Agent Connect and choose which agent Claude Code should use, or create one there.
4. Select the accounts it can use and complete the signature request for each one with the wallet or passkey you signed in with.

Agent Connect shows Waiting for your agent to sign in… and then Connected with the client’s name.

Test Before Spending

Ask Claude Code:

What are my Agent Connect balances?

It should list your accounts and their balances. A zero balance is still a successful check.

Use an API Key Instead

For a headless Claude Code, such as one running on a server, choose Use an API key instead on the dashboard’s Connect MCP Client page. You complete one signature request per account, and the key lasts 30 days. It is shown once.

Set the key in the shell that starts Claude Code:

export AGENT_CONNECT_KEY=...

Then reference the variable in .mcp.json. Claude Code expands environment variables in this file:

{
  "mcpServers": {
    "agent-connect": {
      "type": "http",
      "url": "<URL>",
      "headers": { "Authorization": "Bearer ${AGENT_CONNECT_KEY}" }
    }
  }
}

Never paste the key into a prompt or commit it to a repository.

Disconnect

Choose Disconnect in the dashboard to revoke Claude Code’s access. For each account, you sign the grant revocation. See Troubleshooting if tools are missing or sign-in fails.

MCP Tools