sentry-mcp-server

Sentry MCP 服务

通过模型上下文协议，将 AI 助手连接到 Sentry——用于错误跟踪、问题、版本发布、事件和项目管理。

兼容 Claude Desktop、Cursor、Windsurf、Cline、Continue 以及任何兼容 MCP 的客户端。

功能

工具	描述
list_organizations	列出你有权访问的所有 Sentry 组织
list_projects	列出组织中的项目，包含 slug、平台和团队信息
list_issues	按条件筛选并列出问题（环境、状态、级别、查询、项目）
get_issue	获取特定问题的完整详情，包括标题、根因、元数据和标签
list_issue_events	列出特定问题的所有事件（发生记录）
get_event	获取事件的完整详情，包括异常、堆栈跟踪、面包屑和标签
list_releases	列出组织中的版本发布，包含版本号、日期和作者
get_release	获取特定版本发布的详情，包含提交信息和文件变更
list_teams	列出组织中的团队，包含成员数和 slug
list_members	列出组织成员，包含角色和邮箱
get_issue_hashes	获取问题的分组哈希值（指纹）
update_issue_status	解决、忽略或取消解决问题（并添加评论）

快速开始

1. 获取 Sentry 身份验证令牌

前往 Sentry → Settings → Auth Tokens，创建一个包含所需权限范围的令牌（org:read、project:read、event:read、event:write、issue:read、issue:write）。

或者访问：https://sentry.io/settings/auth-tokens/

2. 配置 MCP 客户端

Claude Desktop — 添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["-y", "sentry-mcp-server"],
      "env": {
        "SENTRY_AUTH_TOKEN": "sntrys_YOUR_TOKEN_HERE"
      }
    }
  }
}

Cursor — 添加到 MCP 设置（.cursor/mcp.json）：

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["-y", "sentry-mcp-server"],
      "env": {
        "SENTRY_AUTH_TOKEN": "sntrys_YOUR_TOKEN_HERE"
      }
    }
  }
}

3. 手动运行（用于测试）

git clone https://github.com/friendlygeorge/sentry-mcp-server.git
cd sentry-mcp-server
npm install
npm run build

# Run
SENTRY_AUTH_TOKEN=sntrys_xxx node dist/index.js

环境变量

变量	必填	默认值	描述
SENTRY_AUTH_TOKEN	✅	—	你的 Sentry 身份验证令牌（sntrys_...）
SENTRY_BASE_URL	❌	https://sentry.io/api/0/	Sentry API 基础 URL。可覆盖此值以连接可自托管的 Sentry。

可自托管的 Sentry

如果你运行自己的 Sentry 实例，请设置 SENTRY_BASE_URL：

SENTRY_BASE_URL=https://sentry.yourcompany.com/api/0/

示例查询

“列出我的 Sentry 组织”

“显示组织 acme 中项目 web 在生产环境里尚未解决的错误”

“获取问题 1234567890 的详情，并显示最新事件的堆栈跟踪”

“解决问题 1234567890，并添加评论说明已在 v1.2.3 中修复”

“列出 acme 最近的 10 个版本发布”

“acme 组织有哪些成员，他们的角色是什么？”

API 覆盖范围

此服务涵盖 Sentry Web API 中最常用的端点：

• 组织（/organizations/）
• 项目（/organizations/{org}/projects/）
• 问题（/organizations/{org}/issues/、/issues/{id}/）
• 事件（/issues/{id}/events/、/projects/{org}/{project}/events/{id}/）
• 版本发布（/organizations/{org}/releases/）
• 团队（/organizations/{org}/teams/）
• 成员（/organizations/{org}/members/）

完整的 Sentry API 文档，请参阅 docs.sentry.io/api。

许可证

MIT © 2026 Nova