AI导哈

错误监控集成服务

GlitchTip MCP Server是一个用于将GlitchTip错误监控系统与AI助手（如Claude）集成的服务，提供错误查询、分析和调试功能。

  • by vltansky
  • JavaScript
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 vltansky/glitchtip-mcp

使用说明

GlitchTip MCP服务器

MCP服务器，用于将GlitchTip错误监控与Claude等AI助手集成。

安装

Install in Cursor

先决条件

  1. 光标IDE 安装
  2. GlitchTip API令牌或会话ID
  3. 你的GlitchTip组织蛞蝓

快速安装

单击上面的按钮并按照安装流程进行操作，或手动配置：

手动配置

  1. 打开MCP配置文件：

    • 全球（所有项目）: ~/.cursor/mcp.json
    • 项目特定: .cursor/mcp.json 在项目根中

  2. 添加以下配置：

{
  "mcpServers": {
    "glitchtip": {
      "command": "npx",
      "args": ["-y", "glitchtip-mcp"],
      "env": {
        "GLITCHTIP_TOKEN": "your-api-token",
        "GLITCHTIP_ORGANIZATION": "your-org-slug",
        "GLITCHTIP_BASE_URL": "https://app.glitchtip.com"
      }
    }
  }
}
  1. 用实际值替换环境变量
  2. 保存文件并重新启动Cursor

使用.env文件（推荐）

为了提高安全性，请将凭据存储在 .env 文件：

  1. 创建 .env 在项目根目录中：
GLITCHTIP_TOKEN=your-api-token
GLITCHTIP_ORGANIZATION=your-org-slug
GLITCHTIP_BASE_URL=https://app.glitchtip.com
  1. 更新 .cursor/mcp.json:
{
  "mcpServers": {
    "glitchtip": {
      "command": "npx",
      "args": ["-y", "glitchtip-mcp"]
    }
  }
}
  1. 添加 .env 到 .gitignore:
echo ".env" >> .gitignore

验证安装

  1. 完全重新启动游标
  2. 检查设置中的绿点→ 工具和集成→ MCP工具
  3. 在聊天/编辑器中，选中“可用工具”
  4. 测试：“显示GlitchTip错误”
Install in Claude Desktop

先决条件

  1. 克劳德桌面 安装
  2. GlitchTip API令牌或会话ID
  3. 你的GlitchTip组织蛞蝓

配置

  1. 打开您的Claude Desktop配置文件：

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 视窗: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. 添加以下配置：

{
  "mcpServers": {
    "glitchtip": {
      "command": "npx",
      "args": ["-y", "glitchtip-mcp"],
      "env": {
        "GLITCHTIP_TOKEN": "your-api-token",
        "GLITCHTIP_ORGANIZATION": "your-org-slug",
        "GLITCHTIP_BASE_URL": "https://app.glitchtip.com"
      }
    }
  }
}
  1. 用实际值替换环境变量
  2. 保存文件并重新启动Claude Desktop

使用.env文件（推荐）

为了提高安全性，请将凭据存储在 .env 文件：

  1. 创建 .env 在项目根目录中：
GLITCHTIP_TOKEN=your-api-token
GLITCHTIP_ORGANIZATION=your-org-slug
GLITCHTIP_BASE_URL=https://app.glitchtip.com
  1. 更新 claude_desktop_config.json:
{
  "mcpServers": {
    "glitchtip": {
      "command": "npx",
      "args": ["-y", "glitchtip-mcp"]
    }
  }
}
  1. 添加 .env 到 .gitignore:
echo ".env" >> .gitignore

验证安装

  1. 完全重新启动克劳德桌面
  2. 寻找🔌 右下角的图标
  3. 单击它查看可用的MCP服务器
  4. 测试：“显示GlitchTip错误”
Install in Claude Code CLI

先决条件

  1. 克劳德代码CLI 安装
  2. GlitchTip API令牌或会话ID
  3. 你的GlitchTip组织蛞蝓

安装

在终端中运行以下命令：

claude mcp add glitchtip -e GLITCHTIP_TOKEN=your-api-token -e GLITCHTIP_ORGANIZATION=your-org-slug -e GLITCHTIP_BASE_URL=https://app.glitchtip.com -- npx -y glitchtip-mcp

使用环境变量（推荐）

为了提高安全性，请将凭据存储在 .env 文件：

  1. 创建 .env 在项目根目录中：
GLITCHTIP_TOKEN=your-api-token
GLITCHTIP_ORGANIZATION=your-org-slug
GLITCHTIP_BASE_URL=https://app.glitchtip.com
  1. 添加MCP服务器：
claude mcp add glitchtip -e GLITCHTIP_TOKEN=$(grep GLITCHTIP_TOKEN .env | cut -d '=' -f2) -e GLITCHTIP_ORGANIZATION=$(grep GLITCHTIP_ORGANIZATION .env | cut -d '=' -f2) -e GLITCHTIP_BASE_URL=$(grep GLITCHTIP_BASE_URL .env | cut -d '=' -f2) -- npx -y glitchtip-mcp
  1. 添加 .env 到 .gitignore:
echo ".env" >> .gitignore

配置范围

  • -s user：适用于所有项目
  • -s project：通过共享 .mcp.json 文件（已提交至仓库）
  • 违约： local （仅限当前项目）

验证安装

claude mcp list
claude mcp get glitchtip

测试：“显示GlitchTip错误”

Install in Cline (VS Code Extension)

先决条件

  1. VS Code 安装
  2. 临床扩展 安装
  3. GlitchTip API令牌或会话ID
  4. 你的GlitchTip组织蛞蝓

配置

  1. 打开VS代码
  2. 单击MCP服务器图标(📚) 在Cline扩展中
  3. 单击“已安装”选项卡
  4. 点击“配置MCP服务器”
  5. 添加以下内容 cline_mcp_settings.json:
{
  "mcpServers": {
    "glitchtip": {
      "command": "npx",
      "args": ["-y", "glitchtip-mcp"],
      "env": {
        "GLITCHTIP_TOKEN": "your-api-token",
        "GLITCHTIP_ORGANIZATION": "your-org-slug",
        "GLITCHTIP_BASE_URL": "https://app.glitchtip.com"
      }
    }
  }
}
  1. 用实际值替换环境变量
  2. 保存文件
  3. 重新启动VS Code或重新加载Cline扩展

使用.env文件（推荐）

为了提高安全性，请将凭据存储在 .env 文件：

  1. 创建 .env 在项目根目录中：
GLITCHTIP_TOKEN=your-api-token
GLITCHTIP_ORGANIZATION=your-org-slug
GLITCHTIP_BASE_URL=https://app.glitchtip.com
  1. 更新 cline_mcp_settings.json:
{
  "mcpServers": {
    "glitchtip": {
      "command": "npx",
      "args": ["-y", "glitchtip-mcp"]
    }
  }
}
  1. 添加 .env 到 .gitignore:
echo ".env" >> .gitignore

验证安装

  1. 重新启动VS代码或重新加载Cline
  2. 检查Cline中的MCP服务器面板
  3. 在连接的服务器列表中查找“故障提示”
  4. 测试：“显示GlitchTip错误”

获取您的GlitchTip凭据

API Token (Recommended)
  1. 登录GlitchTip
  2. 首选 https://app.glitchtip.com/profile/auth-tokens
  3. 创建新的API令牌
  4. 复制令牌
Session ID (Alternative)
  1. 登录GlitchTip
  2. 打开浏览器DevTools（F12）
  3. 转到应用程序/存储→ Cookie
  4. 复制 sessionid cookie值

配置

变量 必填 描述 默认值
GLITCHTIP_TOKEN 是* neneneba API令牌 -
GLITCHTIP_SESSION_ID 是* 会话cookie -
GLITCHTIP_ORGANIZATION 是 组织结构图 -
GLITCHTIP_BASE_URL 否 实例URL https://app.glitchtip.com

*要么 GLITCHTIP_TOKEN 或 GLITCHTIP_SESSION_ID 是必需的

可用工具

glitchtip_issues

从GlitchTip获取问题。

参数:

  • status （可选）： 'resolved', 'unresolved'，或 'all' （默认值： 'unresolved')

例子:

  • “显示所有GlitchTip错误”
  • “解决问题”
  • “显示所有问题，包括已解决的问题”

glitchtip_latest_event

获取具有完整上下文的特定问题的最新事件。

参数:

  • issueId：问题ID

示例：“获取问题#123的详细信息”

可用资源

glitchtip://issues

资源端点以JSON格式提供所有当前问题。

可用提示

recent_errors

通过分析和优先级排序获得最近生产错误的概述。

用例：快速对生产问题进行分类

示例：“使用recent_errors提示符”

debug_issue

深入了解具有完整上下文和建议修复的特定错误。

参数:

  • issueId：要调试的问题ID

用例：对特定错误的详细调查

示例：“对问题12345使用debug_issue提示符”

使用示例

调试生产错误

User: "Check GlitchTip for recent 500 errors"

AI: 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: [Analyzes event] The TimeoutError occurs when...
[Provides stack trace and suggested fixes]

监控错误趋势

User: "What are the most frequent errors?"

AI: Top errors by frequency:
1. CORS policy errors (145 occurrences)
2. Missing auth token (89 occurrences)
3. Rate limit exceeded (67 occurrences)

使用提示进行引导分析

User: "Use the recent_errors prompt"

AI: [Analyzes all unresolved issues]
Summary:
- 23 unresolved errors across 5 projects
- Critical: DatabaseConnectionError (89 occurrences)
- High: TimeoutError in payment flow (45 occurrences)
- Medium: ValidationErrors (12 occurrences)

Recommended prioritization:
1. Fix database connection pooling
2. Investigate payment timeout root cause
3. Add validation for edge cases

User: "Use the debug_issue prompt for issue 12345"

AI: [Deep-dives into specific error with stack trace and fix suggestions]

故障排除

认证失败

  • 验证您的令牌/会话ID是否有效
  • 检查组织结构是否正确
  • 确保令牌具有适当的权限

连接错误

  • 验证 GLITCHTIP_BASE_URL 是正确的
  • 检查网络连接
  • 确保GlitchTip实例可访问

未发现问题

  • 验证GlitchTip中是否存在问题
  • 检查组织结构
  • 确保您有权限查看问题

安全

  • 永不承诺 .mcp.json, .cursor/mcp.json，或 .env 到版本控制
  • 使用 .env 用于存储机密的文件（如果添加到 .gitignore)
  • 使用API令牌而不是会话ID用于团队使用
  • 每个开发人员都应该使用自己的凭据

发展与贡献

安装

npm install

构建

npm run build

观看模式

npm run watch

使用MCP检查员进行测试

export GLITCHTIP_TOKEN="your-token"
export GLITCHTIP_ORGANIZATION="your-org"
npm run inspector

项目结构

glitchtip-mcp/
├── src/
│   ├── types.ts      # TypeScript type definitions
│   ├── client.ts     # GlitchTip API client
│   └── index.ts      # MCP server implementation
├── package.json
├── tsconfig.json
└── README.md

许可证

麻省理工学院

基于 mcp-glitchtip

相关 MCP