← ブログに戻る

Claude Desktop と Rockxy MCP サーバーの接続手順 — 3 分で完了

· 6 分で読めます

Rockxy 0.9.0 には Model Context Protocol (MCP) サーバーが組み込まれています。接続すれば Claude Desktop はキャプチャ済みの HTTP フローを読み取り、リクエストを再送信し、レスポンスの差分を取れるようになります。curl の出力をチャットに貼り付ける必要はありません。このガイドでは 3 分でできる設定手順と、Claude が実際にトラフィックでできることを紹介します。

Claude Desktop を HTTP トラフィックにつなぐ理由

HTTP デバッグはずっとコピペの問題でした。プロキシで失敗したリクエストを見つけ、ヘッダーとボディをコピーし、チャットやドキュメントに貼り付け、そのまわりに人間が読める質問を書く。コンテキストスイッチで時間を食います。しかもアシスタントには、自分が貼り付けた範囲しか見えません。

MCP はこれを逆にします。コピペせず、Claude にプロキシへの直接の経路を渡すのです。Claude は list_flows を呼び、必要なフローを読み、実際のバイト列を見ながら追加の質問を投げてきます。失敗したリクエストはもうスクリーンショットではなく、モデルが修正案を出したあとに再実行できるツール呼び出しになります。

2 つをつなげば、デバッグのループが縮まります。目の前で起きていることを普通の日本語で書けば、Claude は言い換えられたリクエストではなく本物のリクエストを読みます。Claude が修正を提案したら、そのまま変更後のリクエストを再送信して検証できます。アシスタントとプロキシが同じページに乗っていて、そのページはあなたの端末上にあります。Mac の外には何も出ていきません。

前提条件

  • macOS 14 (Sonoma) 以降。 Rockxy の MCP バイナリはユニバーサルビルド (Apple Silicon + Intel) です。
  • MCP 対応バージョンの Claude Desktop (2024 年後半以降のビルドであれば対応)。
  • Rockxy 0.9.0 以降。 それ以前のビルドには MCP サーバーが含まれていません。
  • 5 分の余裕。 実作業は 3 分ですが、初回起動時の Gatekeeper ダイアログのために余裕をとっておきます。

Step 1: Rockxy をインストールする

DMG を rockxy.io/ja/download からダウンロードし、マウントして Rockxy.app を /Applications にドラッグします。一度起動して macOS に信頼済みアプリとして登録させてください。

初回起動では Gatekeeper のダイアログが出ます。Rockxy は署名と公証済みなので「Rockxy を開く」のダイアログが表示されるはずです。もし「確認できません」というダイアログが出た場合は システム設定 → プライバシーとセキュリティ を開き、セキュリティセクションまでスクロールして このまま開く をクリックします。

Rockxy が動作している状態で、MCP バイナリは以下にあります。

/Applications/Rockxy.app/Contents/MacOS/rockxy-mcp

Step 3 でこのパスをそのまま使うので、手元に控えておいてください。

Step 2: Rockxy で MCP サーバーを有効化する

Rockxy → 設定 → MCP を開き (あるいは Cmd+, を押して MCP タブをクリックし)、Enable MCP Server をオンに切り替えます。

Rockxy の MCP サーバーは、MCP クライアントが必要なときに生成する子プロセスとして動作します。Claude Desktop とは標準入力と標準出力 (stdio) で通信するため、MCP トランスポート自体はネットワークソケットではありません。Rockxy は stdio を使わないクライアント向けに、ループバック限定のローカル HTTP ポートも併せて公開します。どちらの経路も Mac から出ません。

MCP が有効になると、Rockxy は 4 つのツールを公開します: list_flows、get_flow_detail、replay_request、diff_flows。各ツールは現在開いているセッションファイルに限定されるので、どのセッションを開いているかで Claude に見せる範囲を選べます。

各ツールについて簡単に説明します。list_flows は任意のフィルター (ホスト、メソッド、ステータス、時間範囲、件数上限) を受け取り、フローの要約の配列を返します。get_flow_detail は単一のフロー ID を受け取り、リクエスト全文 (ヘッダー、ボディ)、レスポンス全文 (ヘッダー、ボディ)、タイミング内訳 (DNS、TCP、TLS、TTFB、転送) を返します。replay_request はフロー ID と任意のオーバーライドを受け取り、元のホストに対してリクエストを再実行し、新しいフロー ID を返します。diff_flows は 2 つのフロー ID を受け取り、構造的な差分 (パス、ヘッダー、ボディフィールド) を返すので、Claude は 2 つの JSON を目で見比べずに変更点を要約できます。

Step 3: claude_desktop_config.json を編集する

Claude Desktop は MCP 設定を単一の JSON ファイルから読み込みます。

~/Library/Application Support/Claude/claude_desktop_config.json

ファイルがなければ新規作成します。すでに別の MCP サーバーが登録されている場合は、既存の mcpServers オブジェクトに Rockxy のブロックを追加してください。Rockxy だけを登録する最小構成はこうなります。

{
  "mcpServers": {
    "rockxy": {
      "command": "/Applications/Rockxy.app/Contents/MacOS/rockxy-mcp",
      "args": []
    }
  }
}

ファイルを保存します。この時点ではリロードは不要です。Claude Desktop は起動時にしか設定を読み直しません。

Step 4: Claude Desktop を再起動する

Cmd+Q で Claude Desktop を完全に終了します。ウィンドウを閉じるだけでは不十分で、アプリはバックグラウンドに残り続けます。バックグラウンドで動いているプロセスは設定を読み直しません。Launchpad か Spotlight から開き直してください。

Claude Desktop が起動すると、Rockxy MCP プロセスを子プロセスとして生成し、stdio で接続し、ツールマニフェストを読み込みます。Claude Desktop のチャット画面に小さなプラグのアイコンが表示されれば、MCP サーバーが接続されている合図です。

Step 5: 接続を確認する

Claude Desktop で新しいチャットを開き、こう送ります。

Rockxy がキャプチャした直近 5 件の HTTP フローを一覧表示してください。

期待される挙動は次のとおりです。Claude は list_flows ツールを limit=5 で呼び出します。チャットにはツール呼び出しのブロックが (通常は折りたたまれた状態で) 表示され、入出力の生データを確認できます。そのあと Claude はフローをテキストで要約します。メソッド、ホスト、パス、ステータス、サイズ。

一覧が空なら、まずトラフィックを発生させてください。Rockxy のシステムプロキシをオンにし、ブラウザのタブを開いてリロードします。そのうえで同じ質問を投げ直します。

トラブルシューティング

バイナリが見つからない。 Claude Desktop のログに command not found が出る、あるいは MCP のプラグが点灯しない場合は、設定ファイルのパスを見直します。正しいパスは常に /Applications/Rockxy.app/Contents/MacOS/rockxy-mcp です。Rockxy を ~/Applications に置いた場合はパスをそれに合わせてください。

Rockxy 側で MCP が有効になっていない。 設定で有効化していないと、MCP サーバーは stdio を受け付けても mcp_disabled エラーを返します。スイッチを入れてから Claude Desktop を再起動します。

ツールが認識されない。 プラグは点灯しているのに Claude が「そのツールは持っていません」と答える場合、Claude Desktop のデベロッパーコンソール (最近のビルドでは Cmd+Option+I) を開きます。claude_desktop_config.json の JSON パースエラーが典型的な原因です。カンマの抜け、末尾の余分なカンマ、ワープロからコピーしたスマートクォートなどが候補です。

Claude にトラフィックで何ができるか

接続したら、次のようなプロンプトを試してみてください。

  • 「/api/auth への直近のリクエストが失敗した理由は？」 — Claude は list_flows を呼び、ホストとパスで絞り込み、401 の詳細を取得し、WWW-Authenticate ヘッダーを読んで説明します。
  • 「直近の GraphQL mutation 2 件の差分を取って。」 — Claude はフローを一覧し、mutation 2 件を選び、diff_flows を呼び、どのフィールドが変わったかを要約します。
  • 「フロー 42 を Authorization ヘッダー Bearer eyJ... で再送信して。」 — Claude はオーバーライドを指定して replay_request を呼び、新しいレスポンスを読み、まだ 401 かどうかを教えてくれます。
  • 「このセッションで一番遅いエンドポイントは？」 — Claude はフロー一覧をたどり、各詳細からタイミングデータを取り、ランキングを作ります。

MCP サーバーのツール面はわずか 4 つで、これは意図した設計です。面が狭いほどモデルが扱いやすく、明示的に許可した操作の範囲にトラフィックを閉じ込められます。

知っておきたい挙動がひとつあります。ツール呼び出しはすべて、Claude Desktop のチャット内で折りたためるブロックとして表示されます。ブロックを展開すれば、モデルが送った正確な入力とツールが返した正確な出力が見えます。Claude が指示どおり動いているか不安なときは、ここを開けば答えがわかります。プロンプトがうまく動かないときのデバッグにも使えます。list_flows を正しいホストで絞れているか、get_flow_detail に間違ったフロー ID を渡していないかが目で見えるようになります。

次のステップ

配線が済んだら、面白いのはプロンプトの工夫です。Stripe webhook のケーススタディ (英語版) では実際のデバッグセッションを最初から最後まで追っています。トップページの MCP セクション には現在のツールリファレンスがあります。

Rockxy は AGPL-3.0 で無料かつオープンソースです。MCP サーバーのソースはアプリ本体と同じリポジトリにあるので、どのアシスタントにつなぐ前にも、何が公開されているかを正確に読めます。

Rockxy をダウンロード MCP ツールを見る