Connect Cursor / Claude
Cursor (OAuth)
- In Cursor, add a remote MCP server with URL
https://mcp.bruce.money/mcp(no Bearer header). - Enable the server and choose Connect / sign in when prompted.
- Sign in at Bruce, pick your org, tap ChatGPT / Cursor for recommended scopes, then Approve and continue.
- 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
- Open OAuth consent, pick an organization and scopes, and copy the
bat_token. - 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 matchingcheckout,invoices,offerings,escrow,verification, andwebhooksscopes. - 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.