Proxyman MCP
公式Proxyman MCPは、AIが自然言語での会話を通じてHTTPトラフィックを検査し、デバッグルールを作成し、Proxymanを制御できるようにします。
Proxyman MCPで何ができますか？
- キャプチャしたトラフィックを検査 — アシスタントに、ホスト、メソッド、またはステータスコードでフィルタリングした最近のHTTP/HTTPSリクエストを表示してもらいます。
- デバッグルールを作成 — アシスタントにブレークポイントの設定、ローカル/リモートルールのマッピング、またはURLのブラックリスト化を依頼して、トラフィックを変更またはブロックします。
- リクエストをcURLとしてエクスポート — キャプチャしたフローを、共有や再生に使える実行可能なcURLコマンドに変換します。
- SSLプロキシを管理 — 特定のドメインでHTTPS復号化を有効にしたり、現在のSSLプロキシ設定を確認したりします。
- 録画セッションを制御 — トラフィックキャプチャの開始または停止、現在のセッションのクリア、プロキシステータスの確認を行います。
- フローからコードを生成 — アシスタントに、キャプチャしたリクエストから18以上の言語とフレームワークに対応したコードスニペットを生成してもらいます。
ドキュメント
完全なドキュメント索引については、llms.txt を参照してください。ドキュメントページのMarkdown版は、ページURLに
.mdを追加することで利用できます。このページは Markdown としても利用可能です。
MCP
Codex、Claude Code、またはCursorをProxyman MCPに接続して、キャプチャしたHTTP/HTTPSトラフィックを検査し、AIアシスタントからデバッグルールを作成できます。
Proxyman MCPは、AIアシスタントをコンピュータ上で実行中のProxyman macOSアプリに接続します。これを使用して、キャプチャしたリクエストとレスポンスを検査し、障害を調査し、デバッグルールを作成できます。分析を依頼する前に、Proxymanを開いたまま調査したいトラフィックをキャプチャしてください。
1. Proxyman MCPとは？
Proxyman MCP（Model Context Protocol）は、AIアシスタント（Codex、Claude Code、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 への直近10件のAPIリクエストを表示
- /api/users へのすべてのPOSTリクエストにブレークポイントを作成
- 失敗したリクエストをcURLコマンドとしてエクスポート
- *.stripe.com のSSLプロキシを有効化
- ステータスコード、ヘッダー、ボディを変更する新しいスクリプトを作成
- 指定したURLでMap Local、Breakpointツールを作成
2. 利点
| 利点 | 説明 |
|---|---|
| AIを活用したデバッグ | AIにキャプチャしたトラフィックの分析、特定のリクエストの検索、APIレスポンスの説明を依頼 |
| ハンズフリーのルール作成 | 会話を通じてブレークポイント、Map Local/Remoteルールを作成 |
| 高速なワークフロー | コンテキストを切り替えずにcURLコマンドのエクスポート、フローのフィルタリング、セッションの管理が可能 |
| 設計によるセキュリティ | セッションごとのトークン認証を備えたlocalhost専用サーバー |
| IDE統合 | Cursorやその他のMCP互換ツールとシームレスに連携 |
3. Proxyman MCPの追加方法
- ProxymanでMCPを有効化
- Proxymanを開く → 設定 → MCPタブ
- MCPサーバーを有効化してMCPサーバーを起動 をトグル
- MCPクライアントを選択： Proxymanの設定 → MCPで、Codex または Claude Code を選択し、コマンドをコピー を使用します。Cursor の場合は、手動 を選択し、表示された設定をCursorのMCP設定に追加します。
- クライアントとインストールに応じて以下の設定を使用します。Proxymanが生成するコマンドはインストール済みアプリのパスを使用するため、これらの例とは異なる場合があります。通常のデバッグでは、機密データの編集を有効にしたままにしてください。
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 %}
手動
Cursorやその他のMCPクライアントの場合は、Proxymanの手動タブから設定をクライアントのMCP設定に追加します。インストールされているProxymanアプリに応じた設定を選択してください。以下の例は mcpServers エントリを示しています：
- プロダクション版：
{
"mcpServers": {
"proxyman": {
"command": "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
}
}
}
- Setapp版：
{
"mcpServers": {
"proxyman": {
"command": "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
}
}
}
- Proxyman MCPの使用を開始
- Proxymanが実行されていることを確認
- AIアシスタントにProxymanとの対話を依頼します。例：「api.example.com への最新のリクエストを表示して」
- クライアントがProxymanを見つけられない場合は、MCPが有効で設定されたアプリのパスが正しいことを確認し、クライアントを再接続します。接続できてもフローが見つからない場合は、新しいリクエストを作成し、トラフィック欠落チェックリスト を使用してください。
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 | すべてのデバッグルール（ブレークポイント、Map Local、Map Remote、ブラックリスト）を一覧表示します |
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 | 複数の条件（url、host、method、status、headers、body）による高度なフィルタリング。AND/ORの組み合わせに対応 |
アプリ制御
| ツール | 説明 |
|---|---|
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 | ヘッダー、ボディ、クエリパラメータ、クッキーを含む特定のフローに関する詳細情報を取得する |
| 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ソースコマンドを取得する |
| 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 | キャッシュなし機能を切り替える（キャッシュ関連ヘッダーを削除する） |
| 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キー）はレスポンスで自動的に編集されます