Bridgeapp Plugin MCP Server

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. Read-only by construction.
• bridgeapp-task-creation — turning a request into a well-formed task, including the duplicate check that comes first.

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.