What’s governed
Because model requests don’t pass through Barndoor, set up nothing under Model Routes, Model Access, or Client settings for this mode. Connect your MCP servers, turn on the local tools people need, and write the policies that grant them, as in Give people tools.
What each client does
People still start each client from Bridge. That’s what adds the Barndoor MCP server.
Each terminal launch prints one line saying so:
barndoor: your organization's Bridge setting governs tool traffic only; the client uses its own model sign-in.
The Codex policy and plain codex
If your Macs have the Codex policy, which the MDM updater installs unless you opt out, codex started outside Bridge fails with requirements.toml allowed_permission_profiles refers to undefined profile barndoor-active. Under MCP only that means people lose plain Codex: only barndoor run codex and Launch Codex Desktop work. Opt out of the Codex policy if people need to run Codex on its own.
What it guarantees
- Every Barndoor tool call is governed. Remote and local tools both work through the Barndoor MCP server, under your policies, approvals, and data protection, and every call is audited. The server runs on the person’s computer, so tools that run locally work as they do under Models and MCP.
- Claude Code and Codex sessions started from Bridge have Barndoor as their only MCP server.
- In Claude Desktop, the Barndoor server isn’t locked in. It’s an entry named
barndoorin the person’s own configuration. They can switch it off or remove it, and launching from Bridge again puts it back. Their own connectors and MCP servers run beside it, outside your policies. On a personal sign-in, Claude Desktop accepts managed MCP servers only in its Code tab, so its chat can’t be locked. - A client opened directly, not from Bridge, has no Barndoor server unless you add one for it; see the next section.
Managed Barndoor server for Claude Code
In Claude Desktop, the Barndoor MCP server Bridge adds is the person’s to remove. This profile adds your Barndoor gateway to Claude Code as a server the organization provides, which people can’t remove. It isn’t in the MDM kit: you write and deploy it yourself. It uses Claude Code’s own managed settings, so it applies to the Claude Code CLI and to the Code tab in Claude Desktop, on a personal claude.ai sign-in.-
Create a configuration profile with a custom settings payload for the preference domain
com.anthropic.claudecode, at device scope, with this content. Replace{{your-org}}with your organization’s Barndoor host. -
Keep the name
barndoor-gateway, or another name that isn’tbarndoor: a managed server namedbarndoorwould replace the one Bridge adds, and local tools would stop working. Deploy it to the same devices as Bridge. Claude Code picks it up on its next start; Claude Desktop needs a restart. -
Each person signs in to Barndoor once. In a terminal, Claude Code shows the server as needing authentication under
/mcp; in Claude Desktop’s Code tab, a Reconnect barndoor-gateway prompt appears in the session. -
On a Mac, check it:
Expect
Scope: Managed settings (provided by your organization).claude mcp remove barndoor-gatewayis refused.
- Remote tools only. This server is your hosted gateway, which can’t reach the laptop. It still lists tools that run locally, but calling one returns
runs locally via barndoor-cli and is not executable through the platform router. For local tools, people use thebarndoorserver Bridge adds. - Not Claude Desktop’s chat. Claude Desktop on a personal sign-in ignores managed MCP servers outside the Code tab, and the server doesn’t appear in the Connectors menu, so there’s no switch to turn it off.
- Don’t combine it with provider lockdown. A managed-settings profile for Claude Code makes it ignore the Claude policy’s managed settings file entirely, including Barndoor’s hooks, and
barndoor doctorreports the policy as overridden. Lockdown also blocks the direct provider access that MCP only sessions need. - To allow only Barndoor, Claude Code’s managed settings also take
disableClaudeAiConnectors(no claude.ai connectors) andallowedMcpServers(an allowlist for servers people add; an empty list allows none, and the managed server stays). These are Anthropic’s settings, not Barndoor’s; see the Claude Code documentation, and roll them out to a few Macs before the whole fleet.
If people also have the hosted Barndoor connector in Claude
Some people also have Barndoor added as a connector on their claude.ai account, the hosted gateway. Under MCP only, Claude Desktop then shows two Barndoor connectors:barndoor from Bridge, and their own. With both on, Claude can pick the hosted connector, in Chat and in the Code tab.
The hosted connector lists the tools that run on the laptop but can’t run them:
- In Chat, a local tool is refused with a message that it only runs locally through barndoor-cli.
- In the Code tab, the agent may instead run
barndoor tools callin its own shell. The call works, but the audit log records it under the agent Barndoor CLI, not Claude. - Remote tools work through the hosted connector and are audited under Claude.
barndoor, and both local and remote tools run, audited under Claude. Get started tells people this.
What people see
- Launching Claude Desktop while it’s open. From Bridge v0.1.250, on macOS the Bridge window asks Quit Claude Desktop? and, if the person agrees, quits it and opens it again with
barndooradded.barndoor run claude-desktopin a terminal quits and reopens it without asking. On Windows, Bridge can’t quit Claude Desktop for them, because closing its window leaves it running in the notification area: the launch is refused, and the person quits Claude Desktop and launches again. With an earlier Bridge, Claude Desktop must be fully quit before launching it from Bridge: if it’s already open,barndoormay not appear, or may disappear the next time the person changes a setting, because Claude Desktop rewrites its configuration from memory. - Their own
barndoorentry. If someone already has abarndoorserver of their own in Claude Desktop’s configuration, Bridge leaves it as it is and says so. Local tools then depend on that entry. - Local tools refused through the hosted gateway. A local tool called through a claude.ai connector, or the managed server above, is refused: the managed server returns
runs locally via barndoor-cli and is not executable through the platform router. Thebarndoorserver from Bridge runs it. See the section above.
Switching back to Models and MCP
When you set the organization back to Models and MCP while someone’s Claude Desktop is open, Bridge leaves thebarndoor entry in place until Claude Desktop quits. Once they quit it and Bridge syncs, the entry is removed from their Claude Desktop configuration, and it doesn’t come back when they reopen Claude Desktop.