> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useagentbank.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect your agent

> Configure AgentBank MCP for Codex, Claude Code, Claude Desktop, OpenClaw, or Hermes.

Use this setup for an agent running on your device. It connects to production
by default. To try mock tokens first, see [Environment](/getting-started/environment).

For ChatGPT or Claude's remote connector, use the
[Remote MCP guides](/getting-started/hosted-oauth).

## Install the connection

The local package uses Node.js and `npx`. Choose your client:

<Tabs>
  <Tab title="Codex">
    ```bash theme={null}
    codex mcp add agentbank -- npx -y agent-bank-mcp@latest
    ```
  </Tab>

  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add agentbank -- npx -y agent-bank-mcp@latest
    ```
  </Tab>

  <Tab title="Claude Desktop">
    On macOS, edit:

    ```text theme={null}
    ~/Library/Application Support/Claude/claude_desktop_config.json
    ```

    ```json theme={null}
    {
      "mcpServers": {
        "agentbank": {
          "command": "npx",
          "args": ["-y", "agent-bank-mcp@latest"]
        }
      }
    }
    ```

    Preserve other `mcpServers` entries, fully quit Claude Desktop, and reopen it.
  </Tab>

  <Tab title="OpenClaw">
    Add the server under `mcp.servers` in `~/.openclaw/openclaw.json`:

    ```json5 theme={null}
    {
      mcp: {
        servers: {
          agentbank: {
            command: "npx",
            args: ["-y", "agent-bank-mcp@latest"],
          },
        },
      },
    }
    ```

    Then verify:

    ```bash theme={null}
    openclaw mcp doctor agentbank --probe
    ```
  </Tab>

  <Tab title="Hermes">
    ```bash theme={null}
    hermes mcp add agentbank --command npx --args -y agent-bank-mcp@latest
    ```

    Run `/reload-mcp` to load the connection.
  </Tab>
</Tabs>

## Authorize your account

Restart or reload the client, then ask:

```text theme={null}
Help me connect this agent to my AgentBank account. Do not create a payment.
```

Open the **Connect to your AgentBank Account** link. Sign in and complete the
account and wallet authorization in your browser, then return to your agent.
Confirm that it shows the expected account and wallet.

If authorization is still pending, ask the agent to check the existing setup.
Do not paste wallet keys, sign-in tokens, or World ID proofs into chat.

## Install the skill and start

Follow [Install skill](/getting-started/install-the-skill), then ask the agent
to check that AgentBank is ready. Continue with
[Your first payment](/getting-started/first-payment).

If the connection is missing, check Node.js, `npx`, and the client configuration,
then restart or reload the client. For other problems, see
[Troubleshooting](/support/troubleshooting).