sentry-mcp

这是一个远程 MCP 服务器的原型，充当上游 Sentry API 提供者的中间件。

它基于 Cloudflare 在远程 MCP 方面的工作。

入门

https://sentry.cool

Stdio vs Remote

虽然此存储库主要服务于远程 MCP 用例，但我们也支持 stdio 传输。

注意：这目前是一个草案，无法通过分发获得。

您需要确保您的令牌已配置必要的范围。 截至撰写本文时，这些范围是：

org:read project:read project:write team:read team:write event:read

您可以在源代码中找到所需范围的规范参考。

启动 stdio 传输只需要您绑定 SENTRY_AUTH_TOKEN 并运行提供的脚本：

SENTRY_AUTH_TOKEN= npm run start:stdio

自托管 Sentry

您可以覆盖 SENTRY_URL 环境变量来设置您的基本 Sentry url：

SENTRY_URL=https://sentry.mycompany.com

MCP 检查器

MCP 包含一个 检查器，可以轻松测试服务：

pnpm inspector

输入 https://[domain].workers.dev/sse (TODO) 并点击连接。 完成身份验证流程后，您将看到工具正在工作：

<img width="640" alt="image" src="https://github.com/user-attachments/assets/7973f392-0a9d-4712-b679-6dd23f824287" />

从 Claude Desktop 访问远程 MCP 服务器

打开 Claude Desktop 并导航到设置，按 ⌘ + , (逗号) -> 开发者 -> 编辑配置。 这将打开控制 Claude 可以访问哪些 MCP 服务器的配置文件。

将内容替换为以下配置。 重启 Claude Desktop 后，将打开一个浏览器窗口，显示您的 OAuth 登录页面。 完成身份验证流程以授予 Claude 访问您的 MCP 服务器的权限。 授予访问权限后，这些工具将可供您使用。

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-github-oauth.<your-subdomain>.workers.dev/sse"
      ]
    }
  }
}

一旦工具（在 🔨 下）出现在界面中，您就可以要求 Claude 使用它们。 例如：“你能用数学工具加 23 和 19 吗？”。 Claude 应该调用该工具并显示 MCP 服务器生成的结果。

本地开发

如果您想迭代和测试您的 MCP 服务器，您可以在本地开发中进行。 这将需要您在 Sentry 中创建另一个 OAuth 应用程序（设置 => API => 应用程序）：

• 对于主页 URL，指定 http://localhost:8788
• 对于授权重定向 URI，指定 http://localhost:8788/callback
• 记下您的客户端 ID 并生成一个客户端密钥。
• 在您的项目根目录中创建一个 .dev.vars 文件，其中包含：

SENTRY_CLIENT_ID=your_development_sentry_client_id
SENTRY_CLIENT_SECRET=your_development_sentry_client_secret

验证

在本地运行服务器，使其在 http://localhost:8788 上可用

pnpm dev

要测试本地服务器，请在检查器中输入 http://localhost:8788/sse 并点击连接。 按照提示操作后，您将能够“列出工具”。

测试

包含两个测试套件：基本单元测试和一些评估。

可以使用以下命令运行单元测试：

pnpm test

Evals 将需要一个包含一些配置的 .env 文件：

OAUTH_API_TOKEN=
SENTRY_AUTH_TOKEN=

完成后，您可以使用以下命令运行它们：

pnpm eval

笔记

使用 Claude 和其他 MCP 客户端

当使用 Claude 连接到您的远程 MCP 服务器时，您可能会看到一些错误消息。 这是因为 Claude Desktop 尚不支持远程 MCP 服务器，因此有时会感到困惑。 要验证 MCP 服务器是否已连接，请将鼠标悬停在 Claude 界面右下角的 🔨 图标上。 您应该在那里看到您的工具可用。

使用 Cursor 和其他 MCP 客户端

要将 Cursor 与您的 MCP 服务器连接，请选择“类型”：“命令”，并在“命令”字段中，将命令和 args 字段合并为一个（例如 npx mcp-remote https://<your-worker-name>.<your-subdomain>.workers.dev/sse）。

请注意，虽然 Cursor 支持 HTTP+SSE 服务器，但它不支持身份验证，因此您仍然需要使用 mcp-remote（并使用 STDIO 服务器，而不是 HTTP 服务器）。

您可以通过打开客户端的配置文件，添加与 Claude 设置中使用的相同的 JSON，然后重新启动 MCP 客户端，将您的 MCP 服务器连接到其他 MCP 客户端（如 Windsurf）。