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 を作成して

Claude using Proxyman MCP to create a Scripting rule that changes a query, adds a header and sets status 301

Proxyman MCP で Scripting ルールを作成

2. メリット

メリット説明
AI を活用したデバッグAI にキャプチャしたトラフィックの分析、特定のリクエストの検索、API レスポンスの説明を依頼できます
手間のかからないルール作成会話を通じてブレークポイント、Map Local/Remote ルールを作成できます
ワークフローの高速化コンテキストを切り替えずに cURL コマンドのエクスポート、フローのフィルタリング、セッションの管理ができます
設計段階からのセキュリティセッションごとのトークン認証を備えた localhost 専用サーバー
IDE との連携Codex、Claude Code、Cursor、その他の MCP 対応ツールで動作します

3. Proxyman MCP の追加方法

  1. Proxyman で MCP を有効にする
    • Proxyman → Settings → MCP Tab を開きます
    • Enable MCP Server をオンにして MCP Server を起動します
  2. MCP クライアントを選択する: Proxyman Settings → MCP で Codex または Claude Code を選択し、Copy Command を使用します。Cursor の場合は Manual を選択し、表示された設定を Cursor の MCP 設定に追加します。
  3. クライアントとインストール方法に応じて、以下の設定を使用します。Proxyman が生成するコマンドには、インストール済みアプリのパスが使われます。このパスは以下の例と異なる場合があります。通常のデバッグでは、Redact Sensitive Data Before Sending to AI をオンにしておいてください。

Proxyman MCP settings with Enable MCP Server on, Claude Code, Codex and Manual tabs, Copy, and Redact Sensitive Data

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"
    }
  }
}
  1. 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 バージョンで利用できるすべてのツールが表示されます。その他のツールについては、変更履歴をご覧ください。

読み取り専用ツール

ToolDescription
get_versionProxyman のバージョンとビルド番号を返します
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_listSSL プロキシの対象ドメインと除外ドメインのリストを返します
get_certificate_statusルート証明書のインストール状態を返します

書き込みツール

ToolDescriptionRequired Params
create_breakpoint条件に一致するリクエストを一時停止して調査するブレークポイントを作成しますurl (pattern)
create_map_local条件に一致する URL にカスタムレスポンスを返しますurl (pattern)
create_map_remoteリクエストの送信先 URL を別の URL にリダイレクトしますfrom_url、to_url
create_blacklistURL パターンに一致するリクエストをブロックしますurl (pattern)
create_scripting_ruleカスタム JavaScript を使った Scripting ルールを作成しますurl、script_content
enable_ssl_proxyingドメインの HTTPS 復号を有効にしますdomain

セッション制御

ToolDescription
clear_session現在のセッションからキャプチャしたすべてのフローを消去します
toggle_recordingトラフィックの記録を開始または停止します

フロー操作

ToolDescription
export_flow_curlキャプチャしたリクエストを、実行可能な cURL コマンドとしてエクスポートします
filter_flows複数の条件(url、host、method、status、headers、body)を使った高度なフィルタリングに対応し、AND/OR の組み合わせをサポートします

アプリ制御

ToolDescription
open_proxymanProxyman が起動していない場合に起動します。headless: true を指定すると、ウィンドウを表示せずに起動します(ヘッドレスモード、Proxyman 26.6.0 以降)
quit_proxymanProxyman アプリを終了します

変更履歴

MCP v3 (Proxyman macOS ≥ 6.8.0)

Name説明
get_versionProxyman macOS アプリの現在のバージョンとビルド番号を取得します
get_proxy_status録画状態、ポート番号、SSL プロキシの状態など、現在のプロキシ状態を取得します
get_flowsProxyman のアクティブなセッションデータソースから最近の HTTP/HTTPS フローを取得します
get_flow_detailヘッダー、本文、クエリパラメーター、Cookie など、特定のフローの詳細情報を取得します
list_rules有効なデバッグルール(ブレークポイント、Map Local、Map Remote、ブラックリスト、スクリプト、DNS スプーフィング、ネットワーク状態、ホワイトリスト)をすべて一覧表示します
get_ssl_proxying_list有効状態やドメインリストなど、現在の SSL Proxying 設定を取得します
create_breakpointURL パターンに一致するリクエストまたはレスポンスを一時停止して検査・変更する、新しいブレークポイントルールを作成します
create_map_local一致するリクエストにカスタムレスポンスを返す Map Local ルールを作成します
create_map_remoteリクエストをある URL から別の URL にリダイレクトする Map Remote ルールを作成します
create_blacklistURL パターンに一致するリクエストをブロックするブラックリストルールを作成します
create_scripting_ruleリクエストやレスポンスを変更するカスタム JavaScript を使用したスクリプトルールを作成します
enable_ssl_proxyingHTTPS トラフィックを復号するため、特定のドメインで SSL Proxying を有効にします
clear_session現在のセッションからキャプチャしたフローをすべて消去します
toggle_recordingHTTP トラフィックの記録を開始または停止します
export_flow_curlキャプチャした HTTP リクエストを cURL コマンドとしてエクスポートします
filter_flows高度なフィルター条件を使用して、キャプチャした HTTP/HTTPS フローを絞り込みます
get_certificate_statusProxyman のルート証明書の現在の状態を取得します
install_certificateProxyman のルート CA 証明書をインストールして信頼します
uninstall_certificateキーチェーンから Proxyman のルート CA 証明書を削除します
inject_terminalProxyman のプロキシ環境変数を設定してターミナルアプリを起動します
get_terminal_manual_commandプロキシ環境変数を手動で設定するための bash source コマンドを取得します
answer_setup_questioniOS、Android、ブラウザーなどから HTTPS をキャプチャする方法に関するセットアップの質問に回答します
search_docsProxyman に組み込まれたセットアップおよびトラブルシューティング用ドキュメントのインデックスを検索します
list_setup_workflowsProxyman MCP がユーザーを案内できる、サポート対象のセットアップワークフローを一覧表示します
list_popular_workflowsProxyman が厳選したフォールバックランキングを使用して、人気のセットアップワークフローを一覧表示します
open_proxyman_screenmacOS アプリで特定の Proxyman ガイドまたはセットアップ画面を開きます
run_guided_setupブラウザーまたは Android エミュレーター向けに、Proxyman でワンクリック自動化を実行します
list_reverse_proxies設定済みのリバースプロキシエントリーを一覧表示します
create_reverse_proxylocalhost またはカスタムローカルポートのルーティング用にリバースプロキシエントリーを作成します
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_cachingNo Caching 機能(キャッシュ関連ヘッダーを削除)を切り替えます
inject_electronProxyman のプロキシ設定を適用して Electron アプリを起動します
open_proxymanProxyman macOS アプリケーションを起動します
quit_proxymanProxyman 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 キー)はレスポンス内で自動的にマスキングされます

詳細情報