proxyman-download-setup

Proxyman のダウンロードとセットアップ

Proxyman のインストールと起動の手順を説明します。Proxyman とその MCP ツールがまだ利用できない場合があるため、このスキルではシェルを優先します。

操作ルール

1. Proxyman のインストール、起動、および MCP の設定が完了するまで、Proxyman MCP ツールを使用しないでください。
2. アプリのバージョンをハードコードしないでください。Proxyman の最新リリースへのリダイレクトを使用してください。
3. Windows では、PowerShell を優先してください。現在のシェルが PowerShell でない場合は、PowerShell のスニペットを powershell.exe -Command '...' で囲んでください。
4. macOS Helper Tool は、システムプロキシの自動設定が必要な場合、またはユーザーから依頼された場合にのみインストールしてください。
5. ルート証明書は、ユーザーが HTTPS の復号を必要とする場合にのみインストールしてください。基本的な HTTP キャプチャやアプリのインストールには、証明書のインストールは必要ありません。
6. Windows と Linux では、MCP のセットアップ前に Proxyman を少なくとも一度起動し、アプリがバンドルされた MCP ブリッジを公開または準備できるようにしてください。

フェーズ 1：既存のインストールを確認する

macOS

if [ -d "/Applications/Proxyman.app" ]; then
  VERSION=$(/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" "/Applications/Proxyman.app/Contents/Info.plist" 2>/dev/null)
  echo "INSTALLED: ${VERSION:-unknown}"
elif mdfind 'kMDItemCFBundleIdentifier == "com.proxyman.NSProxy"' | grep -q "Proxyman.app"; then
  echo "INSTALLED: found via Spotlight"
else
  echo "NOT_INSTALLED"
fi

Windows（PowerShell）

$installed = Get-ItemProperty `
  "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*",
  "HKCU:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*",
  "HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*" `
  -ErrorAction SilentlyContinue |
  Where-Object { $_.DisplayName -like "*Proxyman*" }

if ($installed) {
  Write-Host "INSTALLED: $($installed.DisplayVersion)"
} else {
  Write-Host "NOT_INSTALLED"
}

Linux

if command -v proxyman >/dev/null 2>&1; then
  echo "INSTALLED: $(command -v proxyman)"
elif ls "$HOME"/Downloads/Proxyman*.AppImage "$HOME"/Downloads/proxyman*.AppImage >/dev/null 2>&1; then
  echo "INSTALLED: AppImage in Downloads"
else
  echo "NOT_INSTALLED"
fi

Proxyman がすでにインストールされている場合は、起動して準備に進みます。ユーザーが最新ビルドを必要としている場合は、以下のプラットフォーム別リダイレクトを使用してダウンロードしてください。

フェーズ 2：ダウンロードとインストール

macOS：Homebrew を推奨

Homebrew がインストールされている場合は、cask を使用します。

brew install --cask proxyman

Homebrew を利用できない場合、またはユーザーが直接ダウンロードを希望する場合は、最新の DMG リダイレクトを使用します。

curl -L "https://proxyman.com/release/osx/Proxyman_latest.dmg" -o "$HOME/Downloads/Proxyman.dmg"
hdiutil attach "$HOME/Downloads/Proxyman.dmg" -nobrowse
cp -R "/Volumes/Proxyman/Proxyman.app" /Applications/
hdiutil detach "/Volumes/Proxyman"

ボリューム名が異なる場合は、マウントされているボリュームを一覧表示し、マウントされた Proxyman ボリュームからコピーします。

ls /Volumes

Windows

Windows のエンドポイント名は、互換性のため .dmg で終わっていますが、最新の Windows インストーラーにリダイレクトされます。 インストーラーは NSIS のワンクリックインストーラーで、通常は完了後に Proxyman を起動します。

$installer = "$env:USERPROFILE\Downloads\ProxymanSetup.exe"
Invoke-WebRequest "https://proxyman.com/release/windows/Proxyman_latest.dmg" -OutFile $installer -MaximumRedirection 5
Start-Process $installer -ArgumentList "/S" -Wait

サイレントインストールに失敗した場合は、インストーラーを対話形式で実行します。

Start-Process $installer -Wait

Linux

最新の AppImage リダイレクトをダウンロードし、実行可能にして起動します。

curl -L "https://proxyman.com/release/linux/proxyman_latest" -o "$HOME/Downloads/Proxyman.AppImage"
chmod +x "$HOME/Downloads/Proxyman.AppImage"
nohup "$HOME/Downloads/Proxyman.AppImage" >/dev/null 2>&1 &

パッケージ化された Linux アプリは、初回起動時に MCP ブリッジを準備します。Proxyman を起動した後、安定したブリッジのパスは次のとおりです。

BRIDGE_PATH="${XDG_CONFIG_HOME:-$HOME/.config}/Proxyman/bin/mcp-server"
test -x "$BRIDGE_PATH" && echo "MCP_BRIDGE: $BRIDGE_PATH"

フェーズ 3：Proxyman を起動する

macOS

open -a "Proxyman"
sleep 10

Windows（PowerShell）

$candidates = @(
  "$env:LOCALAPPDATA\Programs\Proxyman\Proxyman.exe",
  "C:\Program Files\Proxyman\Proxyman.exe",
  "C:\Program Files (x86)\Proxyman\Proxyman.exe"
)
$proxymanExe = $candidates | Where-Object { Test-Path $_ } | Select-Object -First 1
if ($proxymanExe) {
  Start-Process $proxymanExe
  Start-Sleep 10
} else {
  Write-Host "Proxyman executable not found. Launch Proxyman from the Start menu, then continue."
}

起動後、バンドルされた MCP ブリッジはアプリの実行ファイルと同じ場所に配置されます。既定のユーザーごとのインストール先は次のとおりです。

$bridge = "$env:LOCALAPPDATA\Programs\Proxyman\mcp-server.exe"
if (Test-Path $bridge) { Write-Host "MCP_BRIDGE: $bridge" }

Linux

if command -v proxyman >/dev/null 2>&1; then
  nohup proxyman >/dev/null 2>&1 &
else
  nohup "$HOME/Downloads/Proxyman.AppImage" >/dev/null 2>&1 &
fi
sleep 10

起動後に Linux の MCP ブリッジのパスが見つからない場合は、Settings > MCP を開いて MCP Server を有効にし、Proxyman を再起動するようユーザーに案内してください。これにより、AppImage がブリッジを設定フォルダーにコピーし、chmod を実行できます。

Windows と Linux の MCP ブリッジに関する注意事項

Windows と Linux の Proxyman ビルドでは、macOS と同じ MCP モデルを使用します。AI エージェントがバンドルされた mcp-server プロセスを stdio 経由で起動し、そのブリッジが認証済みの localhost ハンドシェイクを通じて、実行中のローカル Proxyman アプリと通信します。

proxyman-mcp-setup に進む際は、以下のブリッジパスを使用してください。

プラットフォーム	ブリッジパス
Windows の既定のインストール先	%LOCALAPPDATA%\Programs\Proxyman\mcp-server.exe
Windows のカスタムインストール先	Proxyman.exe と同じフォルダー内の mcp-server.exe
Linux AppImage	${XDG_CONFIG_HOME:-$HOME/.config}/Proxyman/bin/mcp-server

MCP コマンドとして Proxyman.exe や .AppImage を使うよう、エージェントを設定しないでください。コマンドには stdio ブリッジの実行ファイルを指定する必要があります。

フェーズ 4：プロキシキャプチャの準備

Proxyman は、対象によって異なる方法でキャプチャできます。システムの状態を変更する前に、何をキャプチャしたいかをユーザーに確認してください。

• デスクトップアプリやブラウザーは、多くの場合、システムプロキシを使用します。
• Node.js、Python、Ruby、Go などの CLI ランタイムでは、Proxyman の Automatic Setup または Manual Setup が必要になることがあります。
• 多くのクライアントは localhost に対してシステムプロキシを経由しないため、localhost のトラフィックには Reverse Proxy が必要になる場合があります。
• VPN 経由の iOS アプリには、従来のプロキシキャプチャではなく Atlantis が必要になる場合があります。

対象に応じたルーティング、証明書、SSL Proxying、検証、ロールバックの手順には proxyman-https-capture を使用してください。インストールだけでは、すべての対象向けの設定は完了しません。

macOS ヘルパーツール

ヘルパーツールは macOS 専用です。ネットワークインターフェイス全体で Proxyman がシステムプロキシ設定を確実に上書きできるようにしたい場合、または特権が必要なネットワーク設定が原因でシステムプロキシの自動設定に失敗する場合にインストールしてください。

macOS ではパスワード入力または承認のダイアログが表示されることがあるとユーザーに伝え、次を実行します。

open -a "Proxyman" --args --install-privileged-components

macOS のシステム設定に承認を求める画面が表示された場合は、Proxyman のヘルパーツールを承認してから、システムプロキシの操作を再試行するようユーザーに依頼してください。

ルート証明書

ルート証明書の設定が必要なのは HTTPS の復号化を行う場合であり、Proxyman のインストールだけであれば必要ありません。

推奨される手順：

1. アプリのインストールを完了します。
2. エージェントによる自動操作をユーザーが希望する場合は、proxyman-mcp-setup で MCP を設定します。
3. get_certificate_status を使用します。
4. HTTPS の復号化が必要で、証明書がないか信頼されていない場合は、MCP 経由で install_certificate を使用するか、Proxyman の「証明書」メニューを使用します。

MCP を使用しない場合は、Proxyman アプリ内の「証明書」メニューから、対象プラットフォームに適した設定方法を選ぶようユーザーを案内してください。すべての対象にデスクトップのルート証明書を一律に適用するのではなく、proxyman-https-capture を使用してください。

Windows では、証明書の自動インストール時に UAC プロンプトが表示される場合があり、管理者権限で certutil を実行する方法を使用できます。Linux での信頼ストアへの自動インストールは、Ubuntu/Debian、Fedora/RHEL、openSUSE/SUSE、Arch 系のシステム向けに設計されています。サポート対象外のディストリビューションでは、Proxyman の UI に表示される信頼ストア用のコマンドを手動で実行する必要がある場合があります。

一部の Proxyman ビルドでは proxyman-cli が提供されています。command -v proxyman-cli または Get-Command proxyman-cli で存在を確認してから使用してください。カスタムルート証明書に限り、ルート証明書のインポートに対応した CLI ビルドでは、次を使用できます。

proxyman-cli install-root-cert /path/to/custom-root.p12 --password "password" --trust

デフォルトの Proxyman 生成ルート CA に、カスタムルート証明書用の CLI コマンドを使用しないでください。

フェーズ 5：MCP の設定を提案する

Proxyman のインストールと起動が完了したら、MCP の設定を提案します。

Proxyman is installed and running. The next step is to connect your AI agent to Proxyman MCP so it can inspect traffic, manage rules, install certificates when needed, and use Proxyman setup guidance. Use the proxyman-mcp-setup skill next.

ユーザーの次の目的がライセンス認証である場合は、proxyman-license-management を使用してください。チャットにライセンスキーを貼り付けるよう求めないでください。

トラブルシューティング

問題	対処方法
macOS の DMG ボリューム名が異なる	ls /Volumes を実行して Proxyman のボリュームを見つけ、その中から Proxyman.app をコピーします。
macOS でアプリが開かない	xattr -cr "/Applications/Proxyman.app" を実行して、もう一度起動します。
Windows SmartScreen がインストーラーをブロックする	画面に表示された Windows のプロンプトでインストーラーを承認するようユーザーに依頼します。
Linux で AppImage が動作しない	実行可能であることと、必要な AppImage/FUSE 依存関係がインストールされていることを確認します。
macOS でシステムプロキシを有効にできない	ヘルパーツールをインストールまたは承認してから、再試行します。
HTTPS トラフィックが依然として暗号化されたまま	ルート証明書をインストールして信頼し、対象ホストの SSL プロキシを有効にします。