mcp-sentry

MCP-сервер для Sentry API в Cursor.

Требования: Node.js ≥ 22 (для будущей миграции на @sentry/api и CI). В репозитории есть .nvmrc — при работе из клона: nvm use.

Быстрый старт (npx, без клона)

1. Добавить в Cursor MCP (~/.cursor/mcp.json или project config):

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["-y", "github:CynepHy6/mcp-sentry#semver:^1"],
      "env": {
        "SENTRY_AUTH": "your_sentry_auth_token",
        "SENTRY_HOST": "https://sentry.example.com"
      }
    }
  }
}

Креды передаются только через env в MCP-конфиге

Переменная	Обязательна	По умолчанию
SENTRY_AUTH	да	—
SENTRY_HOST	нет	https://sentry.io
PROTOCOL	нет	https

2. Reload MCP в Cursor.

Версия в args

npx скачивает пакет из GitHub по адресу github:CynepHy6/mcp-sentry. Суффикс после # выбирает, какую версию установить:

• каждый релиз помечен git-тегом вида v1.2.0 (история — в CHANGELOG.md);
• npx сохраняет установку в ~/.npm/_npx/<hash>/, где hash зависит от строки в args.

Ref	Пример args	Когда использовать
диапазон v1.x	["-y", "github:CynepHy6/mcp-sentry#semver:^1"]	по умолчанию; при старте MCP подтягивает максимальный git-тег v1.x
конкретный тег	["-y", "github:CynepHy6/mcp-sentry#v1.2.0"]	зафиксировать версию
exact semver	["-y", "github:CynepHy6/mcp-sentry#semver:1.2.0"]	то же, через semver (ищет тег v1.2.0)

Обновление: с #semver:^1 новый релиз v1.x обычно подтягивается при старте MCP — reload Cursor чаще всего достаточно. С #v1.2.0 версия зафиксирована: смените ref или удалите sandbox. Если не помогло — npx clear-npx-cache и снова reload MCP.

Альтернатива: локальный клон

git clone https://github.com/CynepHy6/mcp-sentry.git
cd mcp-sentry
nvm use                # Node 22 из .nvmrc
cp .env.example .env   # заполнить креды
npm install && npm run compile

{
  "mcpServers": {
    "sentry": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-sentry/build/index.js"]
    }
  }
}

Креды можно держать в .env в корне клонированного репозитория.

Что умеет

• просмотр проектов организации;
• получение issue и событий по ID или URL;
• извлечение контекста из событий;
• экспорт событий и полей в локальные JSONL-файлы.

Документация

Файл	Для кого
AGENTS.md	разработка, workflows
CHANGELOG.md	история релизов
mcp-config.example.json	MCP-конфиг npx, диапазон v1.x (#semver:^1)