Reason MCP Server

Reason MCP Server とは？

Reason MCP Server は Reason 公式のホスト型エンドポイントで、Claude Code、Codex、その他の MCP クライアントから自律型 AI ソフトウェアエンジニア Reason を操作できます。コーディングセッションを開始し、Reason にメッセージを送り、作成された pull request を追跡できます。

Reason は Reason Machines による GitHub 向けのクラウドコーディングエージェントです。リポジトリを接続して issue を割り当てると、Reason のエージェントが画面録画、ログ、レビューしやすい diff といった根拠付きの pull request を作成します。Reason の MCP サーバーは 1 つだけで、MCP クライアントに Reason の HTTP API と同じ操作を提供します。各ツールは 1 つの API 操作に対応し、接続のスコープで制限され、1 つのワークスペースに紐づきます。

Reason MCP Server の使い方

サーバーは Streamable HTTP トランスポートを使用し、URL は次のとおりです。

https://mcp.reasonmachines.com/mcp

Reason のアカウントが必要です。サインイン方法は 2 つあります。

• OAuth（対話的な利用に推奨）：クライアントは動的クライアント登録で自身を登録するため、client ID や secret は不要です。ブラウザが開き、Reason にサインインしてワークスペースを 1 つ選びます。クライアントは 1 時間有効なアクセストークンをリフレッシュトークンで更新します。未認証のリクエストは WWW-Authenticate ヘッダー付きの 401 を返しますが、これはサインインの開始であり、エラーではありません。
• API キー（CI やブラウザのない環境向け）：Reason の Settings > API（reasonmachines.com/customize?tab=api）でキーを作成し、Authorization: Bearer <key> として送信します。

Claude Code

claude mcp add --transport http reason https://mcp.reasonmachines.com/mcp

その後、Claude Code で /mcp を実行し、reason を選んでサインインします。ブラウザがない場合は、代わりにキーを渡します。

claude mcp add --transport http reason https://mcp.reasonmachines.com/mcp --header "Authorization: Bearer $REASON_API_KEY"

Codex

Reason のドキュメントに記載された設定です。

codex mcp add reason --url https://mcp.reasonmachines.com/mcp
codex mcp login reason

Claude Desktop / claude.ai

URL に https://mcp.reasonmachines.com/mcp を指定してカスタムコネクタを追加します。client ID と secret は空のままにします。クライアントが自身を登録し、ブラウザを開いてサインインを求めます。

Cursor

~/.cursor/mcp.json またはプロジェクトの .cursor/mcp.json に記述します。

{
  "mcpServers": {
    "reason": {
      "url": "https://mcp.reasonmachines.com/mcp"
    }
  }
}

VS Code

.vscode/mcp.json に記述します。

{
  "servers": {
    "reason": {
      "type": "http",
      "url": "https://mcp.reasonmachines.com/mcp"
    }
  }
}

Reason は、GitHub リポジトリ reason-machines/reason-plugins で Claude Code と Codex 用の既製プラグインも公開しています。

Reason MCP Server の主な機能

• Reason Machines が運営する公式サーバーで、Reason の HTTP API と同じ操作を提供します。
• 動的クライアント登録と PKCE を使う OAuth、またはヘッドレス用途向けの Reason API キー。
• スコープに基づくアクセス：接続にはスコープで許可されたツールだけが表示されます（例：run、sessions:read、repos:read、org:read）。特定のスコープを要求しない OAuth クライアントには、ssh:write 以外のすべてのスコープが付与されます。
• 接続ごとに 1 つのワークスペースなので、ツールは組織 ID を受け取りません。
• 呼び出しが返った後も実行を続けるセッションを開始し、その状態と結果をポーリングできます。
• 名前付きの Reason にメッセージを送って返信を読み、Reason の作成、更新、アーカイブも行えます。
• トークンの対象（audience）は別々です。HTTP API 用に発行されたトークンは MCP の URL では使えず、その逆も同様です。

Reason MCP Server のユースケース

• エディタからのタスクの引き渡し：「Reason のセッションを開始して、不安定な auth テストを修正し、回帰テストを追加して PR を作成して。」
• 進行中の作業の確認：「最近の Reason セッションを一覧にして、まだ実行中のものを教えて。」
• 結果のフォローアップ：「直前のセッションの結果を取得して、pull request のリンクを教えて。」
• 名前付き Reason との対話：「バックエンド担当の Reason に夜間エクスポートが遅い理由を聞いて、返信を読み上げて。」
• CI からの Reason の実行：API キーと範囲を絞った接続を使い、パイプラインがブラウザなしでセッションを作成できるようにします。

Reason のドキュメントでは、getSelf（接続が持つスコープも表示）か listSessions から始めることを勧めています。createSession はバックグラウンドで作業を開始するので、status が running でなくなるまで getSession をポーリングし、outcome を確認します。Reason にメッセージを送るには、listReasons で見つけ、openReasonConversation で会話の session_id を取得し、sendSessionMessage で送信して、listSessionConversation で返信を読みます。

Reason MCP Server のトラブルシューティング

• missing_bearer を伴う 401：これは正常な最初の応答で、クライアントがまだサインインしていない状態です。クライアントのサインイン手順を実行してください。
• GET で 405：サーバーは POST のみに応答し、イベントストリームはありません。
• mcp_transport_retired を伴う 410：古い /mcp/ara のアドレスを使っています。https://mcp.reasonmachines.com/mcp を使ってください。
• ツールが見当たらない：表示されるのはスコープで許可されたツールだけで、tools/list は 1 ページあたり 30 個のツールを返します。nextCursor をたどってください。