Glitchtip MCP服务器
用于与Glitchtip API交互的MCP（模型上下文协议）服务器。
主要由Claude Code创建供内部使用。 许可证：GNU AGPLv3
特性
与Glitchtip错误跟踪平台完全集成，提供以下访问：
- 问题和错误详细信息
- 事件和错误发生
- 项目和组织管理
- 团队和成员信息
需求
- Node.js 18+
- 具有适当作用域的Glitchtip API令牌（请参阅“身份验证”部分）
安装
npm install配置
设置以下环境变量：
export GLITCHTIP_API_TOKEN="your-api-token"
export GLITCHTIP_ORGANIZATION_SLUG="your-org-slug"
export GLITCHTIP_API_ENDPOINT="https://app.glitchtip.com" # Or your self-hosted instance使用Claude Desktop
添加到您的Claude Desktop配置(claude_desktop_config.json):
{
"mcpServers": {
"glitchtip": {
"command": "npx",
"args": ["-y", "github:CleverMobi/glitchtip-mcp"],
"env": {
"GLITCHTIP_API_TOKEN": "your-api-token",
"GLITCHTIP_ORGANIZATION_SLUG": "your-org-slug",
"GLITCHTIP_API_ENDPOINT": "https://your-glitchtip-instance.com"
}
}
}
}可用工具
问题和事件工具（必需 event:read 范围）
获取问题
获取特定Glitchtip问题的完整详细信息，包括：
- 基本问题信息（标题、状态、计数、项目等）
- 具有完整堆栈跟踪的最新事件详细信息
- 关于该问题的所有评论
参数：
issue_id（必填）：要检索的问题的ID
例子：
get_issue(issue_id: "21241")返回一个包含三个部分的综合对象：
issue：核心问题详细信息latestEvent：最近发生的与堆栈跟踪、标记和元数据有关的事件comments：包含作者和时间戳的所有评论数组
list_issues
列出组织或特定项目中的问题。
参数：
project_slug（可选）：按项目筛选问题limit（可选）：要返回的最大问题数（默认值：25）
例子：
list_issues(project_slug: "my-project", limit: 10)list_事件
列出特定项目的事件。
参数：
project_slug（必填）：项目进度limit（可选）：要返回的最大事件数（默认值：25）
例子：
list_events(project_slug: "my-project", limit: 5)项目和组织工具
list_项目
列出组织中的所有Glitchtip项目。
无需参数。
例子：
list_projects()get_工程
获取特定Glitchtip项目的详细信息。
参数：
project_slug（必填）：要检索的项目段塞
例子：
get_project(project_slug: "my-project")get_组织
获取组织详细信息，包括所有项目和团队。
无需参数。
例子：
get_organization()list_teams
列出组织中的所有团队。
无需参数。
例子：
list_teams()认证
此服务器使用承载令牌身份验证。您的API令牌需要特定的作用域，具体取决于您要使用的工具：
所需范围
| 工具 | 所需范围 |
|---|---|
get_issue, list_issues, list_events | event:read |
list_projects, get_project | project:read |
get_organization | org:read |
list_teams | team:read |
最小令牌范围
- 有关基本项目/组织信息：
project:read,org:read,team:read,member:read - 对于包括问题在内的完整功能：
project:read,org:read,team:read,member:read,event:read
要在Glitchtip中创建API令牌，请执行以下操作：
- 转到您的Glitchtip实例
- 导航到“设置”→ API令牌
- 创建具有所需作用域的新令牌
测试
测试服务器功能：
# Run basic tests
node test-get-issue.js故障排除
403禁止的错误
如果访问问题或事件时收到403个错误，则API令牌缺少 event:read 范围。创建具有适当作用域的新令牌。
401未经授权的错误
请确保您的API令牌有效，并使用承载身份验证格式。
连接问题
验证您的 GLITCHTIP_API_ENDPOINT 是正确和可访问的。