Sentry-MCP服务器
一个作为 Sentry API 中间件的远程模型上下文协议服务器，允许像 Claude 这样的 AI 助手通过自然语言接口访问 Sentry 的数据和功能。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"math": {
"args": [
"mcp-remote",
"https://mcp-github-oauth.\u003cyour-subdomain\u003e.workers.dev/sse"
],
"command": "npx"
}
}
}该服务需要配置环境变量：SENTRY_AUTH_TOKEN、SENTRY_CLIENT_ID、SENTRY_CLIENT_SECRET、SENTRY_URL
服务介绍
sentry-mcp
这是一个远程MCP服务器的原型，作为中间件连接到上游Sentry API提供商。
开始使用
访问生产环境中部署的服务，您将找到所需的所有信息：
如果您希望贡献代码、了解其工作原理或为自托管Sentry运行此服务，请继续阅读...
标准输入输出与远程
尽管此仓库专注于作为一个MCP服务，我们也支持stdio传输。这仍然是一个正在进行中的工作，但这是针对自托管Sentry安装最简单的适应方式。
要利用stdout传输，您需要在Sentry中创建一个具有必要权限范围的个人API令牌（PAT）。截至撰写本文时，这包括：
org:read
project:read
project:write
team:read
team:write
event:read
克隆仓库并像往常一样设置它：
pnpm install
pnpm build
启动传输：
pnpm start:stdio --access-token=sentry-pat --host=sentry.example.com
注意：您也可以使用环境变量：
SENTRY_AUTH_TOKEN=
SENTRY_HOST=
MCP 检查器
MCP 包含一个 检查器，以便轻松测试该服务：
pnpm inspector
输入 https://[domain].workers.dev/sse (TODO) 并点击连接。一旦通过身份验证流程，您将看到工具正在工作：
从 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
要测试本地服务器，请在Inspector中输入 http://localhost:8788/sse 并点击连接。按照提示操作后，您将能够“列出工具”。
测试
包含两个测试套件：基本单元测试和一些评估。
单元测试可以使用以下命令运行：
pnpm test
评估需要一个带有某些配置的 .env 文件：
OPENAI_API_KEY=
完成上述步骤后，您可以使用以下命令运行它们：
pnpm test
注意事项
使用Claude和其他MCP客户端
当使用Claude连接到您的远程MCP服务器时，您可能会看到一些错误消息。这是因为Claude桌面版还不支持远程MCP服务器，因此有时会感到困惑。要验证MCP服务器是否已连接，请将鼠标悬停在Claude界面右下角的🔨图标上。在那里您应该能看到可用的工具。
使用Cursor和其他MCP客户端
要将Cursor与您的MCP服务器连接，请选择类型：“命令”，并在命令字段中，将命令和参数字段合并为一个（例如 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）。
