mcp-sentry: Instructions file for Codex

mcp-sentry — инструкции для агента

MCP-сервер для Sentry API. Точка входа — src/index.ts. Node.js ≥ 22 (engines, CI, .nvmrc). После правок: npm run compile, поднять version в package.json, push в master (CI → dist + git-тег v{version}) и reload MCP в Cursor.

Подробности для людей — README.md. История версий — CHANGELOG.md. План апгрейда на @sentry/api — sentry-api-upgrade.md.

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

npx (без клона)

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

Креды только в env MCP-конфига. dotenv из .env пакета не рассчитан на этот режим.

Релиз: bump version в package.json → push master → CI → dist + git-тег v{version}.

Скрипт сборки — compile, не build: см. .cursor/rules/mcp-server-development.mdc (npm/cli#4003). На dist уходит runtime-only package.json без devDependencies и compile-скриптов.

Ref в args:

"github:CynepHy6/mcp-sentry#semver:^1"
"github:CynepHy6/mcp-sentry#v1.2.0"
"github:CynepHy6/mcp-sentry#semver:1.2.0"

Node.js (nvm)

В корне репозитория — .nvmrc с версией 22. Перед npm install / compile / test:

nvm use          # читает .nvmrc
node --version   # ожидается v22.x

Если Node 22 ещё не установлен: nvm install 22. Чтобы не переключать вручную в каждой сессии: nvm alias default 22.

Важно: /usr/bin/node может оставаться на 20 — для разработки опираться на nvm use, не на системный node.

Локальный клон

• git clone https://github.com/CynepHy6/mcp-sentry.git
• nvm use (см. выше)
• .env в корне репозитория (см. .env.example). index.ts подхватывает его через dotenv из build/ → ../.env.
• Cursor MCP: node + build/index.js; переменные можно задать в env блока MCP или только в .env. Для локального клона в command лучше абсолютный путь к node из nvm, например ~/.nvm/versions/node/v22.22.3/bin/node, иначе Cursor может подхватить системный Node 20.