Руководство по настройке сервера Honeybadger MCP

Этот сервер MCP интегрирует отслеживание ошибок Honeybadger с Cursor IDE, позволяя вам извлекать и анализировать ошибки непосредственно из среды разработки.

Предпосылки

• Node.js 18+ установлен

• Аккаунт Honeybadger с доступом к API

• Курсор IDE с поддержкой MCP

Related MCP server: Jira Context MCP Server

Установка

1. Клонируйте MCP-сервер

git clone git@github.com:vishalzambre/honeybadger-mcp.git
cd honeybadger-mcp
npm install

2. Создайте проект

npm run build

3. Использование в качестве пакета NPM (рекомендуется)

Глобальная установка:

npm install -g honeybadger-mcp

Затем настройте его в курсоре:

{
  "mcpServers": {
    "honeybadger": {
      "command": "honeybadger-mcp",
      "env": {
        "HONEYBADGER_API_KEY": "your_api_key_here",
        "HONEYBADGER_PROJECT_ID": "your_project_id"
      }
    }
  }
}

Проектная установка (альтернативная):

Если вы предпочитаете управлять сервером MCP как зависимостью проекта:

npm install honeybadger-mcp

В этом случае команда в вашем курсоре mcp_servers.json будет указывать на локальную установку в node_modules вашего проекта:

{
  "mcpServers": {
    "honeybadger": {
      "command": "node",
      "args": ["./node_modules/honeybadger-mcp/dist/index.js"],
      "env": {
        "HONEYBADGER_API_KEY": "your_api_key_here",
        "HONEYBADGER_PROJECT_ID": "your_project_id"
      }
    }
  }
}

4. Настройте переменные среды

Создайте файл .env в корневом каталоге вашего проекта:

# Required: Your Honeybadger API key
HONEYBADGER_API_KEY=your_api_key_here

# Optional: Default project ID (can be overridden per request)
HONEYBADGER_PROJECT_ID=your_project_id

# Optional: Custom Honeybadger URL (defaults to https://app.honeybadger.io)
HONEYBADGER_BASE_URL=https://app.honeybadger.io

4. Получите удостоверение Honeybadger

1. API-ключ :

   • Перейдите по ссылке https://app.honeybadger.io/users/auth\_tokens

   • Создайте новый персональный токен аутентификации

   • Скопируйте токен для вашего файла .env

2. Идентификатор проекта :

   • Перейдите к своему проекту в Honeybadger

   • Идентификатор проекта находится в URL: https://app.honeybadger.io/projects/{PROJECT_ID}

   • Или найдите его в настройках проекта

Конфигурация курсора

1. Настройте MCP в курсоре

Добавьте сервер MCP в конфигурацию вашего курсора. Отредактируйте ваш ~/.cursor/mcp_servers.json (или эквивалент):

{
  "mcpServers": {
    "honeybadger": {
      "command": "node",
      "args": ["/path/to/honeybadger-mcp/dist/index.js"],
      "env": {
        "HONEYBADGER_API_KEY": "your_api_key_here",
        "HONEYBADGER_PROJECT_ID": "your_project_id"
      }
    }
  }
}

2. Альтернатива: глобальная установка

Этот раздел будет обновлен или удален, так как теперь он описан выше. Если вы предпочитаете старый способ клонирования и установки глобально из локального пути, вы все равно можете это сделать, но использование опубликованного пакета npm рекомендуется для более простых обновлений и управления.

При установке с локального клона:

# Navigate to your cloned honeybadger-mcp directory
npm install -g . # Installs from the current directory

# Then configure in Cursor as before
# ... (Cursor configuration for local global install)

Использование

После настройки вы сможете использовать следующие инструменты в Cursor:

1. Перечислите недавние неисправности

List recent unresolved errors from Honeybadger in production environment

2. Получите подробную информацию о неисправности

Get details for Honeybadger fault ID 12345

3. Проанализируйте проблему

Analyze Honeybadger issue 12345 and provide fix suggestions

4. Получить сведения о возникновении ошибок

Get the latest 5 occurrences for Honeybadger fault 12345

Доступные инструменты

list_honeybadger_faults

Перечисляет последние неисправности с возможностью фильтрации по среде и статусу устранения.

Параметры:

• project_id (необязательно): идентификатор проекта

• limit (необязательно): количество ошибок (по умолчанию: 20, макс: 100)

• environment (необязательно): Фильтр по среде

• resolved (необязательно): Фильтр по статусу решено

get_honeybadger_fault

Получает подробную информацию о конкретной неисправности.

Параметры:

• fault_id (обязательно): идентификатор неисправности

• project_id (необязательно): идентификатор проекта

get_honeybadger_notices

Вызывает уведомления (возникновения ошибок) для определенной неисправности.

Параметры:

• fault_id (обязательно): идентификатор неисправности

• project_id (необязательно): идентификатор проекта

• limit (необязательно): количество уведомлений (по умолчанию: 10, макс: 100)

analyze_honeybadger_issue

Предоставляет комплексный анализ с предложениями по исправлению.

Параметры:

• fault_id (обязательно): идентификатор неисправности

• project_id (необязательно): идентификатор проекта

• include_context (необязательно): включить контекст запроса (по умолчанию: true)

Пример рабочего процесса

1. Список последних ошибок : «Показать мне последние нерешенные ошибки в производстве»

2. Проанализируйте конкретную ошибку : «Проанализируйте ошибку Honeybadger 12345 и предложите исправления»

3. Получить контекст ошибки : «Получить последние случаи возникновения ошибки 12345 с полным контекстом»

4. Обзор и исправление : используйте анализ, чтобы понять и исправить проблему в вашем коде.

Поиск неисправностей

Общие проблемы

1. Ошибка аутентификации : проверьте правильность ключа API и наличие соответствующих разрешений.

2. Проект не найден : проверьте правильность идентификатора вашего проекта.

3. Проблемы с подключением : проверьте сетевой доступ к API Honeybadger

Режим отладки

Запустите сервер напрямую, чтобы увидеть сообщения об ошибках:

node dist/index.js

Журналы

Проверьте журналы курсора на предмет проблем, связанных с MCP:

• macOS: ~/Library/Logs/Cursor/

• Windows: %APPDATA%\Cursor\logs\

• Linux: ~/.config/Cursor/logs/

Заметки о безопасности

• Храните ключи API в безопасности и никогда не передавайте их в систему контроля версий.

• По возможности используйте API-ключи, специфичные для конкретной среды.

• Рассмотрите возможность использования API-токенов только для чтения для этой интеграции.

• Регулярно меняйте ключи API

Внося вклад

Чтобы расширить этот сервер MCP:

1. Добавить новые инструменты в метод setupToolHandlers()

2. Реализовать соответствующие методы обработчика

3. Обновите список инструментов и документацию

4. Тщательно протестируйте свою настройку Honeybadger

Поддерживать

По вопросам:

• Этот сервер MCP : проверьте код и конфигурацию

• Honeybadger API : см. документацию по Honeybadger API.

• Интеграция Cursor MCP : проверьте документацию Cursor