如何通过 MCP 将 Rollbar 连接到 Microsoft Copilot

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Rollbar、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Rollbar + Microsoft Copilot

在任意 AI 智能体中使用 Rollbar 错误监控：带历史和事件（occurrence）的条目（item）、完整的堆栈跟踪、最活跃的条目和事件报告、Metrics API、部署、环境和代码版本、RQL 查询，以及账户的项目、用户和团队。它还能解决、静音、分配和暂缓条目，为条目添加评论并登记部署。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

ROLLBAR_ACCESS_TOKEN

步骤 1 — 获取凭证

设置大约需要 3 分钟。你需要一个 Rollbar 账户和一个访问令牌。粘贴哪种令牌，决定了连接器能访问哪些内容：

1. 单个项目：在项目中打开 Settings、Project Access Tokens，创建或复制一个项目访问令牌。读取需要 read 权限范围，修改条目需要 write，登记部署需要 post_server_item。项目令牌始终作用于自己的项目，但无法列出项目、用户或团队。
2. 整个账户：改为创建一个账户访问令牌。服务令牌（账户 Settings、API Access Tokens、Service 标签页）可访问所有项目；个人访问令牌（User Settings、Personal access tokens）只能做其用户能做的事。它们的权限范围是 read 和 write。使用账户令牌时，AI 会在项目类工具中传入 project_id（来自 rollbar_list_projects）；除非你指定 project_ids，rollbar_list_items 会搜索令牌可读取的所有项目。
3. 将令牌粘贴到 ROLLBAR_ACCESS_TOKEN。它通过 X-Rollbar-Access-Token 请求头发送到 https://api.rollbar.com/api/1。
4. 安装连接器并运行 rollbar_list_items 检查令牌。

只有个人访问令牌可以评论条目，只有带 post_server_item 的项目令牌可以登记部署。

当前出了什么问题：rollbar_get_top_active_items 显示最近几小时（1 到 168，默认 24）事件最多的条目及其每小时计数，与项目仪表盘上的 Top 10 相同。rollbar_list_items 按状态、级别、环境、框架、负责人、暂缓状态，或使用与 Items 页面相同的搜索文本，列出和搜索条目（分组后的错误和消息）。rollbar_get_item 读取单个条目。Rollbar URL 中的数字（#123）是项目内的 counter，不是条目的 id：rollbar_get_item_by_counter 可以根据 counter 或某个事件的 UUID 找到条目。

排查：rollbar_list_item_occurrences 列出单个条目的各次事件，rollbar_list_occurrences 列出整个项目的最新事件，每条都带时间、代码版本和 payload。rollbar_get_occurrence 返回与 Raw JSON 视图相同的完整 payload：异常类和消息、堆栈帧、请求、person、服务器、客户端、自定义数据和遥测。rollbar_list_item_events 显示谁评论、修改、分配、暂缓或合并了条目。

分诊：rollbar_update_item 可以解决条目（可附带 resolved_in_version，例如 git SHA），静音或重新激活条目，修改级别或标题，分配给用户或团队（ID 来自 rollbar_list_users 和 rollbar_list_teams），或将其暂缓指定的秒数（暂缓需要付费套餐）。rollbar_add_item_comment 在条目的时间线上添加 Markdown 评论。这些操作需要 write 权限范围。

趋势和指标：rollbar_get_occurrence_counts 给出每分钟、每小时或每天的事件数，rollbar_get_activated_item_counts 给出每天新增和重新激活的条目数，rollbar_get_item_metrics 给出一组条目的事件数及首次和最近一次事件时间。在 Advanced 套餐中，rollbar_query_occurrence_metrics 可以使用筛选、分组和聚合查询 Metrics API（例如按环境每天的事件数，或某个条目最常见的浏览器），rollbar_get_resolution_time_metrics 按周期给出条目的解决耗时（中位数、平均值、最小值或最大值）。

版本发布：rollbar_list_deploys、rollbar_get_deploy 和 rollbar_list_environments 读取部署和环境。rollbar_report_deploy 登记某个修订版本到某个环境的部署，rollbar_update_deploy 结束一个登记为已开始的部署（succeeded、failed 或 timed_out）。要查看某次发布引入了什么问题，rollbar_get_version 统计某个环境中某个代码版本的新增、重新激活、重复和已解决条目数，rollbar_list_version_items 配合 event: new 列出在该版本中首次出现的条目。

RQL：做临时分析时，AI 用 rollbar_create_rql_job 以 Rollbar 类 SQL 的查询语言发起查询（表为 item_occurrence 和 deploy），轮询 rollbar_get_rql_job 直到 status 为 success，再用 rollbar_get_rql_job_result 读取结果行。rollbar_list_rql_jobs 和 rollbar_cancel_rql_job 管理以前的和正在运行的任务。RQL 不会修改数据。

账户：使用账户令牌时可用 rollbar_list_projects、rollbar_get_project、rollbar_list_users、rollbar_get_user 和 rollbar_list_teams。

安装时默认关闭：rollbar_request_person_deletion，它会从账户的所有项目中删除被追踪的 person（关联到事件的最终用户），例如用于处理 GDPR 请求。该操作无法撤销，因此由工作区管理员在需要时开启；之后用 rollbar_get_person_deletion_status 跟踪任务。

数据格式：每个响应都是 {"err": 0, "result": ...}；err: 1 时会附带 message。rollbar_report_deploy 返回 {"data": {"deploy_id": ...}}。所有时间戳都是 GMT 的 Unix 秒，报告图表数据为 [timestamp, count] 数对。条目 status 为 active、resolved、muted 或 archived；level 为 debug、info、warning、error 或 critical。事件列表不包含请求头、Cookie 和 notifier 详情；rollbar_get_occurrence 的完整 payload 可能包含你的最终用户的个人数据。

分页：条目每页 100 条；事件、部署、环境和条目历史默认每页 20 条，支持的工具可用 limit 设到最多 5000。page 从 1 开始；事件列表也可以用 last_id 翻页。条目超过 100,000 个的项目中，total_count 为 null。

限制：每个令牌在 Rollbar 有各自的速率限制，剩余额度见 X-Rate-Limit-Remaining。Metrics API 相关工具需要 Advanced 套餐。

常见错误：401 表示令牌缺失或格式错误。403 表示令牌已停用、缺少所需权限范围、在账户类工具上使用了项目令牌，或（Requires project access）账户令牌没有可用的 project_id。404 表示 ID 不存在或属于其他账户，422 表示参数无效，429 表示达到令牌的速率限制。

该连接器不会向 Rollbar 发送错误（这是应用中 Rollbar SDK 的工作），不会删除条目，也不会创建项目、团队、用户或访问令牌。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Microsoft Copilot 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器：把 AnythingMCP 作为工具添加到智能体，然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接，AnythingMCP 支持这种方式。

1. 在 Copilot Studio 中打开你的智能体（或新建一个），进入 Tools，选择 Add a tool → New tool → Model Context Protocol。
2. 填写 Server name（例如 AnythingMCP）、说明连接器用途的 Server description，以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
3. 身份验证选择 API key，把 Type 设为 Header，请求头名称填 X-API-Key，然后选择 Create。
4. 在 Add tool 中选择 Create a new connection，粘贴 AnythingMCP 的 MCP API 密钥（MCP Servers → 你的服务器 → API keys），然后选择 Add to agent。
5. 在智能体的 Test 窗格中试一试：提出需要用到 Rollbar 的工具的请求。
6. 选择 Publish，然后进入 Channels → Microsoft 365 and Microsoft Teams，保持勾选 Make agent available in Microsoft Copilot，再选择 Add channel。See agent in Teams 会为你安装该智能体；在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 AnythingMCP。

自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接，因此 localhost 无法使用。

可用工具

示例提示

• “过去 24 小时 production 中最多的错误有哪些？其中哪些是新出现的？”
• “给我看 Rollbar 条目 #482 最近一次事件的完整堆栈跟踪。”
• “哪些条目是在 production 的 3f9c2ab 版本中首次出现的？按级别分组。”
• “把 TimeoutError 条目标记为在 1.8.3 版本中已解决，并把 NullPointerException 分配给后端团队。”
• “本周每天的 error 和 critical 事件数是多少？和上周相比如何？”

FAQ

这适用于哪个 Copilot？ 适用于工作中的 Microsoft 365 Copilot，通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么？ 一个可以使用 Copilot Studio 的工作账户（许可证或试用版），用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限：把它共享给他们，或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略，这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Gemini
• 连接到 Meta Muse