bridgeapp

BridgeApp 插件

官方插件，可通过 MCP 将编码 Agent 连接到 BridgeApp 工作区，使其能够在已登录账号自身的权限范围内读取和处理任务、聊天、讨论串、页面和 项目。

Claude 和 Claude Code

BridgeApp 位于 Claude 目录中。打开 BridgeApp 插件 并安装；或者，在网页版 Claude、桌面端或 Cowork 中，打开 Settings → Plugins → Discover，搜索 BridgeApp 并安装。然后 打开插件的 Connectors 标签页，选择 BridgeApp 并点击 Connect 以 登录。

添加到 Claude 账号的插件会自动同步到 Claude Code，在 Claude Code 使用同一账号 登录时以 bridgeapp@synced 的形式出现（Claude Code 2.1.273 或更高版本）。 重启 Claude Code 或输入 /reload-plugins 以加载插件；如果 BridgeApp 提示登录， 请通过 /mcp 登录。

未使用 Claude 账号的 Claude Code 用户——使用 API 密钥、Amazon Bedrock 或 Google Vertex AI 的用户——应改从此仓库的 marketplace 安装插件。不要在使用 Claude 账号时也这样做：目录中的副本已会同步，第二个副本会取代它。

claude plugin marketplace add MathAndMagic/bridgeapp-plugin
claude plugin install bridgeapp@bridgeapp

然后登录——这需要交互式终端，因此请自行运行，而不是让 Agent 代为运行。除非 之前已手动注册 bridgeapp 服务，否则 Claude Code 会将插件提供的服务称为 plugin:<plugin>:<server>；如果已手动注册，则会保留该条目，不添加插件副本， 登录时应使用不带前缀的名称：

claude mcp login plugin:bridgeapp:bridgeapp || claude mcp login bridgeapp

Codex 和 ChatGPT

同一插件也可安装到 Codex——MCP 服务和技能会一并安装：

codex plugin marketplace add MathAndMagic/bridgeapp-plugin
codex plugin add bridgeapp@bridgeapp

首次使用工具时，Codex 会提示你登录 BridgeApp。ChatGPT 桌面应用与 Codex 共用 ~/.codex，因此上述安装会同时适用于两者。若要直接从应用安装，请打开 Plugins，依次选择 Add marketplace 和 Add from a repository，输入 MathAndMagic/bridgeapp-plugin，然后从该 marketplace 安装 BridgeApp。

清单位于 .codex-plugin/plugin.json，marketplace 位于 .agents/plugins/marketplace.json；两者均会读取与 Claude Code 和 Cursor 清单 相同的 skills/ 和 .mcp.json。清单还通过 extensions["com.openai"] 包含 OpenAI 目录条目和审核元数据（测试用例、商业声明、发行说明）。审核者凭据和 演示视频 URL 应在 OpenAI 门户中填写，绝不要放在此仓库中。

其他 Agent

将任何支持 OAuth 的流式 HTTP MCP 客户端指向：

https://mcp.bridgeapp.ai/mcp

它会自行从 https://mcp.bridgeapp.ai/.well-known/oauth-protected-resource 发现授权服务器和 bridgeapp:mcp 作用域。

各客户端的说明（包括 Agent 可自行遵循的说明）位于 agent-setup.md，并发布在 https://bridgeapp.ai/agent-setup.md 以及每个工作区主机上的 /agent-setup.md。

该文件是主副本。同一文件也随 bridgeapp-web 一同发布 （public/agent-setup.md，供每个工作区主机提供服务），并随 bridge-website 一同发布（public/agent-setup.md，供顶级域名提供服务）——在此处编辑，并在同一项 工作中复制到两处，确保字节级一致。

自托管工作区

上面的每个 URL 都属于托管服务。BridgeApp 也可以运行在客户自己的基础设施上，使用客户自行选择的域名；插件在 .mcp.json 中提供了托管端点——有意将其设为普通值：Claude Code 在不同版本间替换插件设置的行为并不可靠，而服务器静默注册失败比使用固定 URL 更糟。在自托管工作区中，仍然先安装插件——这些技能适用于任何工作区——然后在插件旁边注册工作区自己的端点，该端点显示在 Agents → Connect Apps 页面上。

Claude，使用 Claude 账户：打开 Settings → Connectors，点击 +，选择 Add custom connector，粘贴工作区的端点并连接。不要连接插件自带的 BridgeApp 连接器。使用同一账户登录的 Claude Code 会同时获取这两个连接器。

不使用 Claude 账户的 Claude Code：

claude mcp add --scope user --transport http bridgeapp https://mcp.example.com/mcp
claude mcp login bridgeapp

Codex 和 ChatGPT 桌面应用：使用独立名称，以免替换插件的 bridgeapp 条目（add 会直接开始登录）：

codex mcp add bridgeapp-workspace --url https://mcp.example.com/mcp

插件自带的托管服务器仍未经过身份验证——请勿登录该服务器——可以忽略或移除。指向工作区的链接由服务器的 build_bridgeapp_link 工具生成，因此会自动包含自托管域名。

此处内容

plugins/bridgeapp/
  .claude-plugin/plugin.json   Claude Code manifest
  .cursor-plugin/plugin.json   Cursor manifest
  .codex-plugin/plugin.json    Codex / ChatGPT manifest (OpenAI directory listing and review metadata)
  .mcp.json                    the hosted BridgeApp MCP server
  skills/                      how to work with a BridgeApp workspace

一个插件适用于所有客户端：清单各不相同，但 MCP 服务和技能是共享的。

技能

• bridgeapp-task — 处理任务：查看其计划、评论、子任务和阻塞项，以及项目简介；项目简介是记录仓库和团队工作流程的唯一地方。
• bridgeapp-thread — 从头到尾阅读共享消息或讨论串，包括其中的 Agent 对话记录。有人从 BridgeApp 向你的 Agent 分享消息时，就会触发此技能。
• bridgeapp-context — 从任务、消息或页面出发，追溯其关联的所有内容，并确定应在何处停止。
• bridgeapp-investigation — 当排查线索涉及仓库和 BridgeApp 时诊断错误，或查明某件事的决策内容及决策者。此技能在设计上仅支持读取。
• bridgeapp-task-creation — 将请求转化为格式完善的任务，包括首先进行重复项检查。
• bridgeapp-spec — 根据已作出的决定编写规格说明，并就矛盾和缺漏询问作者。

由于技能负责说明如何操作，共享链接只需说明是什么：BridgeApp 中的「分享」操作会发送指向消息的链接，而不是对话副本，也不是一份指令列表。

验证连接

调用 list_projects。列表为空也算通过：这表示连接正常，只是账户还没有任何项目。