Bron Desktop has a built-in MCP (Model Context Protocol) server. Connect an AI app to it and you can ask about your treasury in plain language — balances, transactions, addresses — without leaving the chat.

Bron supports Claude Code, Claude Desktop, ChatGPT (Codex), Cursor, and any other app that speaks MCP over streamable HTTP. The agent only ever sees the workspace and the accounts you approve, and only while Bron is open on this computer.

In Bron Desktop, click the gear icon in the top bar, next to the home button.

In the left sidebar, scroll down and pick AI agents, just above Account activity. You will see a Connect agent button, the server address with a copy button, and — if nothing is connected yet — "No agents are connected on this device yet."

That address — http://127.0.0.1:3927/mcp — is the same on every Bron install. 127.0.0.1 means the server listens on this machine only and is never reachable from the internet, so there is nothing secret about it.

Bron asks which AI app you want to connect: Claude Code, Claude Desktop, ChatGPT (Codex), Cursor, or Other AI app.

Pick yours and Bron shows a short panel with the steps for that app. Leave it open while you follow them, then jump to the matching section below.

Run this in your terminal. Any directory works:

--scope user makes Bron available in all your projects. Use --scope project if you would rather save it into one repository's .mcp.json and share it with your team.

You should see:

If you already ran it once you will get MCP server Bron already exists in user config — nothing is broken, move on.

Claude Code then opens your browser to approve. If it does not, type /mcp, pick Bron and choose Authenticate.

No terminal needed.

Prefer to do it by hand? Open ~/Library/Application Support/Claude/claude_desktop_config.json and add this inside the file's mcpServers object, keeping every server already there. If the file is empty, wrap it in { "mcpServers": { … } }:

Correct the path first if Bron lives somewhere other than Applications, then restart Claude Desktop.

Prefer to do it by hand? Open ChatGPT Settings, find the MCP servers section under Codex and add a custom server. Name it Bron, pick Streamable HTTP, paste http://127.0.0.1:3927/mcp, and leave the token and headers empty. From a terminal instead:

Add codex mcp login Bron if your browser does not open by itself.

Save, reload Cursor, and confirm if it asks you to sign in to the server.

Anything that speaks MCP over streamable HTTP can connect. In the app's MCP or connectors settings, add a custom server called Bron with the streamable HTTP transport and the URL http://127.0.0.1:3927/mcp. Leave the token and headers empty — Bron authorizes over OAuth 2.1 and the app discovers that from the endpoint itself.

Whichever app you used, Bron now shows the same consent screen. Check the Application and Workspace rows at the top and make sure they are what you expect.

Neither role can move your money on its own. Manage can prepare a transaction, but nothing happens until you sign it in Bron yourself, and your workspace approval rules still apply to every transaction. The agent never holds your keys — signing stays on your devices.

Leave All accounts, or open the dropdown and tick only the accounts the agent should see. Narrower is better — you can always reconnect with more later.

Confirm with Touch ID and click Approve.

That is what authorization means here: connecting an app registers it on this device, authorizing gives it access inside one workspace. Access tokens are short-lived and rotate automatically, and access only ever shrinks — if you lose access to an account or workspace, the agent loses it too.

Back on the AI agents page the agent appears as a card: its name, "Last active less than a minute ago", and underneath one row per authorized workspace showing the role and how many accounts it can see — for example Read only · 1 account.

This page lists agents connected on this device only. Connections you made from another computer will not appear here.

Ask the agent something in plain language:

With a Read only grant the agent can read your granted workspaces and accounts, balances and portfolio summary, transactions and their event history, transaction limits, address book and deposit addresses, assets, prices and networks, and stakes. A Manage grant adds transaction preparation on top.

Everything lives on the same Settings → AI agents page:

The MCP server runs locally and is never reachable from outside this machine. Bron does not send your data anywhere — but whatever the agent reads becomes part of your conversation with that AI app, and is then handled under that provider's data policy. Keep that in mind when choosing the role and the accounts.

Bron also has to be running: the server answers only while Bron Desktop is open and you are signed in. Close Bron or sign out and connected agents cannot reach it until you come back.

The agent says it needs authentication
The server is registered but not authorized yet. Trigger the authorize step again — in Claude Code, /mcp → Bron → Authenticate; in other apps, just ask it something about Bron.

Nothing happens when you click Connect agent
Make sure Bron Desktop is actually signed in, not just open on the lock screen.

Claude Desktop or Cursor does not see Bron
Both read their config file only at startup. Restart the app fully.

ChatGPT cannot reach Bron
Check you are in Codex mode. Regular ChatGPT runs connectors in the cloud and cannot see an app on your Mac.

The agent stops responding mid-session
Check that Bron is still open and that Pause all agents is not switched on.

If you run into any issues, contact our support team through the app or at support@bron.org.