Sentry MCP Server (Official)

什么是 Sentry MCP Server (Official)？

Sentry MCP Server (Official) 是 Sentry 官方推出的 Sentry MCP 服务器，通过 Model Context Protocol 把 Claude Code、Cursor、VS Code 等 AI 编程助手连接到你在 Sentry 中的错误、issue、trace 和性能数据。

它由 Sentry 在 getsentry/sentry-mcp 仓库中维护，主要以托管的远程服务形式运行在 https://mcp.sentry.dev/mcp，使用 OAuth 登录。Sentry 表示，其工具选择侧重于有人参与的调试工作流，而不是暴露 Sentry 的全部 API。它还提供 stdio 传输方式，以 @sentry/mcp-server 发布在 npm 上，这也是对接自托管 Sentry 最简单的方式。

如何使用 Sentry MCP Server (Official)？

你需要一个 Sentry 账号。托管服务器无需安装任何东西：首次连接时会在浏览器中打开 OAuth 流程，关联你的 Sentry 账号。

基础端点是 https://mcp.sentry.dev/mcp。你可以将其限定到某个组织（https://mcp.sentry.dev/mcp/{organizationSlug}）或某个项目（https://mcp.sentry.dev/mcp/{organizationSlug}/{projectSlug}）。限定范围后，工具会默认使用该组织或项目，并隐藏不需要的发现类工具；Sentry 建议尽可能限定到项目。在 URL 后加 ?experimental=1 可启用实验性工具变体。

Claude Code

通过 HTTP 添加远程服务器：

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp/{organizationSlug}/{projectSlug}

或者安装 Claude Code 插件。它会添加一个 sentry-mcp 子代理，当你询问 Sentry 错误、issue、trace 或性能问题时，Claude 会自动委派给它：

claude plugin marketplace add getsentry/sentry-mcp
claude plugin install sentry-mcp@sentry-mcp

Cursor

使用 mcp.sentry.dev 上的 "Install MCP Server" 按钮，或在 MCP 设置中添加：

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/mcp/{organizationSlug}/{projectSlug}"
    }
  }
}

VS Code

打开命令面板，运行 "MCP: Add Server"，选择 HTTP，然后输入 https://mcp.sentry.dev/mcp/{organizationSlug}/{projectSlug}。

Claude Desktop 及其他 stdio 客户端

对于启动本地服务器的客户端（或自托管 Sentry），先创建一个带有以下权限范围的 Sentry User Auth Token：org:read、project:read、project:write、team:read、team:write 和 event:write，然后使用 stdio 包：

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["@sentry/mcp-server"],
      "env": {
        "SENTRY_ACCESS_TOKEN": "your-token",
        "EMBEDDED_AGENT_PROVIDER": "openai",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

LLM 提供商相关变量只在使用 AI 驱动的搜索工具时才需要。你也可以直接运行：

npx @sentry/mcp-server@latest --access-token=sentry-user-token

自托管 Sentry 请加上 --host=sentry.example.com（只填主机名）；如果部署只提供纯 HTTP，再加上 --insecure-http。

使用显式令牌连接远程服务器

支持自定义请求头的客户端可以跳过 OAuth，直接传入 Sentry API 令牌：

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/mcp",
      "headers": {
        "Authorization": "Sentry-Bearer ${SENTRY_ACCESS_TOKEN}"
      }
    }
  }
}

Sentry MCP Server (Official) 的主要功能

• 由 Sentry（getsentry）官方构建和维护。
• 托管的远程端点，使用 OAuth，无需安装或手动更新。
• 支持限定到组织或项目的 URL，自动填入 slug 并隐藏不需要的发现类工具。
• 用自然语言搜索 issue 和事件（errors、logs、spans、metrics、profiles、replays）。
• 集成 Seer，提供根因分析和代码修复建议。
• issue 分诊操作：解决、重新打开、忽略或分配 issue。
• 工具目录（search_sentry_tools / execute_sentry_tool），用于 release、团队、DSN、文档查询等长尾操作。
• 面向自托管 Sentry 的 stdio 传输，可启用或禁用 skills（例如 --skills=inspect,seer 或 --disable-skills=project-management）。

Sentry MCP Server (Official) 工具

mcp.so 页面列出了九个顶层工具：

• 发现：find_organizations 和 find_projects 用于查找其他工具需要的组织和项目 slug。URL 已限定范围时它们会被隐藏。
• 搜索：search_issues 返回聚合后的 issue 列表（例如 is:unresolved level:error），而 search_events 负责计数、聚合以及在 errors、logs、spans、metrics、profiles 和 replays 中查询单个事件。两者都支持自然语言或 Sentry 搜索语法。
• 查看：get_sentry_resource 可通过 Sentry URL 或 ID 获取 issue、事件、trace、span、replay、monitor 或 AI 对话。
• 修复与分诊：analyze_issue_with_seer 运行 Seer 根因分析（新分析大约需要 2–5 分钟，结果会被缓存），update_issue 用于修改状态或分配人。
• 目录：search_sentry_tools 查找未作为顶层工具暴露的操作，execute_sentry_tool 负责执行它们，例如 whoami。

Sentry MCP Server (Official) 的使用场景

• 在编辑器里修复线上 bug：“查看 https://my-org.sentry.io/issues/PROJECT-123/，并在这个仓库里修复根本原因。”
• 分诊新错误：“列出 my-project 中过去 24 小时首次出现的未解决错误。”
• 查询统计数据：“今天一共有多少个错误？按 issue 分组。”
• 获取 AI 修复方案：“对这个 issue 运行 Seer 并给出修复建议。”
• 清理 issue 队列：“把 PROJECT-123 标记为已解决，并把 PROJECT-456 分配给我。”
• 排查性能问题：“找出过去一小时内最慢的数据库 span。”

Sentry MCP Server (Official) 与替代方案对比

• 托管远程 vs stdio：mcp.sentry.dev 上的远程服务器使用 OAuth，搜索无需 LLM 密钥。stdio 包需要用户认证令牌，AI 驱动的搜索工具还需要 LLM 提供商密钥，但它可以连接自托管 Sentry。
• Claude Code 插件 vs 普通 MCP：插件把同一个服务器封装成专用子代理；claude mcp add 则直接把工具暴露给主代理。
• 社区版 Sentry 服务器：一些目录还收录了规模较小的社区 Sentry MCP 项目。官方的 getsentry 服务器是由 Sentry 维护并提供文档的版本。

Sentry MCP Server (Official) 常见问题排查

• AI 搜索工具缺失（stdio）：自然语言搜索需要 LLM 提供商（OpenAI、Azure OpenAI、Anthropic 或 OpenRouter）。设置对应的 API 密钥，并显式设置 EMBEDDED_AGENT_PROVIDER；其他工具不依赖它也能正常工作。
• 自托管环境缺少 Seer 工具：Seer 不属于自托管 Sentry，因此当 --host 指向非 sentry.io 主机时，seer skill 会被移除。如果你的部署确实运行了 Seer，请加上 --skills=inspect,seer。
• 纯 HTTP 的自托管实例无法连接：加上 --insecure-http，并且 --host 只传主机名。
• 使用令牌时出现权限错误：确认用户认证令牌包含上文列出的权限范围。
• 在 127.0.0.1 上使用 MCP Inspector 时 OAuth 出错：改用 localhost。