errorwatch

errorwatch

errorwatch は、1 つの小さなバイナリから Sentry アカウントを監視します。 エージェントは、トークンの所有者を確認し、組織、プロジェクト、リリースを 順に確認し、Sentry 独自のクエリ構文でイシューストリームを検索し、 イシューと最新のイベントを開き、イシューのステータスを変更し、 コメントを読んだり残したりできます。コマンドラインから実行することも、 エージェント向けの MCP サーバーとして実行することもできます。

Sentry 認証トークンが必要です。SENTRY_AUTH_TOKEN 環境変数に設定してください。トークンは Bearer トークンとして API に送信され、 出力に表示されることはありません。変数が設定されていない場合、 すべての呼び出しはその変数名を示すエラーで失敗します。

これは Sentry API の中核となる一部であり、API 全体ではありません。 ホスト型のドキュメント検索ツール、AI 自動修正（Seer）ツール、 プロファイリング／トレース／スパンの検索、DSN とプロジェクトの作成、 その他の管理操作、およびイシュー以外の組織統計は対象外です。

インストール

npx @reneturcios/errorwatch list-organizations

または、コンテナーイメージを実行します。

docker run -i -e SENTRY_AUTH_TOKEN ghcr.io/cloudcorprecords/errorwatch

コンテナーはデフォルトで MCP サーバーを起動します（下記参照）。 CLI として使用するには、CLI 引数を渡してください。

CLI

export SENTRY_AUTH_TOKEN="your auth token"

errorwatch whoami
errorwatch list-organizations
errorwatch list-projects --org acme
errorwatch list-releases --org acme --project web
errorwatch search-issues --org acme --query "is:unresolved TypeError"
errorwatch get-issue --issue-id 123456

errorwatch --version

終了コード：成功時は 0、API 呼び出しの失敗時（SENTRY_AUTH_TOKEN が 設定されていない場合を含む）は 1、使用方法のエラー時は 2 です。

MCP サーバー

1 つのバイナリで、どちらの使い方にも対応します。mcp サブコマンドで stdio MCP サーバーを起動します。

npx -y @reneturcios/errorwatch mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "errorwatch": {
      "command": "npx",
      "args": ["-y", "@reneturcios/errorwatch", "mcp"],
      "env": { "SENTRY_AUTH_TOKEN": "your auth token" }
    }
  }
}

ツール

ツール	入力	返される内容
whoami	（なし）	認証されたユーザーまたはトークンの ID（GET /auth/）。
list_organizations	（なし）	トークンがアクセスできる組織。
list_projects	organization_slug（必須）	組織内のプロジェクト。
get_project	organization_slug、project_slug（必須）	1 つのプロジェクトの詳細。
list_releases	organization_slug、project_slug（必須）	プロジェクトのリリース。
search_issues	organization_slug（必須）、project_slug、query、limit（任意）	Sentry の検索クエリに一致するイシュー。プロジェクトが指定されている場合は、プロジェクトのイシュ―エンドポイントを使用します。
get_issue	issue_id（必須）	1 つのイシューの詳細。
get_issue_event	issue_id（必須）、event_id（任意、デフォルトは latest）	イシューに属する 1 つのイベント。
update_issue	issue_id（必須）、status、resolved_in_next_release、assigned_to、has_seen、is_bookmarked、is_subscribed（任意）	更新されたイシュー。指定されたフィールドのみ送信されます。
list_issue_comments	issue_id（必須）	イシューのコメント（メモ）。
create_issue_comment	issue_id、text（必須）	作成されたコメント。

API 呼び出しに失敗した場合、HTTP ステータスと、Sentry が提供している場合は detail メッセージを含むツールエラーとして報告されます。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。