MCP GlitchTip

一个集成GlitchTip错误监控与AI助手（如Claude）的MCP（模型上下文协议）服务器。这使得AI能够分析并帮助解决来自你的GlitchTip实例中的错误。

功能概述

此MCP服务器使AI助手能够：

• 获取并分析来自GlitchTip实例的当前问题
• 获取详细的错误上下文，包括堆栈跟踪、用户数据和面包屑
• 基于错误模式进行调试并提出解决方案

示例用例

用户："检查GlitchTip中是否有与支付相关的错误"

AI助手：
- 获取GlitchTip中所有未解决的问题
- 识别支付组件错误
- 分析堆栈跟踪和错误模式
- 根据错误上下文建议具体的修复方法

快速开始

1. 获取你的GlitchTip凭证

你需要：

• 认证：API令牌（推荐）或会话ID Cookie
• 组织标识符：你在GlitchTip中的组织标识符
• 基础URL（可选）：如果你自托管GlitchTip实例，则需要提供其URL

认证选项

选项1：API令牌（推荐）

1. 登录到你的GlitchTip实例
2. 转到/profile/auth-tokens
3. 创建具有适当权限的新API令牌
4. 复制该令牌作为GLITCHTIP_TOKEN使用

选项2：会话ID

1. 登录到你的GlitchTip实例
2. 打开浏览器开发者工具（F12）
3. 转到Application/Storage > Cookies
4. 查找sessionidCookie值
5. 复制该值作为GLITCHTIP_SESSION_ID使用

2. 配置项目

在项目根目录创建.mcp.json文件：

{
  "mcpServers": {
    "glitchtip": {
      "command": "npx",
      "args": ["-y", "mcp-glitchtip"],
      "env": {
        "GLITCHTIP_TOKEN": "your-api-token-here",
        "GLITCHTIP_ORGANIZATION": "your-org-slug",
        "GLITCHTIP_BASE_URL": "https://app.glitchtip.com"
      }
    }
  }
}

注意：将.mcp.json添加到.gitignore以确保凭证安全：

echo ".mcp.json" >> .gitignore

3. 在Claude Desktop中打开项目

当你在Claude Desktop中打开项目文件夹时，它会自动检测.mcp.json配置并连接到你的GlitchTip实例。

配置选项

环境变量	是否必需	描述	默认值
GLITCHTIP_TOKEN	是*	你的GlitchTip API令牌（推荐）	-
GLITCHTIP_SESSION_ID	是*	你的GlitchTip会话Cookie	-
GLITCHTIP_ORGANIZATION	是	GlitchTip URL中的组织标识符	-
GLITCHTIP_BASE_URL	否	GlitchTip实例URL	https://app.glitchtip.com

*需要提供GLITCHTIP_TOKEN或GLITCHTIP_SESSION_ID之一。如果两者都提供，GLITCHTIP_TOKEN优先。

自托管GlitchTip

如果你使用的是自托管的GlitchTip实例，请更新GLITCHTIP_BASE_URL：

"GLITCHTIP_BASE_URL": "https://glitchtip.your-domain.com"

可用工具

glitchtip_issues

获取GlitchTip中的所有问题（默认情况下为未解决的问题）。

用法："显示我所有的GlitchTip错误"

glitchtip_latest_event

获取特定问题的最新事件及其完整的错误上下文。

参数：

• issueId：要获取详情的问题ID

用法："获取GlitchTip问题#123的详情"

可用资源

glitchtip://issues

一个资源端点，提供所有当前问题的JSON格式。

示例工作流程

调试生产错误

用户："检查GlitchTip中最近的500错误"

AI：[获取问题] 我找到了3个最近的500错误：
1. 数据库连接错误在/api/users
2. 支付处理超时错误
3. 结算流验证错误

用户："显示有关支付超时的详细信息"

AI：[获取最新事件] 超时错误发生在...
[提供堆栈跟踪分析和建议的修复方法]

监控错误趋势

用户："GlitchTip中最频繁的错误是什么？"

AI：[分析问题数量] 按频率排名最高的错误是：
1. CORS策略错误（145次）
2. 缺少身份验证令牌（89次）
3. 超过速率限制（67次）

开发

从源码构建

git clone https://github.com/coffebar/mcp-glitchtip.git
cd mcp-glitchtip
npm install
npm run build

开发模式

npm run watch  # 自动重建更改

使用MCP Inspector测试

npm run inspector

运行inspector之前设置所需的环境变量：

export GLITCHTIP_TOKEN="your-api-token"
# 或者 export GLITCHTIP_SESSION_ID="your-session-id"
export GLITCHTIP_ORGANIZATION="your-org"
npm run inspector

故障排除

认证错误

如果你看到“认证失败。检查你的令牌或会话ID”：

1. 如果使用令牌：验证它是有效的，并且具有适当的权限
2. 如果使用会话ID：你的会话可能已过期 - 从GlitchTip获取新的会话ID
3. 验证你是否使用了正确的组织标识符
4. 检查你的GlitchTip实例是否需要额外的身份验证头

连接错误

如果你看到“无法连接到GlitchTip”：

1. 验证你的GLITCHTIP_BASE_URL是否正确
2. 检查你是否位于代理或防火墙后面
3. 确保你的GlitchTIP实例可以从你的网络访问

没有找到问题

如果工具返回空结果：

1. 验证你的GlitchTip项目中确实存在问题
2. 检查你的组织标识符是否正确
3. 确保你的会话有权查看这些问题

安全注意事项

• 永远不要将.mcp.json提交到版本控制 - 它包含敏感凭证
• 对于团队使用，每个开发者应使用自己的API令牌或会话ID

贡献

欢迎贡献！请：

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 如适用，添加测试
5. 提交拉取请求

许可证

MIT许可证 - 详情见LICENSE文件。

支持

• 问题：GitHub Issues
• 文档：GitHub README
• GlitchTip文档：GlitchTip文档