Sentry MCP

Sentry MCP

Sentry MCP 是一个原型远程模型上下文协议（MCP）服务器，作为 AI 驱动的大语言模型应用与 Sentry API 之间的中间层。它实现了与 Sentry 的错误监控和可观察性平台的无缝、标准化集成，支持高级代理工作流或基于大语言模型的自动化。

Author: getsentry


查看协议

什么是 Sentry MCP？

Sentry MCP 是一个开源 MCP 服务器，旨在通过标准化的模型上下文协议，提供安全、结构化的访问到你的 Sentry 数据和操作。它允许主机应用（如 Claude Desktop 或 IDE）通过符合 MCP 的工具和端点以编程方式与 Sentry 进行交互。它支持远程和本地（stdio）传输，适合于云端和自托管 Sentry 安装。

如何配置

  1. 生产使用：
    访问部署的服务 https://mcp.sentry.dev。

  2. 自托管 Sentry（Stdio 传输）：

    • 创建一个具有适当范围的 Sentry 用户认证令牌： 
      org:read
project:read
project:write
team:read
team:write
event:write
    • 启动 MCP 服务器： 
      npx @sentry/mcp-server@latest --access-token=sentry-user-token --host=sentry.example.com
    • 或者，可以通过环境变量配置： 
      SENTRY_ACCESS_TOKEN=
SENTRY_HOST=

  3. 本地开发：

    • 在 Sentry 中创建一个 OAuth 应用，将 http://localhost:5173 设为主页 URL 和重定向 URI。
    • 在 packages/mcp-cloudflare/ 的 .dev.vars 中添加你的凭据： 
      SENTRY_CLIENT_ID=your_client_id
SENTRY_CLIENT_SECRET=your_client_secret
COOKIE_SECRET=my-super-secret-cookie
    • 在本地运行服务器： 
      pnpm dev

如何使用

  1. 访问 https://mcp.sentry.dev 获取托管服务器，或按上面所述运行你的本地/stdio 实例。
  2. 使用 MCP Inspector：
    • 输入你的服务器 URL（例如 http://localhost:5173）并连接。
    • 按提示进行身份验证（OAuth 或访问令牌）。
    • 通过“列出工具”功能发现可用工具。
    • 可以直接从 Inspector 或通过支持 LLM 的客户端调用所需的工具端点（例如，获取问题、列出项目）。
  3. 对于自托管 Sentry，使用相关令牌运行并以“stdio”模式连接。
  4. 使用 pnpm test 运行测试，使用 pnpm eval 进行 LLM 支持的评估（需设置 OPENAI_API_KEY）。

主要特点

  • 通过符合 MCP 的协议与 Sentry 集成，支持 LLM/代理访问错误数据和操作
  • 支持远程 HTTP(S) 和本地 stdio 传输，灵活适应不同部署类型
  • 支持 OAuth 和基于令牌的身份验证，确保安全访问 Sentry 资源
  • 提供预构建的可发现、可执行工具集（操作/端点），用于自动化和数据检索
  • 可扩展，开放本地开发和贡献
  • 包含内置的 Inspector 工具，支持交互式探索和测试

使用场景

  • 允许基于 LLM 的代理或助手在 IDE 或统一桌面环境中监控、获取或分类 Sentry 事件
  • 自动化 Sentry 的常规操作，如问题分配、状态更改或通知，通过 AI 工作流触发
  • 将 Sentry 可观察性数据集成到由语言模型驱动的自定义仪表板或报告工具中
  • 实现零接触的 Sentry 管理或分类，通过安全、标准化的 API，无需手动脚本

常见问题

问1：我可以将 Sentry MCP 用于自托管 Sentry 实例吗？
是的，Sentry MCP 支持通过 stdio 传输模式的自托管实例。你需要提供具有必要权限的用户认证令牌并相应配置主机。

问2：我需要构建一个 OAuth 应用程序来本地测试 Sentry MCP 吗？
对于本地开发和测试，你需要在 Sentry 账户中注册一个 OAuth 应用，并在项目配置文件中提供其凭据。

问3：LLM 能否通过 MCP 工具修改我的 Sentry 数据？
是的，通过 MCP 暴露的工具可以读取和修改 Sentry 中的数据，具体取决于工具及你的令牌权限。始终限制提供的令牌仅限所需的范围。

问4：我如何测试我的 MCP 服务器集成？
使用内置的 Inspector 工具，连接到你的 MCP 服务器 URL。这允许你进行身份验证、发现和交互式调用工具，以便轻松验证。

问5：支持哪些身份验证方法？
Sentry MCP 支持 OAuth（用于远程服务器）和基于访问令牌（用于本地/stdio）的身份验证流程。