Sentry MCP

哨兵-mcp

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

它基于Cloudflare 针对远程 MCP 的工作。

入门

通过访问生产中部署的服务，您将找到需要了解的一切：

https://mcp.sentry.dev

如果您希望做出贡献、了解其工作原理或为自托管 Sentry 运行它，请继续阅读以下内容。

Stdio 与 Remote

虽然此仓库专注于充当 MCP 服务，但我们也支持stdio传输。此功能仍在开发中，但它是在自托管 Sentry 安装中运行 MCP 的最简单方法。

要使用stdoio传输，您需要在 Sentry 中创建一个具有必要作用域的个人 API 令牌 (PAT)。截至撰写本文时，情况如下：

启动运输：

注意：您还可以使用环境变量：

MCP 检查器

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

输入 MCP 服务器 URL（ http://localhost:5173 ）并点击“连接”。这将触发身份验证流程。

注意：如果您在访问127.0.0.1上的检查器时遇到 OAuth 流程问题，请尝试使用localhost ，即访问http://localhost:6274 。

本地开发

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

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

核实

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

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

测试

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

可以使用以下方式运行单元测试：

Evals 需要一个带有一些配置的.env文件：

完成后，您可以使用以下方式运行它们：

笔记

使用 Claude 和其他 MCP 客户端

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

使用 Cursor 和其他 MCP 客户端

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

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

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