Proxyman MCP
公式Proxyman MCPは、AIが自然言語での会話を通じてHTTPトラフィックを検査し、デバッグルールを作成し、Proxymanを制御できるようにします。
Proxyman MCPで何ができますか?
Proxyman MCP lets AI assistants inspect captured HTTP/HTTPS traffic and create debugging rules in the Proxyman macOS app.
- Inspect captured flows — List recent requests with filters for host, method, and status, then pull headers, bodies, and cookies for a specific flow.
- Create debugging rules — Add breakpoints, Map Local, Map Remote, blacklist, or JavaScript scripting rules for a given URL pattern.
- Export requests as cURL — Turn a captured request into a runnable cURL command.
- Enable HTTPS decryption — Turn on SSL proxying for a domain and check the root certificate status.
- Control the session — Start or stop recording, clear captured flows, and launch or quit Proxyman.
ドキュメント
MCP
Codex、Claude Code、または Cursor を Proxyman MCP に接続して、キャプチャした HTTP/HTTPS トラフィックを調査し、AI アシスタントからデバッグルールを作成できます。
Proxyman MCP は、コンピューター上で実行中の Proxyman macOS アプリに AI アシスタントを接続します。キャプチャしたリクエストとレスポンスの調査、障害の原因究明、デバッグルールの作成に使用できます。調査したいトラフィックをキャプチャする前に Proxyman を起動し、アシスタントに分析を依頼してください。
ヒント: Proxyman 26.6.0 以降で利用できる新機能:ヘッドレスモード。エージェントはウィンドウ、Dock アイコン、ダイアログを表示せずに Proxyman を起動し、HTTPS を自動でキャプチャして復号します。
1. 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 もご覧ください。
✅ プロンプトの例
- api.example.com への直近 10 件の API リクエストを表示して
- /api/users へのすべての POST リクエストにブレークポイントを作成して
- 失敗したリクエストを cURL コマンドとしてエクスポートして
- *.stripe.com の SSL プロキシを有効にして
- ステータスコード、ヘッダー、本文を変更する新しい Script を作成して
- 指定した URL で Map Local と Breakpoint Tools を作成して

Proxyman MCP で Scripting ルールを作成
2. メリット
| メリット | 説明 |
|---|---|
| AI を活用したデバッグ | AI にキャプチャしたトラフィックの分析、特定のリクエストの検索、API レスポンスの説明を依頼できます |
| 手間のかからないルール作成 | 会話を通じてブレークポイント、Map Local/Remote ルールを作成できます |
| ワークフローの高速化 | コンテキストを切り替えずに cURL コマンドのエクスポート、フローのフィルタリング、セッションの管理ができます |
| 設計段階からのセキュリティ | セッションごとのトークン認証を備えた localhost 専用サーバー |
| IDE との連携 | Codex、Claude Code、Cursor、その他の MCP 対応ツールで動作します |
3. Proxyman MCP の追加方法
- Proxyman で MCP を有効にする
- Proxyman → Settings → MCP Tab を開きます
- Enable MCP Server をオンにして MCP Server を起動します
- MCP クライアントを選択する: Proxyman Settings → MCP で Codex または Claude Code を選択し、Copy Command を使用します。Cursor の場合は Manual を選択し、表示された設定を Cursor の MCP 設定に追加します。
- クライアントとインストール方法に応じて、以下の設定を使用します。Proxyman が生成するコマンドには、インストール済みアプリのパスが使われます。このパスは以下の例と異なる場合があります。通常のデバッグでは、Redact Sensitive Data Before Sending to AI をオンにしておいてください。

Settings の MCP タブ
Codex
- Production Version:
codex mcp add proxyman -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
- Setapp Version:
codex mcp add proxyman -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
Claude Code
- Production Version:
claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
- Setapp Version:
claude mcp add proxyman --transport stdio -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
Manual
Cursor やその他の MCP クライアントでは、Proxyman の Manual タブにある設定をクライアントの MCP 設定に追加します。インストール済みの Proxyman アプリに対応する設定を選択してください。以下の例では mcpServers エントリを示しています。
- Production Version:
{
"mcpServers": {
"proxyman": {
"command": "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
}
}
}
- Setapp Version
{
"mcpServers": {
"proxyman": {
"command": "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
}
}
}
- Proxyman MCP の使用を開始する
- Proxyman が起動していることを確認します
- AI アシスタントに Proxyman の操作を依頼します。例:「api.example.com への最新のリクエストを表示して。」
- クライアントが Proxyman を見つけられない場合は、MCP が有効になっていることと、設定されたアプリのパスが正しいことを確認してから、クライアントを再接続してください。接続できてもフローが見つからない場合は、新しいリクエストを送信し、トラフィックが見つからない場合のチェックリストを確認してください。
ヘッドレスモード
Proxyman 26.6.0 以降では、コマンドの末尾に --headless を追加します。例:
claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server" --headless
エージェントは最初のツール呼び出し時に、ウィンドウ、Dock アイコン、ダイアログを表示せずに Proxyman を起動します。エージェントの処理が終わると Proxyman は終了します。Settings → MCP を有効にする必要はありません。generate_only モードで install_certificate を使用すると、エージェントはダイアログを表示せずに証明書を作成し、curl、Node.js、Python、Chrome など、エージェントが実行するクライアントの HTTPS を復号します。ヘッドレスモードをご覧ください。
4. 利用可能なツール
以下の表に、よく使われるツールを示します。MCP クライアントには、インストール済みの Proxyman バージョンで利用できるすべてのツールが表示されます。その他のツールについては、変更履歴をご覧ください。
読み取り専用ツール
| Tool | Description |
|---|---|
get_version | Proxyman のバージョンとビルド番号を返します |
get_proxy_status | 録画状態、プロキシポート、SSL プロキシの状態を返します |
get_flows | オプションのフィルター(limit、host_filter、method_filter、status_filter)を指定して、キャプチャした HTTP/HTTPS フローを一覧表示します |
get_flow_detail | ヘッダー、本文のプレビュー、クエリパラメーター、Cookie を含む、指定したフローの詳細を返します |
list_rules | すべてのデバッグルール(breakpoint、map local、map remote、blacklist)を一覧表示します |
get_ssl_proxying_list | SSL プロキシの対象ドメインと除外ドメインのリストを返します |
get_certificate_status | ルート証明書のインストール状態を返します |
書き込みツール
| Tool | Description | Required Params |
|---|---|---|
create_breakpoint | 条件に一致するリクエストを一時停止して調査するブレークポイントを作成します | url (pattern) |
create_map_local | 条件に一致する URL にカスタムレスポンスを返します | url (pattern) |
create_map_remote | リクエストの送信先 URL を別の URL にリダイレクトします | from_url、to_url |
create_blacklist | URL パターンに一致するリクエストをブロックします | url (pattern) |
create_scripting_rule | カスタム JavaScript を使った Scripting ルールを作成します | url、script_content |
enable_ssl_proxying | ドメインの HTTPS 復号を有効にします | domain |
セッション制御
| Tool | Description |
|---|---|
clear_session | 現在のセッションからキャプチャしたすべてのフローを消去します |
toggle_recording | トラフィックの記録を開始または停止します |
フロー操作
| Tool | Description |
|---|---|
export_flow_curl | キャプチャしたリクエストを、実行可能な cURL コマンドとしてエクスポートします |
filter_flows | 複数の条件(url、host、method、status、headers、body)を使った高度なフィルタリングに対応し、AND/OR の組み合わせをサポートします |
アプリ制御
| Tool | Description |
|---|---|
open_proxyman | Proxyman が起動していない場合に起動します。headless: true を指定すると、ウィンドウを表示せずに起動します(ヘッドレスモード、Proxyman 26.6.0 以降) |
quit_proxyman | Proxyman アプリを終了します |
変更履歴
MCP v3 (Proxyman macOS ≥ 6.8.0)
| Name | 説明 |
|---|---|
| get_version | Proxyman macOS アプリの現在のバージョンとビルド番号を取得します |
| get_proxy_status | 録画状態、ポート番号、SSL プロキシの状態など、現在のプロキシ状態を取得します |
| get_flows | Proxyman のアクティブなセッションデータソースから最近の HTTP/HTTPS フローを取得します |
| get_flow_detail | ヘッダー、本文、クエリパラメーター、Cookie など、特定のフローの詳細情報を取得します |
| list_rules | 有効なデバッグルール(ブレークポイント、Map Local、Map Remote、ブラックリスト、スクリプト、DNS スプーフィング、ネットワーク状態、ホワイトリスト)をすべて一覧表示します |
| get_ssl_proxying_list | 有効状態やドメインリストなど、現在の SSL Proxying 設定を取得します |
| create_breakpoint | URL パターンに一致するリクエストまたはレスポンスを一時停止して検査・変更する、新しいブレークポイントルールを作成します |
| create_map_local | 一致するリクエストにカスタムレスポンスを返す Map Local ルールを作成します |
| create_map_remote | リクエストをある URL から別の URL にリダイレクトする Map Remote ルールを作成します |
| create_blacklist | URL パターンに一致するリクエストをブロックするブラックリストルールを作成します |
| create_scripting_rule | リクエストやレスポンスを変更するカスタム JavaScript を使用したスクリプトルールを作成します |
| enable_ssl_proxying | HTTPS トラフィックを復号するため、特定のドメインで SSL Proxying を有効にします |
| 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 | 設定済みのリバースプロキシエントリーを一覧表示します |
| create_reverse_proxy | localhost またはカスタムローカルポートのルーティング用にリバースプロキシエントリーを作成します |
| generate_code | キャプチャした HTTP フローから、18 以上の言語・フレームワーク向けのコードを生成します |
| create_dns_spoofing | ホスト名を別の IP アドレスにリダイレクトする DNS スプーフィングルールを作成します |
| list_dns_spoofing | すべての DNS スプーフィングルールとその有効状態を一覧表示します |
| update_dns_spoofing | 既存の DNS スプーフィングルールを更新します |
| get_external_proxy | 現在の外部プロキシ(アップストリームプロキシ)設定を取得します |
| set_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)
- iOS、Android、ブラウザー、ターミナル、VPN、localhost、サードパーティライブラリを網羅する組み込みナレッジベース
- 新しいコマンド: answer_setup_question、search_docs、list_setup_workflows、open_proxyman_screen、run_guided_setup、create_reverse_proxy
- チャットクライアント向けの MCP リソースとプロンプトテンプレート
- リバースプロキシの作成・一覧表示に対応
セキュリティ
- サーバーは
127.0.0.1のみにバインドします(ネットワークには公開されません) - セッションごとの暗号化トークンは
~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.jsonに保存されます - ハンドシェイクファイルの権限は
0600です(所有者のみアクセス可能) - 機密データ(認証トークン、パスワード、API キー)はレスポンス内で自動的にマスキングされます