{
  "markdown": "# BridgeApp plugins\n\nOfficial plugins that connect a coding agent to a [BridgeApp](https://bridgeapp.ai)\nworkspace over MCP, so it can read and act on tasks, chats, threads, pages, and\nprojects under the signed-in account's own permissions.\n\n## Claude Code\n\n```\nclaude plugin marketplace add MathAndMagic/bridgeapp-plugin\nclaude plugin install bridgeapp@bridgeapp\n```\n\nThen sign in — this needs an interactive terminal, so run it yourself rather\nthan asking an agent to. Claude Code addresses a plugin-provided server as\n`plugin:<plugin>:<server>`, unless a `bridgeapp` server was already registered\nby hand — then it keeps that entry, adds no plugin copy, and the bare name is\nthe one to sign in to:\n\n```\nclaude mcp login plugin:bridgeapp:bridgeapp || claude mcp login bridgeapp\n```\n\n## Codex and ChatGPT\n\nThe same plugin installs into Codex — MCP server and skills together:\n\n```\ncodex plugin marketplace add MathAndMagic/bridgeapp-plugin\ncodex plugin add bridgeapp@bridgeapp\n```\n\nCodex asks you to sign in to BridgeApp the first time a tool is used. The\nmanifest lives in `.codex-plugin/plugin.json` and the marketplace in\n`.agents/plugins/marketplace.json`; both read the same `skills/` and `.mcp.json`\nas the Claude Code and Cursor manifests.\n\n## Other agents\n\nPoint any MCP client that speaks streamable HTTP with OAuth at:\n\n```\nhttps://mcp.bridgeapp.ai/mcp\n```\n\nIt discovers the authorization server and the `bridgeapp:mcp` scope on its own\nfrom `https://mcp.bridgeapp.ai/.well-known/oauth-protected-resource`.\n\nPer-client instructions, including the ones an agent can follow on its own, live\nin [`agent-setup.md`](./agent-setup.md), published at\n`https://bridgeapp.ai/agent-setup.md` and at `/agent-setup.md` on every\nworkspace host.\n\nThat file is the master copy. The same file ships in `bridgeapp-web`\n(`public/agent-setup.md`, serving every workspace host) and in `bridge-website`\n(`public/agent-setup.md`, serving the apex domain) — edit it here and copy it to\nboth in the same piece of work, byte-identical.\n\n## Self-hosted workspaces\n\nEvery URL above belongs to the hosted service. BridgeApp also runs on customers'\nown infrastructure, under domains of their choosing, and the plugin ships the\nhosted endpoint in [`.mcp.json`](./plugins/bridgeapp/.mcp.json) — deliberately\nas a plain value: Claude Code substitutes plugin settings unreliably across\nversions, and a server that silently fails to register is worse than a fixed\nURL. On a self-hosted workspace, register the workspace's own endpoint — shown\non its **Agents → Connect Apps** page — directly:\n\n```\nclaude mcp add --scope user --transport http bridgeapp https://mcp.example.com/mcp\n```\n\nThe plugin's skills still apply; the plugin's own hosted server stays\nunauthenticated and can be ignored or removed from `/mcp`. `bridgeapp-links`\ncovers the matching rule for building links back into a self-hosted workspace.\n\n## What is in here\n\n```\nplugins/bridgeapp/\n  .claude-plugin/plugin.json   Claude Code manifest\n  .cursor-plugin/plugin.json   Cursor manifest\n  .codex-plugin/plugin.json    Codex / ChatGPT manifest (directory metadata, logo)\n  .mcp.json                    the hosted BridgeApp MCP server\n  skills/                      how to work with a BridgeApp workspace\n    bridgeapp-links/references/routes.md   the app's route map\n```\n\nOne plugin serves every client: the manifests differ, the MCP server and the\nskills are shared.\n\n## Skills\n\n- **bridgeapp-task** — working from a task: its plan, comments, subtasks and\n  blockers, plus the project brief, which is the only place the repository and\n  the team's flow are recorded.\n- **bridgeapp-thread** — reading a shared message or thread to the end,\n  including the agent transcripts inside it. This is what fires when someone\n  shares a message from BridgeApp with your agent.\n- **bridgeapp-context** — walking from a task, message, or page to everything it\n  hangs off, and where to stop.\n- **bridgeapp-links** — the URL shapes and the mention syntax: how to give a\n  human a link into the app, and how to resolve the tokens and keys you meet\n  while reading. Carries the full route map — every path in the app, web and\n  desktop, with the query params each one takes.\n- **bridgeapp-investigation** — diagnosing a bug when the trail runs through\n  both the repository and BridgeApp. Read-only by construction.\n- **bridgeapp-task-creation** — turning a request into a well-formed task,\n  including the duplicate check that comes first.\n\nBecause the skills carry the how, a shared link only has to carry the what: the\nShare action in BridgeApp sends a pointer to the message, not a copy of the\nconversation and not a list of instructions.\n\n## Verifying a connection\n\nCall `list_projects`. An empty list is a pass: it means the connection works and\nthe account has no projects yet.\n",
  "bytes": 4814,
  "sha": "d7054f1dafa98c0e8215ca5c03d489148e6529a1bc3408e7357f6d1554310734",
  "repo_slug": "mathandmagic/bridgeapp-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_bridgeapp_bridgeapp_3064a474/readme"
}