BridgeApp plugins
Official plugins that connect a coding agent to a BridgeApp workspace over MCP, so it can read and act on tasks, chats, threads, pages, and projects under the signed-in account's own permissions.
Claude Code
claude plugin marketplace add MathAndMagic/bridgeapp-plugin
claude plugin install bridgeapp@bridgeapp
Then sign in — this needs an interactive terminal, so run it yourself rather
than asking an agent to. Claude Code addresses a plugin-provided server as
plugin:<plugin>:<server>, unless a bridgeapp server was already registered
by hand — then it keeps that entry, adds no plugin copy, and the bare name is
the one to sign in to:
claude mcp login plugin:bridgeapp:bridgeapp || claude mcp login bridgeapp
Codex and ChatGPT
The same plugin installs into Codex — MCP server and skills together:
codex plugin marketplace add MathAndMagic/bridgeapp-plugin
codex plugin add bridgeapp@bridgeapp
Codex asks you to sign in to BridgeApp the first time a tool is used. The
ChatGPT desktop app shares ~/.codex with Codex, so the install above serves
both. To install from the app instead, open Plugins, choose Add
marketplace and then Add from a repository, enter
MathAndMagic/bridgeapp-plugin, and install BridgeApp from that marketplace.
The manifest lives in .codex-plugin/plugin.json and the marketplace in
.agents/plugins/marketplace.json; both read the same skills/ and .mcp.json
as the Claude Code and Cursor manifests.
Other agents
Point any MCP client that speaks streamable HTTP with OAuth at:
https://mcp.bridgeapp.ai/mcp
It discovers the authorization server and the bridgeapp:mcp scope on its own
from https://mcp.bridgeapp.ai/.well-known/oauth-protected-resource.
Per-client instructions, including the ones an agent can follow on its own, live
in agent-setup.md, published at
https://bridgeapp.ai/agent-setup.md and at /agent-setup.md on every
workspace host.
That file is the master copy. The same file ships in bridgeapp-web
(public/agent-setup.md, serving every workspace host) and in bridge-website
(public/agent-setup.md, serving the apex domain) — edit it here and copy it to
both in the same piece of work, byte-identical.
Self-hosted workspaces
Every URL above belongs to the hosted service. BridgeApp also runs on customers'
own infrastructure, under domains of their choosing, and the plugin ships the
hosted endpoint in .mcp.json — deliberately
as a plain value: Claude Code substitutes plugin settings unreliably across
versions, and a server that silently fails to register is worse than a fixed
URL. On a self-hosted workspace, install the plugin first anyway — the skills
apply to any workspace — and then register the workspace's own endpoint, shown
on its Agents → Connect Apps page, next to it.
Claude Code:
claude mcp add --scope user --transport http bridgeapp https://mcp.example.com/mcp
claude mcp login bridgeapp
Codex and the ChatGPT desktop app, under a name of its own so it does not
replace the plugin's bridgeapp entry (add starts the sign-in itself):
codex mcp add bridgeapp-workspace --url https://mcp.example.com/mcp
The plugin's own hosted server stays unauthenticated — do not sign in to it —
and can be ignored or removed. Links back into the workspace come from the
server's build_bridgeapp_link tool, so they carry the self-hosted domain on
their own.
What is in here
plugins/bridgeapp/
.claude-plugin/plugin.json Claude Code manifest
.cursor-plugin/plugin.json Cursor manifest
.codex-plugin/plugin.json Codex / ChatGPT manifest (directory metadata, logo)
.mcp.json the hosted BridgeApp MCP server
skills/ how to work with a BridgeApp workspace
One plugin serves every client: the manifests differ, the MCP server and the skills are shared.
Skills
- bridgeapp-task — working from a task: its plan, comments, subtasks and blockers, plus the project brief, which is the only place the repository and the team's flow are recorded.
- bridgeapp-thread — reading a shared message or thread to the end, including the agent transcripts inside it. This is what fires when someone shares a message from BridgeApp with your agent.
- bridgeapp-context — walking from a task, message, or page to everything it hangs off, and where to stop.
- bridgeapp-investigation — diagnosing a bug when the trail runs through both the repository and BridgeApp, or finding out what was decided about something and by whom. Read-only by construction.
- bridgeapp-task-creation — turning a request into a well-formed task, including the duplicate check that comes first.
- bridgeapp-spec — writing a spec from the decisions already taken, asking the author about contradictions and gaps.
Because the skills carry the how, a shared link only has to carry the what: the Share action in BridgeApp sends a pointer to the message, not a copy of the conversation and not a list of instructions.
Verifying a connection
Call list_projects. An empty list is a pass: it means the connection works and
the account has no projects yet.