owl24-mcp

owl24-mcp

owl24 用の MCP サーバーです。発生した本番環境のエラーを、普段お使いのコーディングエージェント（Claude Code、Cursor、または MCP に対応したクライアント）に渡せます。エージェントがその項目を確保し、トレースとスタックトレースを読み取って修正を記述するため、開いたことのないファイルのスタックトレースを自分で読む必要はありません。

これは、REST と AGENTS.md を使ったワークフローに取って代わるものではありません。同じエンドポイントにアクセスするための、より簡易な方法です。AGENTS.md を使った CI ループがすでに機能しているなら、これは必要ありません。エディター内でエージェントと対話しながら作業するためのものです。

できること

ツール	説明
list_errors	重複を除いたエラーグループを一覧表示します。発生回数、初回／最終検出日時、キューの状態、AI レポートの有無を確認できます
queue_error	エラーグループをエージェントアクセス用キューに追加します（無料。AI は呼び出しません）
list_queue	キュー項目を一覧表示します。デフォルトでは未解決／未確保の項目が対象です
claim_error	キュー項目を確保し、同時にほかの処理が行われないようにします。課金が発生するのはこのときだけで、一度のみです（詳細は下記を参照）
get_trace	実際の証拠を取得します。1 つのトレースのスパン、ログ、スタックトレースを確認できます
get_rca_report	既存のキャッシュ済み AI 根本原因分析レポートを確認します（読み取り専用）
resolve_error	PR とフィンガープリントを記したメモを添えて、キュー項目を解決済みにします（無料。課金は発生しません）
count_open_items	軽量なポーリング用です。未解決項目の件数のみを取得し、一覧全体は取得しません
release_error	確保した項目を解決せずに手放します。追加料金は発生しません（確保時の課金がある場合、その課金はすでに発生しています）
extend_claim	引き続き作業中の項目について、確保の有効期限を延長します

意図的に対応していないこと： 新しい AI 根本原因分析の実行です。これは owl24 ダッシュボードで人が行う別個の有料操作です。このサーバーが独自の判断で AI-RCA クレジットを使用することはありません。get_rca_report は既存のレポートを読み取るだけです。レポートがない場合は、エージェントに AGENTS.md で案内している方法と同じく、get_trace のデータから調査してください。

課金： 一覧表示とキューへの追加は常に無料です。これまで一度も確保されていない項目に対して claim_error が成功した時点で、一度だけ少額の料金が発生します（現在の料金は料金ページをご確認ください）。解決時には課金されず、月ごとの上限もありません。修正せずに release_error を呼び出した場合や、確保の有効期限が切れた場合でも、料金は返金されません。ただし、同じ項目を後から再度確保しても、二度目の課金はありません。resolve_error 自体で課金されることはありません。実際に修正できたら resolve_error を使い、修正できなかった場合は release_error（こちらも呼び出し無料）を使って、次に項目を確保する人が正確な記録を確認できるようにしてください。

お客様のエージェントの構築、実行、ホスティングは行いません。このサーバーは、お客様ご自身のプロジェクト API キーを使用して、お客様のマシン上でローカルに実行されます。これは、このサーバーが利用する REST ワークフローと同じ信頼モデルです。

インストール

ご自身でインストールする必要はありません。ほとんどの MCP クライアントは、必要に応じて npx で実行します。

Claude Code

claude mcp add owl24 -e OWL24_API_KEY=your_api_key -- npx -y owl24-mcp

Cursor

MCP の設定に追加してください（Cursor Settings → MCP）。

{
  "mcpServers": {
    "owl24": {
      "command": "npx",
      "args": ["-y", "owl24-mcp"],
      "env": {
        "OWL24_API_KEY": "your_api_key"
      }
    }
  }
}

その他の MCP クライアントでも、同じ command／args／env の形式を使用できます。標準入出力経由で npx -y owl24-mcp を実行し、環境変数に OWL24_API_KEY を設定してください。

API キーは、owl24 ダッシュボードのプロジェクトページから取得できます。まずプロジェクトで Agent Access を有効にする必要があります。アカウント固有の API を通じて有効化してください。有効にするまで、ここにあるすべてのツールが 403 を返します。

環境変数

変数	必須	デフォルト
OWL24_API_KEY	はい	—
OWL24_API_BASE	いいえ	https://api.owl24.dev — セルフホスト／ローカルテスト時に上書きします

例

接続したら、Claude Code または Cursor で次のように尋ねます。

checkout-service で何が問題になっていますか？

モデルは list_errors({ serviceName: "checkout-service" }) を呼び出して結果を読み取り、最も問題のある項目についてすぐに get_trace を実行し、自ら修正を書き、PR を作成した後にメモを添えて resolve_error を実行できます。PR は必ず人間がレビューします。ここで何かがマージされることはありません。

ライセンス

MIT