使用说明

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
查找 sessionid cookie值
复制此值以用作 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格式提供所有当前问题。

示例工作流

调试生产错误

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 changes

MCP检验员测试

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许可证-请参阅许可证文件以获取详细信息。

支持

问题: GitHub问题
文档: GitHub自述
GlitchTip文档: GlitchTip文档