On this page
What a connected app can do
Brunvo has its own MCP server built in. Connect an AI app to it, and the app can see and run your projects, sessions, agents, issues, and Work Hub: start an agent in Agent Mode, or a Manager agent, on any AI tool, send it a prompt from your library, and check on it. Ask it in its own words, such as start a Codex agent on the failing tests and tell me when it's done.
Connect an app
- Open Settings ▸ Connected Apps (⌘,). Connect an AI App lists apps by where they run: On this Mac (such as Claude Code, Codex, and Cursor), On the web and your phone (ChatGPT and Claude), and Another app.
- Pick the app. Brunvo shows just that app's steps, each with its button, such as Add to Claude Code.
- The first time the app connects, Brunvo asks what it may do. Choose a level and click Allow (or press Y). Brunvo must be open.
Each sheet ends with a live check: Waiting for the app…, then a green is connected once the app itself reached Brunvo.
Or let the app set itself up: Copy Setup Instructions copies a short note with this Mac's addresses. Paste it into the AI app and it adds Brunvo to its own settings, or tells you the one step only you can do. It never asks for a key or approves anything for you.
Choose its access
Each app gets one of three levels:
- Can look: sees your projects, sessions, agents, and issues, and changes nothing.
- Can work: also starts agents, sends them work, and stops them.
- Full control: everything you can do in Brunvo, including screens, closing, settings, and commands. It never asks first.
An app never raises its own access: only you change it, in Settings ▸ Connected Apps. Text an app reads from Brunvo is cleaned of hidden characters and likely passwords first.
Use Brunvo from the web
ChatGPT and Claude on the web, and their phone apps, can't reach an address on your Mac, so they connect through brunvo.com.
- In Settings ▸ Connected Apps, click ChatGPT or Claude and Turn On. You need to be signed in to your Brunvo account.
- Brunvo shows your web address. It belongs to your account and never changes, so you add it once.
- Follow the steps for that app: Copy Address and Open Claude for Claude; Make Link… and Open ChatGPT for ChatGPT, which connects with a private link.
- Sign in on brunvo.com when the app sends you there, then confirm on your Mac.
It works while Brunvo is open on that Mac. Turning it on also opens Brunvo when you log in, and web apps reconnect on their own after a restart, sleep, or a change of network. Nothing the app reads is kept on the way.
Any other app
Any app that speaks MCP can use Brunvo's address on this Mac:
http://127.0.0.1:47110/mcp
Add it to the app's MCP settings and approve its sign-in in Brunvo. For an app that cannot sign in, Another app ▸ Set Up… ▸ Create Access Key… makes a key and shows the entry to paste; the key is shown once, and Brunvo keeps only its fingerprint. Make Link… makes a private link for an app that takes only a web address. A link holds a key: treat it like one.
brunvo mcp print-config --client NAME prints the line for a particular app. The address answers only on this Mac: other computers and web pages cannot reach it.
Check and revoke
- An app that is connected opens on a green Connected card in Settings ▸ Connected Apps, with In use now while it works and its last few requests.
- Under Apps, each app's ⋯ menu has Activity (what it did), Disconnect, and Remove…, which revokes it at once.
brunvo mcp doctorchecks the whole setup and says what to fix.