Proxyman MCP

完全なドキュメント索引については、llms.txt を参照してください。ドキュメントページの Markdown 版は、ページ URL に .md を追加することで利用できます。このページは Markdown で利用できます。

MCP

1. Proxyman MCP とは？

Proxyman MCP (Model Context Protocol) は、AI アシスタント (Claude、Cursor、その他 MCP 互換ツール) が Proxyman macOS アプリと直接対話できるようにする機能です。AI が HTTP トラフィックを検査し、デバッグルールを作成し、Proxyman を制御することを、すべて自然言語での会話を通じて可能にします。

アーキテクチャは2つのコンポーネントで構成されています。

• MCP HTTP サーバー - トークンベースの認証を使用して、Proxyman アプリ内の localhost で実行されます
• MCP CLI サーバー - AI ツールが接続する stdio ベースの MCP サーバーで、コマンドを Proxyman に転送します

{% hint style="info" %} AI エージェント用の Proxyman SKILL.md をチェックしてください {% endhint %}

✅ プロンプト例

• api.example.com への最新の API リクエスト10件を表示して
• /api/users へのすべての POST リクエストに対するブレークポイントを作成して
• 失敗したリクエストを cURL コマンドとしてエクスポートして
• *.stripe.com の SSL プロキシを有効にして
• ステータスコード、ヘッダー、ボディを変更する新しいスクリプトを作成して
• 指定された URL で Map Local、ブレークポイントツールを作成して

2. 利点

利点	説明
AI によるデバッグ	キャプチャされたトラフィックの分析、特定のリクエストの検索、API レスポンスの説明を AI に依頼
ハンズフリーのルール作成	会話を通じてブレークポイント、マップローカル/リモートルールを作成
ワークフローの高速化	コンテキストを切り替えずに cURL コマンドのエクスポート、フローのフィルタリング、セッション管理を実行
設計によるセキュリティ	セッションごとのトークン認証を備えた localhost 専用サーバー
IDE 統合	Cursor やその他の MCP 互換ツールとシームレスに連携

3. Proxyman MCP の追加方法

1. Proxyman で MCP を有効にする
   • Proxyman → 設定 → MCP タブ を開く
   • MCP サーバーを有効にする を切り替えて MCP サーバーを起動
2. MCP クライアントを設定する (例: Cursor、Claude Desktop)
3. エージェントに Proxyman MCP を追加する:

Codex

• 製品版:

codex mcp add proxyman -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"

• Setapp 版:

codex mcp add proxyman -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"

Claude Code

• 製品版:

{% code overflow="wrap" %}

claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"

{% endcode %}

• Setapp 版:

{% code overflow="wrap" %}

claude mcp add proxyman --transport stdio -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"

{% endcode %}

手動

使用する AI エージェントに応じて、エージェント設定を編集し、Proxyman MCP を使用する必要があります。設定例 settings.json は次のとおりです。

• 製品版:

{
  "mcpServers": {
    "proxyman": {
      "command": "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
    }
  }
}

• Setapp 版

{
  "mcpServers": {
    "proxyman": {
      "command": "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
    }
  }
}

4. Proxyman MCP を使い始める

• Proxyman が実行中であることを確認する
• AI アシスタントに Proxyman との対話を依頼する

4. 利用可能なツール

読み取り専用ツール

ツール	説明
get_version	Proxyman のバージョンとビルド番号を返します
get_proxy_status	記録状態、プロキシポート、SSL プロキシ状態を返します
get_flows	オプションのフィルター (limit, host_filter, method_filter, status_filter) を使用して、キャプチャされた HTTP/HTTPS フローを一覧表示します
get_flow_detail	ヘッダー、ボディプレビュー、クエリパラメータ、Cookie を含む特定のフローの完全な詳細を返します
list_rules	すべてのデバッグルール (ブレークポイント、マップローカル、マップリモート、ブラックリスト) を一覧表示します
get_ssl_proxying_list	SSL プロキシの包含/除外ドメインリストを返します
get_certificate_status	ルート証明書のインストール状態を返します

書き込みツール

ツール	説明	必須パラメータ
create_breakpoint	一致するリクエストを一時停止/検査するためのブレークポイントを作成します	url (パターン)
create_map_local	一致する URL に対してカスタムレスポンスを返します	url (パターン)
create_map_remote	リクエストをある URL から別の URL にリダイレクトします	from_url, to_url
create_blacklist	URL パターンに一致するリクエストをブロックします	url (パターン)
enable_scripting_tool	スクリプトを作成
enable_ssl_proxying	ドメインの HTTPS 復号を有効にします	domain

セッション制御

ツール	説明
clear_session	現在のセッションからキャプチャされたすべてのフローをクリアします
toggle_recording	トラフィック記録を開始または停止します

フロー操作

ツール	説明
export_flow_curl	キャプチャされたリクエストを実行可能な cURL コマンドとしてエクスポートします
filter_flows	AND/OR の組み合わせをサポートする複数の条件 (URL、ホスト、メソッド、ステータス、ヘッダー、ボディ) を使用した高度なフィルタリング

アプリ制御

ツール	説明
open_proxyman	実行されていない場合、Proxyman を起動します
quit_proxyman	Proxyman アプリを終了します

---

変更履歴

MCP v3 (Proxyman macOS ≥ 6.8.0)

名前	説明
get_version	現在のProxyman macOSアプリのバージョンとビルド番号を取得します
get_proxy_status	記録状態、ポート番号、SSLプロキシ状態を含む現在のプロキシ状態を取得します
get_flows	Proxymanのアクティブセッションデータソースから最近のHTTP/HTTPSフローを取得します
get_flow_detail	ヘッダー、ボディ、クエリパラメータ、Cookieを含む特定のフローの詳細情報を取得します
list_rules	すべてのアクティブなデバッグルール（ブレークポイント、マップローカル、マップリモート、ブラックリスト、スクリプティング、DNSスプーフィング、ネットワーク条件、ホワイトリスト）を一覧表示します
get_ssl_proxying_list	有効状態とドメインリストを含む現在のSSLプロキシ設定を取得します
create_breakpoint	URLパターンに一致するリクエストまたはレスポンスを一時停止して検査/変更するための新しいブレークポイントルールを作成します
create_map_local	一致するリクエストに対してカスタムレスポンスを返すマップローカルルールを作成します
create_map_remote	リクエストをあるURLから別のURLにリダイレクトするマップリモートルールを作成します
create_blacklist	URLパターンに一致するリクエストをブロックするブラックリストルールを作成します
create_scripting_rule	リクエスト/レスポンスを変更するカスタムJavaScriptを使用したスクリプティングルールを作成します
enable_ssl_proxying	HTTPSトラフィックを復号するために特定のドメインのSSLプロキシを有効にします
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キー）はレスポンスで自動的に編集されます