通过 MCP 连接 AI 助手

AB Projects 提供一个 Model Context Protocol (MCP) 服务器，使 AI 助手 — Claude、ChatGPT、Cursor、Windsurf、Codex CLI、Antigravity 以及任何其他符合规范的 MCP 客户端 — 能够代表您读取和管理您的任务、项目和文档。本文逐一介绍如何连接各个客户端。

开始之前您需要准备

一个现有的 AB Projects 账户。如果您还没有，请先通过 Microsoft Teams 进行设置（请参阅 安装 AB Projects Teams 应用）。
MCP 服务器 URL：https://mcp.actionbridge.io/mcp
用于登录的 Microsoft 365 账户，或您的 AB Projects 电子邮件和密码。

重要提示：URL 是 https://mcp.actionbridge.io/mcp — 请包含 /mcp 路径。仅使用主机地址（https://mcp.actionbridge.io）不是有效的 MCP 端点；输入该地址会使客户端报告授权失败，即使它实际已连接到服务器。

连接 Claude Desktop

打开 Claude Desktop → 设置 → 连接器。
点击 添加自定义连接器。
输入：
- 名称：AB Projects
- URL：https://mcp.actionbridge.io/mcp
点击连接。会打开一个浏览器窗口要求您登录。
选择 使用 Microsoft 登录，或输入您的 AB Projects 电子邮件和密码。
登录后，Claude Desktop 会自动注册并列出 AB Projects MCP 工具。

连接 Claude Cowork

在 Cowork 中，打开您的 MCP 配置并添加：

URL:  https://mcp.actionbridge.io/mcp
Auth: OAuth (automatic)

Cowork 首次连接时会打开一个浏览器窗口，使用与 Claude Desktop 相同的 OAuth 登录方式。

连接 ChatGPT

ChatGPT 自定义连接器需要 Plus、Pro、Business 或 Enterprise 订阅。

打开 ChatGPT → 设置 → 连接器 → 添加自定义连接器。
输入：
- 名称：AB Projects
- MCP 服务器 URL：https://mcp.actionbridge.io/mcp（确保包含 /mcp 路径）
点击连接。会打开一个浏览器窗口。
使用 Microsoft 登录，或使用您的 AB Projects 电子邮件和密码。
批准后，ChatGPT 返回连接器列表，AB Projects 显示为已连接。

连接 Cursor、Codex CLI、Windsurf 和 Antigravity

这些编辑器使用 JSON 配置文件来配置 MCP 服务器。添加以下条目（外层配置格式因工具而异，但服务器块是相同的）：

{
  "mcpServers": {
    "actionbridge": {
      "url": "https://mcp.actionbridge.io/mcp"
    }
  }
}

编辑器首次连接时，会打开一个浏览器窗口供您登录。无需客户端 ID 或密钥 — 身份验证由 OAuth 处理。

管理您的 MCP 访问权限

当您连接客户端时，AB Projects 会在后台自动签发一个 API 密钥，其范围限定于您的账户，因此助手仅以您的身份操作，并且仅限于您所属的项目。

要断开某个客户端：在该 AI 客户端中移除 AB Projects 连接器（例如在 Claude/ChatGPT 中删除自定义连接器，或从编辑器配置中移除服务器块）。下次重新添加时需要再次登录。
要撤销服务器端访问权限（例如设备丢失时），请联系 support@actionbridge.io — 自助式密钥管理界面尚未提供。
助手所做的每项更改都会记录在条目的更改历史中，并发布到关联的 Teams 频道，并附有明确的 AI 披露说明，因此 MCP 活动始终可审计（请参阅 MCP 工具参考）。

故障排除

“无法连接到 MCP 服务器”

几乎总是 URL 错误。请确认：

您使用的是 https://mcp.actionbridge.io/mcp，而不是仅主机地址。
您输入的是 https://，而不是 http://。
没有尾部斜杠、空格或多余字符。

“与 MCP 服务器的授权失败”

仔细检查 URL 是否包含 /mcp。如果指向仅主机地址，OAuth 会成功，但首次工具调用会返回健康检查响应，客户端会报告“授权失败”。
如果您使用 Microsoft 登录，请确保该 Microsoft 电子邮件与某个现有的 AB Projects 账户匹配。新用户必须先通过 Microsoft Teams 进行设置。
如果问题仍然存在，请在您的 AI 客户端中移除并重新添加连接器，以开始全新的登录。