注意 - Sentry 远程MCP服务器 已经很大程度上取代了它，并支持更多功能（身份验证、更好的工具等等）。此服务器作为独立的MCP服务器存在，用于教育目的；但在大多数情况下，您应该使用远程服务器。您可以在 https://mcp.sentry.dev 上查看其运行情况。

Sentry MCP 服务器

一个用于与Sentry交互的模型上下文协议 (MCP) 服务器。此MCP服务器提供与Sentry API交互的工具，允许AI助手检索和分析错误数据、管理项目以及监控应用程序性能。

需求

• Node.js (v14 或更高版本)
• npm 或 yarn
• 具有API访问权限的Sentry账户
• 具有相应权限的Sentry身份验证令牌

设置

1. 安装依赖项：

   npm install
   

在IDE中使用

此MCP已验证可与Cursor、Codeium Windsurf和Claude Desktop配合使用。

与Claude一起使用

要在Claude中使用此MCP服务器，请将以下配置添加到您的Claude设置中：

{
    "mcpServers": {
        "sentry": {
            "command": "npx",
            "args": ["ts-node", "/Users/<你的用户目录>/sentry-mcp-ts/index.ts"],
            "env": {
                "SENTRY_AUTH": "<你的认证令牌>"
            }
        }
    }
}

• 更新 args 字段中的目录路径。
• 将 <你的认证令牌> 替换为您的Sentry身份验证令牌。

可用工具

list_projects

列出给定组织下所有可访问的 Sentry 项目。

参数：

• organization_slug (字符串，必填): 要列出项目的组织的slug
• view (字符串，可选): 视图类型，"summary" 或 "detailed"（默认: "detailed"）
• format (字符串，可选): 输出格式，"plain" 或 "markdown"（默认: "markdown"）

resolve_short_id

使用短 ID 检索问题的详细信息。

参数：

• organization_slug (字符串，必填): 问题所属组织的slug
• short_id (字符串，必填): 要解析问题的短 ID（例如，PROJECT-123）
• format (字符串，可选): 输出格式，"plain" 或 "markdown"（默认: "markdown"）

get_sentry_event

检索并分析问题中的特定 Sentry 事件。

参数：

• issue_id_or_url (字符串，必填): 完整的 Sentry 问题 URL 或仅数字问题 ID
• event_id (字符串，必填): 要检索的特定事件 ID
• view (字符串，可选): 视图类型，"summary" 或 "detailed"（默认: "detailed"）
• format (字符串，可选): 输出格式，"plain" 或 "markdown"（默认: "markdown"）

list_error_events_in_project

列出特定 Sentry 项目中的错误事件。

参数：

• organization_slug (字符串，必填): 项目所属组织的slug
• project_slug (字符串，必填): 要列出事件的项目的slug
• view (字符串，可选): 视图类型，"summary" 或 "detailed"（默认: "detailed"）
• format (字符串，可选): 输出格式，"plain" 或 "markdown"（默认: "markdown"）

创建项目

在Sentry中创建一个新项目并获取其客户端密钥。

参数：

• organization_slug (字符串，必填): 创建项目的组织的slug
• team_slug (字符串，必填): 分配项目的团队的slug
• name (字符串，必填): 新项目的名称
• platform (字符串，可选): 新项目的平台
• view (字符串，可选): 视图类型，"summary" 或 "detailed" (默认: "detailed")
• format (字符串，可选): 输出格式，"plain" 或 "markdown" (默认: "markdown")

列出项目问题

列出特定Sentry项目的错误。

参数：

• organization_slug (字符串，必填): 项目所属组织的slug
• project_slug (字符串，必填): 要列出错误的项目的slug
• view (字符串，可选): 视图类型，"summary" 或 "detailed" (默认: "detailed")
• format (字符串，可选): 输出格式，"plain" 或 "markdown" (默认: "markdown")

列出错误事件

列出特定Sentry错误的事件。

参数：

• organization_slug (字符串，必填): 错误所属组织的slug
• issue_id (字符串，必填): 要列出事件的错误ID
• view (字符串，可选): 视图类型，"summary" 或 "detailed" (默认: "detailed")
• format (字符串，可选): 输出格式，"plain" 或 "markdown" (默认: "markdown")

获取Sentry错误

检索并分析 Sentry 问题。

参数：

• issue_id_or_url (字符串，必填): 完整的 Sentry 问题 URL 或仅数字型的 issue ID
• view (字符串，可选): 视图类型，"summary" 或 "detailed" (默认: "detailed")
• format (字符串，可选): 输出格式，"plain" 或 "markdown" (默认: "markdown")

list_organization_replays

列出特定 Sentry 组织的回放。

参数：

• organization_slug (字符串，必填): 要列出回放的组织的 slug
• project_ids (字符串数组，可选): 用于过滤回放的项目 ID 列表
• environment (字符串，可选): 用于过滤回放的环境
• stats_period (字符串，可选): 统计时间段 (例如，"24h"，"7d")
• start (字符串，可选): 过滤回放的开始日期
• end (字符串，可选): 过滤回放的结束日期
• sort (字符串，可选): 用于排序回放的字段
• query (字符串，可选): 用于过滤回放的搜索查询
• per_page (数字，可选): 每页回放数量
• cursor (字符串，可选): 分页游标
• view (字符串，可选): 视图类型，"summary" 或 "detailed" (默认: "detailed")
• format (字符串，可选): 输出格式，"plain" 或 "markdown" (默认: "markdown")

运行服务器

npx ts-node index.ts

身份验证

此工具需要一个具有访问 Sentry API 权限的 Sentry 身份验证令牌。您可以在 Sentry 帐户设置中（设置 -> 用户设置 -> 身份验证令牌）生成令牌。