安装
"url": "https://mcp.sentry.dev/mcp",
"headers": {
"Authorization": "Sentry-Bearer ${SENTRY_ACCESS_TOKEN}"
}适合谁
如果你在写代码时需要对照 Sentry 做调试,并且接受人机协作而不是把全部 Sentry 功能自动化,这个服务对得上。官方说明它主要面向 human-in-the-loop 的编码 agent,工具选择偏向开发者工作流和调试,而不是通用的全功能 Sentry MCP。它作为上游 Sentry API 的中间层,并点名优化 Cursor、Claude Code 及类似开发工具。
它不适合想覆盖 Sentry 全部功能的人,也不适合还没有 Sentry 访问令牌、却想先跑 stdio 的人。当前摘录只明确点名了 search_events、search_issues 这类 AI 搜索工具;其他工具存在,但名字没有写进这份摘录。缺的工具名不要补。
只读查询仍会经过 Sentry API,不要理解成无网络或无隐私边界。
3 分钟完成第一次尝试
先准备好你自己的 Sentry 访问令牌。官方推荐的主路径是访问生产环境托管服务,而不是并列再装 stdio:
生产说明入口是 https://mcp.sentry.dev/ 。远程客户端配置摘录给出:
"url": "https://mcp.sentry.dev/mcp ",
"headers": {
"Authorization": "Sentry-Bearer ${SENTRY_ACCESS_TOKEN}"
}
注意鉴权方案是 Sentry-Bearer,不要改成普通 Bearer。把这段放进支持远程 URL 的 MCP 客户端,令牌换成你自己的值,不要使用任何示例占位字符串。摘录没有写死客户端文件名。
连上后,先提一个你已经在 Sentry 里要查的调试问题。若你还没配置 LLM 提供商(摘录列出 OpenAI、Azure OpenAI、Anthropic、OpenRouter),不要调用 search_events 或 search_issues:没配提供商时这两项不可用,其余工具仍可工作。第一次优先用仍可用的非搜索工具做一次只读查看;具体名字摘录没写,能确认的只到「除 AI 搜索外的其他工具」。
成功信号是远程地址 https://mcp.sentry.dev/mcp 能够对话并返回 Sentry 侧调试信息,而不是 401,或把 Authorization 写成了 Bearer。
使用案例
案例一:在编码助手里做一次调试查询。摘录写明该远程服务面向开发者工作流和调试,并作为 Sentry API 的中间层。你应先连上托管 URL,再问一个已有的调试问题。能核到的是这条中间层路径;具体非搜索工具名和返回字段没有出现在当前摘录里。
案例二:用自然语言搜事件或 issue。摘录写明 search_events、search_issues 等 AI 搜索工具需要 LLM 提供商,才能把自然语言翻成 Sentry 查询语法。动手前先确认提供商已配置。没配时这些工具不可用,不要把失败理解成整个服务挂了。提供商的安装命令和密钥变量没有写进摘录,不要编。
这两个案例分别对应「普通调试工具」和「AI 搜索」,不要在未配置提供商时强行走第二条。
使用边界
主路径是托管服务 https://mcp.sentry.dev/ 与远程 MCP 地址 https://mcp.sentry.dev/mcp 。摘录另外给出 stdio 命令 npx @sentry/mcp-server@latest,并用 --access-token 传入你自己在 Sentry 创建的 User Auth Token,不要填写任何示例占位值。stdio 需要的范围包括 org:read、project:read、project:write、team:read、team:write、event:write。第一次不要走这条,尤其不要一上来用带 write 的范围做写入。
官方仓库是 https://github.com/getsentry/sentry-mcp 。它不是全功能 Sentry API 封装。未出现的工具名、OAuth 刷新行为和撤销步骤都不要自行补全。