Connect Cursor / Claude

Cursor (OAuth)

  1. In Cursor, add a remote MCP server with URL https://mcp.bruce.money/mcp (no Bearer header).
  2. Enable the server and choose Connect / sign in when prompted.
  3. Sign in at Bruce, pick your org, tap ChatGPT / Cursor for recommended scopes, then Approve and continue.
  4. Cursor receives access and refresh tokens automatically (same OAuth flow as ChatGPT).

If sign-in fails, check Output → MCP in Cursor and ensure redirect URIs such as http://localhost:8787/callback are allowed (dynamic registration handles this).

Manual token

  1. Open OAuth consent, pick an organization and scopes, and copy the bat_ token.
  2. For pay, balance, escrow funding, and mandates, include the agent scopes (agent:pay, agent:balance:read, agent:escrow:fund, agent:mandate, agent:read) on that consent screen. Merchant tools need the matching checkout, invoices, offerings, escrow, verification, and webhooks scopes.
  3. Add the remote MCP config:
{
  "mcpServers": {
    "bruce": {
      "url": "https://mcp.bruce.money/mcp",
      "headers": {
        "Authorization": "Bearer bat_…"
      }
    }
  }
}

A long-lived bk_live_… key works the same way as Bearer or X-Api-Key for merchant tools. A dedicated agent key uses bk_agent_live_… instead. See Agent pay via MCP and the tool catalog.