【技术文档摘要】： 注意 - 这大部分已被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

此MCP已验证可在Cursor、Codeium Windsurf和Claude Desktop中正常工作。

与Claude一起使用

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

{
    "mcpServers": {
        "sentry": {
            "command": "npx",
            "args": ["ts-node", "/Users/<your-user-directory>/sentry-mcp-ts/index.ts"],
            "env": {
                "SENTRY_AUTH": "<YOUR_AUTH_TOKEN>"
            }
        }
    }
}

• 更新args字段中的目录路径。
• 将<YOUR_AUTH_TOKEN>替换为您自己的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-111）
• 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”）

create_project

在Sentry中创建一个新的项目，并检索其客户端密钥。

参数：

• organization_slug（字符串，必需）：要创建项目的组织的slug
• team_slug（字符串，必需）：分配项目的团队的slug
• name（字符串，必需）：新项目的名称
• platform（字符串，可选）：新项目的平台
• view（字符串，可选）：视图类型，可以是“summary”或“detailed”（默认：“detailed”）
• format（字符串，可选）：输出格式，可以是“plain”或“markdown”（默认：“markdown”）

list_project_issues

列出特定Sentry项目中的问题。

参数：

• organization_slug（字符串，必需）：项目所属组织的slug
• project_slug（字符串，必需）：要列出问题的项目的slug
• view（字符串，可选）：视图类型，可以是“summary”或“detailed”（默认：“detailed”）
• format（字符串，可选）：输出格式，可以是“plain”或“markdown”（默认：“markdown”）

list_issue_events

列出特定Sentry问题中的事件。

参数：

• organization_slug（字符串，必需）：问题所属组织的slug
• issue_id（字符串，必需）：要列出事件的问题ID
• view（字符串，可选）：视图类型，可以是“summary”或“detailed”（默认：“detailed”）
• format（字符串，可选）：输出格式，可以是“plain”或“markdown”（默认：“markdown”）

get_sentry_issue

检索并分析Sentry问题。

参数：

• issue_id_or_url（字符串，必需）：完整的Sentry问题URL或仅数字问题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认证令牌来访问Sentry API。您可以在Sentry账户设置下的Settings -> User Settings -> Auth Tokens生成一个令牌。