# MCP > Codex、Claude Code、Cursor を Proxyman MCP に接続すると、AI アシスタントからキャプチャした HTTP/HTTPS 通信を確認したり、デバッグルールを作成したりできます。 Proxyman MCP は、AI アシスタントをお使いのコンピュータで動作している Proxyman macOS アプリに接続します。キャプチャしたリクエストとレスポンスの確認、障害の調査、デバッグルールの作成に使えます。AI アシスタントに分析を依頼する前に、Proxyman を開いたまま、調査したい通信をキャプチャしておいてください。 ## 1. Proxyman MCP とは {#1-what-is-proxyman-mcp} **Proxyman MCP**（Model Context Protocol）は、AI アシスタント（Codex、Claude Code、Cursor など、MCP に対応したツール）が Proxyman macOS アプリと直接やり取りできるようにする機能です。AI は HTTP 通信の確認、デバッグルールの作成、Proxyman の操作を、すべて自然な言葉による会話で行えます。 アーキテクチャは、次の 2 つのコンポーネントで構成されています。 * **MCP HTTP Server** - Proxyman アプリ内で localhost 上に動作し、トークンベースの認証を行います * **MCP CLI Server** - AI ツールが接続する stdio ベースの MCP サーバーで、コマンドを Proxyman に転送します > **備考:** AI エージェント向けの [Proxyman SKILL.md](https://proxyman.com/docs/ja/skill-md) もご覧ください。 ### ✅ プロンプトの例 {#-example-prompts} * api.example.com 宛ての直近 10 件の API リクエストを表示してください * /api/users への POST リクエストすべてに対するブレークポイントを作成してください * 失敗したリクエストを cURL コマンドとしてエクスポートしてください * \*.stripe.com の SSL Proxying を有効にしてください * Scripting の新しいスクリプトを作成し、ステータスコード、ヘッダー、ボディを変更してください * 指定した URL で Map Local と Breakpoint ツールを作成してください ![Proxyman MCP を使い、クエリを変更してヘッダーを追加し、ステータスを 301 に設定する Scripting ルールを作成している Claude](https://proxyman.com/docs/assets/Screenshot%202026-03-16%20at%2011.20.29.jpg) _Proxyman MCP で Scripting ルールを作成_ ## 2. メリット {#2-benefits}
メリット説明
AI によるデバッグAI に、キャプチャした通信の分析、特定のリクエストの検索、API レスポンスの説明を依頼できます
ハンズフリーのルール作成会話を通じて、ブレークポイントや Map Local、Map Remote のルールを作成できます
作業の効率化作業を切り替えることなく、cURL コマンドのエクスポート、フローのフィルタリング、セッションの管理ができます
安全な設計localhost でのみ動作するサーバーで、セッションごとのトークン認証を使用します
IDE 連携Codex、Claude Code、Cursor など、MCP に対応したツールで使えます
## 3. Proxyman MCP の追加方法 {#3-how-to-add-proxyman-mcp} 1. **Proxyman で MCP を有効化** * Proxyman → Settings → MCP Tab を開きます * **Enable MCP Server** をオンにして、MCP サーバーを起動します 2. **MCP クライアントを選択します:** Proxyman の Settings → MCP で **Codex** または **Claude Code** を選択し、**Copy Command** を使用します。**Cursor** の場合は **Manual** を選択し、表示された設定を Cursor の MCP 設定に追加します。 3. お使いのクライアントとインストール方法に応じて、次の設定を使用してください。Proxyman が生成するコマンドは、インストールされたアプリのパスを使用するため、以下の例と異なる場合があります。通常のデバッグでは、**Redact Sensitive Data Before Sending to AI** をオンのままにしてください。 ![Enable MCP Server がオンで、Claude Code、Codex、Manual のタブ、Copy ボタン、Redact Sensitive Data が表示された Proxyman の MCP 設定](https://proxyman.com/docs/assets/proxyman-settings-mcp-tab.jpg) _設定の MCP タブ_ ### Codex {#codex} * 通常版: ```bash codex mcp add proxyman -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server" ``` * Setapp 版: ```bash codex mcp add proxyman -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server" ``` ### Claude Code {#claude-code} * 通常版: ```bash claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server" ``` * Setapp 版: ```bash claude mcp add proxyman --transport stdio -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server" ``` ### Manual {#manual} Cursor やその他の MCP クライアントの場合は、Proxyman の **Manual** タブに表示される設定を、クライアントの MCP 設定に追加してください。インストールされている Proxyman アプリに対応する設定を選択します。次の例は `mcpServers` のエントリーです。 * 通常版: ```json { "mcpServers": { "proxyman": { "command": "/Applications/Proxyman.app/Contents/MacOS/mcp-server" } } } ``` * Setapp 版 ```json { "mcpServers": { "proxyman": { "command": "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server" } } } ``` 4. **Proxyman MCP を使い始める** * Proxyman が起動していることを確認します * AI アシスタントに Proxyman の操作を依頼します。例: 「api.example.com への最新のリクエストを表示してください。」 * クライアントが Proxyman を見つけられない場合は、MCP が有効になっていること、設定したアプリのパスが正しいことを確認してから、クライアントに再接続してください。接続できてもフローが表示されない場合は、新しいリクエストを送信し、[通信が表示されない場合のチェックリスト](https://proxyman.com/docs/ja/troubleshooting/i-couldnt-see-any-traffics-on-proxyman)を確認してください。 ## 4. 利用可能なツール {#4-available-tools} 以下の表は主なツールの一覧です。MCP クライアントには、インストールされている Proxyman のバージョンで利用可能なツールの全一覧が表示されます。その他のツールについては、[変更履歴](#changelogs)をご覧ください。 ### 読み取り専用ツール {#read-only-tools} | ツール | 説明 | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | | `get_version` | Proxyman のバージョンとビルド番号を返します | | `get_proxy_status` | 記録の状態、プロキシポート、SSL Proxying の状態を返します | | `get_flows` | キャプチャした HTTP/HTTPS フローを一覧表示します。オプションのフィルタ（`limit`、`host_filter`、`method_filter`、`status_filter`）を指定できます | | `get_flow_detail` | 特定のフローの詳細（ヘッダー、ボディのプレビュー、クエリパラメータ、Cookie を含む）を返します | | `list_rules` | すべてのデバッグルール（ブレークポイント、Map Local、Map Remote、Block List）を一覧表示します | | `get_ssl_proxying_list` | SSL Proxying の対象ドメインと除外ドメインの一覧を返します | | `get_certificate_status` | ルート証明書のインストール状態を返します | ### 書き込みツール {#write-tools} | ツール | 説明 | 必須パラメータ | | ----------------------- | ------------------------------------------------------- | -------------------- | | `create_breakpoint` | 一致するリクエストを一時停止して確認するブレークポイントを作成します | `url`（パターン） | | `create_map_local` | 一致する URL に対してカスタムレスポンスを返します | `url`（パターン） | | `create_map_remote` | リクエストを別の URL にリダイレクトします | `from_url`、`to_url` | | `create_blacklist` | URL パターンに一致するリクエストをブロックします | `url`（パターン） | | `create_scripting_rule` | カスタム JavaScript を使う Scripting ルールを作成します | `url`、`script_content` | | `enable_ssl_proxying` | ドメインの HTTPS 復号を有効にします | `domain` | ### セッション制御 {#session-control} | ツール | 説明 | | ------------------ | ------------------------------------------ | | `clear_session` | 現在のセッションでキャプチャしたフローをすべて消去します | | `toggle_recording` | 通信の記録を開始または停止します | ### フロー操作 {#flow-operations} | ツール | 説明 | | ------------------ | ----------------------------------------------------------------------------------------------------------------------- | | `export_flow_curl` | キャプチャしたリクエストを、そのまま実行できる cURL コマンドとしてエクスポートします | | `filter_flows` | 複数の条件（url、host、method、status、headers、body）による高度なフィルタリングを行います。AND と OR の組み合わせに対応しています | ### アプリの制御 {#app-control} | ツール | 説明 | | --------------- | ------------------------------------ | | `open_proxyman` | Proxyman が起動していない場合に起動します | | `quit_proxyman` | Proxyman アプリを終了します | *** ## 変更履歴 {#changelogs} ### MCP v3（Proxyman macOS 6.8.0 以降） {#mcp-v3-proxyman-macos--680} | 名前 | 説明 | | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | | get\_version | 現在の Proxyman macOS アプリのバージョンとビルド番号を取得します | | get\_proxy\_status | 記録の状態、ポート番号、SSL Proxying の状態を含め、現在のプロキシの状態を取得します | | get\_flows | Proxyman のアクティブなセッションのデータソースから、最近の HTTP/HTTPS フローを取得します | | get\_flow\_detail | 特定のフローの詳細情報（ヘッダー、ボディ、クエリパラメータ、Cookie を含む）を取得します | | list\_rules | 有効なすべてのデバッグルール（ブレークポイント、Map Local、Map Remote、Block List、Scripting、DNS Spoofing、Network Conditions、Allow List）を一覧表示します | | get\_ssl\_proxying\_list | 有効化の状態とドメイン一覧を含め、現在の SSL Proxying の設定を取得します | | create\_breakpoint | URL パターンに一致するリクエストやレスポンスを一時停止して確認・変更する、新しいブレークポイントルールを作成します | | create\_map\_local | 一致するリクエストに対してカスタムレスポンスを返す Map Local ルールを作成します | | create\_map\_remote | リクエストを別の URL にリダイレクトする Map Remote ルールを作成します | | create\_blacklist | URL パターンに一致するリクエストをブロックする Block List ルールを作成します | | create\_scripting\_rule | カスタム JavaScript でリクエストやレスポンスを変更する Scripting ルールを作成します | | enable\_ssl\_proxying | 特定のドメインで SSL Proxying を有効にし、HTTPS 通信を復号します | | clear\_session | 現在のセッションでキャプチャしたフローをすべて消去します | | toggle\_recording | HTTP 通信の記録を開始または停止します | | export\_flow\_curl | キャプチャした HTTP リクエストを cURL コマンドとしてエクスポートします | | filter\_flows | 高度なフィルタ条件を使って、キャプチャした HTTP/HTTPS フローをフィルタリングします | | get\_certificate\_status | Proxyman のルート証明書の現在の状態を取得します | | install\_certificate | Proxyman のルート CA 証明書をインストールし、信頼します | | uninstall\_certificate | キーチェーンから Proxyman のルート CA 証明書を削除します | | inject\_terminal | Proxyman のプロキシ環境変数を設定した状態で、ターミナルアプリを起動します | | get\_terminal\_manual\_command | プロキシの環境変数を手動で設定するための bash の source コマンドを取得します | | answer\_setup\_question | iOS、Android、ブラウザなどで HTTPS をキャプチャする方法に関するセットアップの質問に答えます | | search\_docs | Proxyman に内蔵されているセットアップとトラブルシューティングのドキュメントの索引を検索します | | list\_setup\_workflows | Proxyman MCP がガイドできる、対応済みのセットアップ手順の一覧を表示します | | list\_popular\_workflows | Proxyman が選定したランキングに基づき、人気のセットアップ手順を一覧表示します | | open\_proxyman\_screen | macOS アプリで特定の Proxyman ガイドまたはセットアップ画面を開きます | | run\_guided\_setup | ブラウザや Android エミュレータ向けに、Proxyman でワンクリックの自動設定を実行します | | list\_reverse\_proxies | 設定済みの Reverse Proxy のエントリーを一覧表示します | | create\_reverse\_proxy | localhost またはカスタムのローカルポートへのルーティング用に Reverse Proxy のエントリーを作成します | | generate\_code | キャプチャした HTTP フローから、18 以上の言語・フレームワークのコードを生成します | | create\_dns\_spoofing | ホスト名を別の IP アドレスにリダイレクトする DNS Spoofing ルールを作成します | | list\_dns\_spoofing | すべての DNS Spoofing ルールと、その有効化の状態を一覧表示します | | update\_dns\_spoofing | 既存の DNS Spoofing ルールを更新します | | get\_external\_proxy | 現在の External Proxy（上位プロキシ）の設定を取得します | | set\_external\_proxy | 特定のプロトコル種別に対して External Proxy の設定を行います | | toggle\_no\_caching | No Caching 機能のオン／オフを切り替えます（キャッシュ関連のヘッダーを削除します） | | inject\_electron | Proxyman のプロキシ設定を適用した状態で Electron アプリを起動します | | open\_proxyman | Proxyman macOS アプリを起動します | | quit\_proxyman | Proxyman macOS アプリを終了します | ### MCP v2（Proxyman v6.7.0 以降） {#mcp-v2-proxyman--v670} * iOS、Android、ブラウザ、ターミナル、VPN、localhost、サードパーティ製ライブラリをカバーする内蔵ナレッジベース * 新しいコマンド: answer\_setup\_question、search\_docs、list\_setup\_workflows、open\_proxyman\_screen、run\_guided\_setup、create\_reverse\_proxy * チャットクライアント向けの MCP リソースとプロンプトテンプレート * Reverse Proxy の作成と一覧表示に対応 ## セキュリティ {#security} * サーバーは `127.0.0.1` にのみバインドされ、ネットワークには公開されません * セッションごとの暗号学的トークンを `~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json` に保存します * ハンドシェイクファイルのパーミッションは `0600` です（所有者のみアクセス可能） * 機密データ（認証トークン、パスワード、API キー）は、レスポンス内で自動的にマスクされます ## 詳細情報 {#learn-more} * [Codex と Claude Code で Proxyman MCP を使う方法](https://proxyman.com/posts/how-to-use-proxyman-mcp-with-codex-and-claude-code)