MCP GlitchTip
一个MCP（模型上下文协议）服务器，将GlitchTip错误监控与Claude等人工智能助手集成在一起。这允许AI分析并帮助解决GlitchTip实例中的错误。
它做什么
此MCP服务器使AI助手能够：
- 从GlitchTip实例中获取并分析当前问题
- 获取详细的错误上下文，包括堆栈跟踪、用户数据和面包屑
- 帮助调试并根据错误模式提出解决方案
示例用例
User: "Check GlitchTip for any payment-related errors"
AI Assistant:
- Fetches all unresolved issues from GlitchTip
- Identifies payment component errors
- Analyzes stack traces and error patterns
- Suggests specific fixes based on the error context快速开始
1.获取您的GlitchTip凭据
您需要：
- 认证：API令牌（推荐）或会话ID Cookie
- 组织结构图：GlitchTip中的组织标识符
- 基本URL （可选）：您的GlitchTip实例URL（如果自托管）
身份验证选项
选项1：API代币（推荐）
- 登录您的GlitchTip实例
- 转到/profile/auth令牌
- 创建具有适当权限的新API令牌
- 复制令牌以用作
GLITCHTIP_TOKEN
选项2：会话ID
- 登录您的GlitchTip实例
- 打开浏览器开发工具（F12）
- 转到应用程序/存储>Cookie
- 查找
sessionidcookie值 - 复制此值以用作
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" >> .gitignore3.在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格式提供所有当前问题。
示例工作流
调试生产错误
User: "Check GlitchTip for recent 500 errors"
AI: [Fetches issues] I found 3 recent 500 errors:
1. DatabaseConnectionError in /api/users
2. TimeoutError in payment processing
3. ValidationError in checkout flow
User: "Show me details about the payment timeout"
AI: [Gets latest event] The TimeoutError occurs when...
[Provides stack trace analysis and suggested fixes]监控错误趋势
User: "What are the most frequent errors in GlitchTip?"
AI: [Analyzes issue counts] The top errors by frequency are:
1. CORS policy errors (145 occurrences)
2. Missing authentication token (89 occurrences)
3. Rate limit exceeded (67 occurrences)发展
从源头构建
git clone https://github.com/coffebar/mcp-glitchtip.git
cd mcp-glitchtip
npm install
npm run build发展模式
npm run watch # Auto-rebuild on changesMCP检验员测试
npm run inspector在运行检查器之前设置所需的环境变量：
export GLITCHTIP_TOKEN="your-api-token"
# OR export GLITCHTIP_SESSION_ID="your-session-id"
export GLITCHTIP_ORGANIZATION="your-org"
npm run inspector故障排除
身份验证错误
如果您看到“身份验证失败。请检查您的令牌或会话ID”：
- 如果使用令牌：验证其有效性并具有适当的权限
- 如果使用会话ID：您的会话可能已过期-从GlitchTip获取新的会话ID
- 验证您使用的组织块是否正确
- 检查您的GlitchTip实例是否需要额外的身份验证标头
连接错误
如果您看到“连接到GlitchTip失败”：
- 验证您的
GLITCHTIP_BASE_URL是正确的 - 检查您是否位于代理服务器或防火墙之后
- 确保您的GlitchTip实例可以从网络访问
未发现问题
如果工具返回空结果：
- 验证GlitchTip项目中是否存在实际问题
- 检查您的组织结构是否正确
- 确保您的会话具有查看问题的权限
安全说明
- 永不承诺
.mcp.json到版本控制 -它包含敏感凭据 - 对于团队使用，每个开发人员都应该使用自己的API令牌或会话ID
贡献
欢迎投稿！拜托：
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用，添加测试
- 提交拉取请求
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
支持
- 问题:
- 文档:
- GlitchTip文档: GlitchTip文档