proxies-sx-mcp-server

@proxies-sx/mcp-server

Proxies.sx 向けの MCP（Model Context Protocol）サーバーです。AI エージェント向けの住宅用およびモバイルプロキシを GB 単位の従量課金で提供します。Claude、Cursor およびあらゆる MCP クライアントが、ローテーションまたは固定型の HTTP/SOCKS5 プロキシ URL を取得し、国別の最新在庫を確認し、IP をローテーションして使用量を管理できます。ウェブスクレイピング、データ収集、ブラウザー自動化に利用できます。

主力製品は Pool Gateway です。エンドポイント gw.proxies.sx（HTTP 7000、SOCKS5 7001）を通じて、プロキシのユーザー名で利用するプール、国、セッションを指定します。このサーバーを使うと、エージェントは最新の在庫を確認し、認証情報を取得してプロキシ URL を組み立て、使用量を監視し、問題がある場合はサポートチケットを作成できます。また、キャリアモデムの専用ポート、Private Pools、Reserved IPs も管理できます。

すべてのツールに MCP アノテーション（readOnlyHint、destructiveHint）が付いているため、クライアントは削除、ローテーション、キャンセルの前に確認できます。

クイックスタート

1. client.proxies.sx/account で API キーを作成し、client.proxies.sx/purchase でトラフィック（GB）を追加します。
2. サーバーをクライアントに追加します。Claude Code の場合：

claude mcp add proxies-sx -e PROXIES_API_KEY=psx_your_api_key_here -- npx -y @proxies-sx/mcp-server

3. プロキシをリクエストします：

ドイツの Pool Gateway の在庫を確認して、ドイツで使える固定型の住宅用プロキシ URL を教えてください。

エージェントは pool_get_stock、pool_get_my_credentials、pool_build_proxy_url を呼び出し、http://psx_abc123-peer-de-iptype-residential-sid-job1-rot-sticky:[email protected]:7000 のような URL を回答します。

API キーのスコープ

顧客キーには次のスコープを設定できます：ports:read、ports:write、ports:rotate、billing:read、account:read、account:write、traffic:read、tickets:read、tickets:write。顧客向けツール一式を利用するには、すべてを選択してください。

• billing:write は顧客キーでは利用できません。これを必要とするツール（purchase_shared_traffic、create_crypto_payment、cancel_crypto_payment）は、再販業者キーと管理者キーでのみ動作します。顧客はダッシュボードでトラフィックを購入します。
• pak_ キー用のツール（pool_mint_key およびその他の pool_*_key ツール）には、customers:read と customers:write を持つキーを使う再販業者アカウントが必要です。
• ops_* ツールは、ops:* スコープを持つ管理者キーでのみ利用できます。

プールゲートウェイのルール

ユーザー名の形式は psx_<account>-<pool>-<country>[-token-value ...] です。pool_build_proxy_url が自動的に設定します。以下はそのルールです。

• 2 つのプール。 peer はメインネットワークで、ほとんどの国の住宅用デバイスとモバイルデバイスを利用できます。mbl は、米国、英国、フランス、オランダ、ポーランド、GE の 6 か国のみのキャリアモデムです。GE はジョージアであり、ドイツではないため、mbl-de は機能しません。peer-de を使用してください。any と best を指定すると、ゲートウェイが選択します。pool_get_stock で現在オンラインのデバイスを確認できます。
• IP クラス。 -iptype-mobile、-iptype-residential または -iptype-isp を指定します。ISP（静的）クラスは、ISP 登録ネットワーク上のサーバーでホストされているアドレスです。このクラスを利用するには、指定する必要があります。
• ローテーション。 sticky と hard はどちらも 1 台のデバイスを保持します。auto5、auto10、auto20、auto60 は指定した間隔で別のデバイスに切り替わります（デフォルトは auto10 です）。ondemand は、新しい接続ごとにデバイスを選び直します。
• セッションには -sid- が必要です。 sticky、hard、auto* が接続をまたいで継続するには、ユーザー名に -sid-<id>（小文字、数字、_）を含める必要があります。-session- はトークンではありません。ゲートウェイはエラーを出さずに無視します。
• Sticky が保持するのはデバイスであり、IP ではありません。 モバイルキャリアは、保持中のモデムの出口 IP を変更する場合があります。アドレスを固定するには、住宅用ピアまたは Reserved IP を使用してください。
• アカウントごとの上限： 同時接続 500 件、セッション 250 件です。
• 料金： トラフィック 1 GB ごとに課金され、購入量が多いほど GB あたりの料金が安くなります。時間の料金は無料です。get_pricing で最新の料金表を確認できます。どちらのプールも料金は同じです。
• プロキシパスワード。 ゲートウェイのパスワードはアカウントのプロキシパスワード（pool_get_my_credentials）、または pak_ キーです。アカウントのログインパスワードではありません。

ゲートウェイエラー

リクエストに失敗すると、ゲートウェイは CODE: message (req: id) を返します。pool_explain_error は、これらのエラーに対して次に行うべきことを説明します。

コード	ステータス	意味
E_AUTH_REQUIRED	407	プロキシ認証情報が送信されていません
E_AUTH_INVALID	407	ユーザー名またはプロキシパスワードが拒否されました
E_BALANCE_EXHAUSTED	407	認証情報は正しいですが、アカウントのトラフィック残量がありません
E_CAP_EXCEEDED	407	pak_ キーが GB 上限に達しました
E_RATE_LIMITED_AUTH	429	ログイン失敗が多すぎます
E_RATE_LIMITED_CONN	429	接続上限を超えています
E_SESSION_LIMIT	429	セッション上限を超えています
E_NO_STOCK_COUNTRY	502	指定したプール、国、フィルターに該当するオンラインデバイスがありません
E_STOCK_DEGRADED	502	リクエスト中にデバイスがオフラインになりました
E_SSRF_BLOCKED	403	接続先がプライベートアドレスまたはメタデータアドレスです
E_WRONG_PORT	400	SOCKS5 ポートに HTTP が送信されたか、その逆です
E_INTERNAL	503	予期しないゲートウェイエラーです

ツールが失敗すると、MCP エラー結果（isError: true）が返されます。よくあるケース（API キーの欠落または失効、スコープの不足、レート制限、サーバーエラー）では、テキストの末尾に What to do: の行が含まれます。エラーテキスト内のキーとパスワードはマスクされます。

モードと設定

モード	設定	ツール
API キー（標準）	PROXIES_API_KEY	x402 ウォレットグループを除く以下のすべてのツール
x402 ウォレット（オプション）	AGENT_WALLET_KEY	x402 ウォレットグループと「ウォレットモードでも掲載」のマークが付いたツール
両方	両方の変数	すべて

変数	説明
PROXIES_API_KEY	client.proxies.sx/account から取得する psx_ API キー
PROXIES_EMAIL、PROXIES_PASSWORD	API キーの代替手段。アカウントの認証情報でログインします
AGENT_WALLET_KEY	アカウントなしで x402 決済を行うための、Base ネットワーク上の USDC ウォレットの秘密鍵（0x...）
BASE_RPC_URL	x402 用のカスタム Base RPC エンドポイント（デフォルトは https://mainnet.base.org）
PROXIES_API_URL	API のベース URL。デフォルトは https://api.proxies.sx です。末尾の /v1 は指定しても受け入れられ、無視されます。プライベート API を実行している場合を除き、未設定のままにしてください。

MCP クライアントでの使用方法

すべてのクライアントで、環境変数 PROXIES_API_KEY を設定したうえで、同じコマンド npx -y @proxies-sx/mcp-server を実行します。

Claude Code

claude mcp add proxies-sx -e PROXIES_API_KEY=psx_your_api_key_here -- npx -y @proxies-sx/mcp-server

すべてのプロジェクトで利用できるようにするには、-s user を追加します。代わりに、プロジェクトのルートに以下の JSON を記述した .mcp.json を置くこともできます。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加し、Claude Desktop を再起動します。

{
  "mcpServers": {
    "proxies-sx": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/mcp-server"],
      "env": {
        "PROXIES_API_KEY": "psx_your_api_key_here"
      }
    }
  }
}

Cursor

すべてのプロジェクトで使う場合は ~/.cursor/mcp.json に、1 つのプロジェクトで使う場合は .cursor/mcp.json に同じ JSON を記述します。

Windsurf

~/.codeium/windsurf/mcp_config.json に同じ JSON を記述します。

Docker

docker build -t proxies-sx-mcp https://github.com/bolivian-peru/proxies-sx-mcp-server.git
docker run -i --rm -e PROXIES_API_KEY=psx_your_api_key_here proxies-sx-mcp

コンテナーは stdio 経由で MCP と通信します（-i が必要です）。

その他の設定例

recipes/ には、LangChain、CrewAI、および MCP クライアントを直接使う設定例があります。

ツール

npm run build:manifest によってバージョン 3.0.1 のコードから生成されています。手動で編集しないでください。

Pool Gateway

ツール	機能
pool_get_stock	Pool Gateway の現在の在庫を取得します。アカウントは不要です。ウォレットモードにも掲載されています。
pool_get_facets	1 つの国で在庫のある都市、州、キャリア（ASN およびクラスを含む）、IP クラスを件数とともに一覧表示します。アカウントは不要です。ウォレットモードにも掲載されています。
pool_build_proxy_url	すぐに使える Pool Gateway プロキシ URL（gw.proxies.sx、HTTP 7000 または SOCKS5 7001）を作成します。ウォレットモードにも掲載されています。
pool_explain_error	Pool Gateway のエラーについて説明し、対処方法を示します。ウォレットモードにも掲載されています。
pool_get_my_credentials	Pool Gateway のプロキシユーザー名とプロキシパスワードを、すぐに使える HTTP および SOCKS5 URL とともに取得します。
pool_set_proxy_password	新しいプロキシパスワードを設定します（6 文字以上）。
pool_get_my_stats	自分の Pool Gateway の通信量とオープン中の接続に加え、プールの健全性スコアと接続中のデバイス数を取得します。
pool_list_sessions	保存済みの Pool Gateway セッション（プール、国、キャリア、ローテーションモード、バイト数、最終アクティビティ）を一覧表示します。
pool_close_session	pool_list_sessions の sessionKey を指定して、Pool Gateway セッションを 1 つ閉じます。
pool_close_all_sessions	アカウントの保存済み Pool Gateway セッションをすべて閉じます。

Private Pool と Reserved IP

ツール	機能
private_pool_list	Private Pool を、国、ステータス、ゲートウェイユーザー名、パスワードをマスクした接続文字列（キーは private_pool_reveal で表示）、残り GB とともに一覧表示します。
private_pool_build	アカウントの既存 GB 残高から支払う Private Pool を作成します。購入は不要で、通信量は同じ残高から計上されます。
private_pool_reveal	Private Pool のゲートウェイパスワード（pak_ キー）を表示します。
private_pool_usage	Private Pool の日ごとの通信量を MB 単位で取得します。
reserved_ip_list	Private Pool が保有する Reserved IP を、国、クラス、キャリア、都市、ローテーションモード、デバイスのオンライン状況、最後に確認された出口 IP、パスワードをマスクした接続文字列とともに一覧表示します。
reserved_ip_reserve	Private Pool 用にデバイスを 1 台予約して、他の顧客に経由されないようにし、パスワードをマスクした接続文字列を取得します。
reserved_ip_rotate	Reserved IP を、同じ国の別のデバイスに今すぐ移動します。
reserved_ip_extend	通信がない場合に Reserved IP を保持する期間を変更します。
reserved_ip_set_rotation	Reserved IP をスケジュールに従って別のデバイスに移動するかどうかを設定します。オフ（デバイスを保持。デフォルト）または 5、10、20、60 分ごとに設定できます。
reserved_ip_release	Reserved IP を共有プールに返します。

アカウント

ツール	機能
get_account_summary	アカウント残高、空きポート枠、購入済みおよび残りの通信量、アカウントに関するアラートを取得します。
get_account_usage	購入済み、使用済み、利用可能な通信量を、Pool Gateway の通信量と専用ポートの通信量に分けて取得します。

請求

ツール	説明
get_pricing	GB あたりの現在の価格、ボリュームディスカウント、無料のポートスロットの段階、および現在の段階を取得します。
calculate_price	ボリュームディスカウントを適用して、指定した GB 数の料金を計算します。
purchase_shared_traffic	アカウント残高を使って、GB 単位でトラフィックを購入します。
coupon_validate	クーポンコードを使用せずに、注文で有効かどうかを確認します。
coupon_redeem	アカウントに無料の GB またはポートスロットを付与する単体のクーポンを引き換えます。
get_payment_history	アカウントの過去の支払いと暗号資産のチャージ注文を一覧表示します。

暗号資産での支払い

ツール	説明
create_crypto_payment	アカウント残高をチャージする暗号資産の注文を作成し、ホストされた支払いリンクを返します。
check_crypto_payment_status	暗号資産の注文が未払い、確認中、支払い済み、期限切れ、キャンセル済みのいずれか、および残高に入金されたかどうかを確認します。
get_pending_crypto_payments	まだ完了していないアカウントの暗号資産注文を、支払いリンクとともに一覧表示します。
cancel_crypto_payment	まだ支払われていない暗号資産の注文をキャンセルします。
get_crypto_payment_info	暗号資産でのチャージが現在利用可能かどうか、および支払いページで受け付けている通貨を確認します。

専用ポート

ツール	説明
list_available_countries	現在、専用ポートを作成できる国と、create_port が必要とする countryId を一覧表示します。
list_ports	専用ポートを、ステータス、国、キャリア、有効期限、ポート ID とともに一覧表示します。
get_port	専用ポートの場所と、すぐに使える HTTP および SOCKS5 接続文字列を取得します（ポートのパスワードを含みます）。
create_port	キャリアのモデム上に専用ポートを作成し、接続文字列を返します。
delete_port	専用ポートを削除して、スロットを解放します。
update_port_credentials	専用ポートのログイン名やパスワードを変更します。
update_os_fingerprint	専用ポートが提示する OS フィンガープリント（TCP/IP シグネチャ）を設定します。
reconfigure_port	専用ポートを別の国、キャリア、または都市に移動します。
extend_port	専用ポートの有効期限に時間を追加します。

ポートのステータス

ツール	説明
get_port_status	専用ポートがオンライン、オフライン、期限切れのいずれかを確認します。
get_port_ip	専用ポートがリッスンしているサーバーアドレスを取得します。
ping_port	専用ポートが応答するかをテストし、レイテンシを測定します。
speed_test_port	専用ポート経由で速度テストを実行します（ダウンロード、アップロード、ping）。

ポートのローテーション

ツール	説明
rotate_port	専用ポートを同じ場所にある別のモデムに移動します。
check_rotation_availability	専用ポートを現在ローテーションできるか、クールダウンがあとどれくらい続くか、他に空いているモデムがいくつあるかを確認します。
configure_auto_rotation	専用ポートの自動ローテーションを有効または無効にし、間隔を設定します。
get_rotation_history	専用ポートの過去のローテーションについて、日時、実行方法、移動先の場所、成功したかどうかを取得します。
get_rotation_token_url	専用ポートの公開ローテーションリンクを取得します。

ユーティリティ

ツール	説明
get_proxy_connection_string	専用ポートの HTTP または SOCKS5 接続文字列を作成します（ポートのパスワードを含みます）。
get_all_proxy_formats	専用ポートの一般的なすべての形式（URL、host:port、環境変数、curl、Python と Node.js のスニペット、公開ローテーションリンク）を取得します。
get_service_status	Proxies.sx が現在正常に稼働しているかを確認します。Pool Gateway の未解決インシデント、API、ゲートウェイ、リレーの状態、および最近の稼働時間を取得します。ウォレットモードにも表示されます。
get_os_fingerprint_options	create_port と update_os_fingerprint で指定できる OS フィンガープリントの値を一覧表示します。

サポート

ツール	機能
create_support_ticket	Proxies.sx の担当者が確認して回答するサポートチケットを作成します。
list_my_tickets	ステータスと ID を含めて、サポートチケットを一覧表示します。
get_ticket	元のメッセージとすべての返信を含む、サポートチケットを 1 件取得します。
reply_to_ticket	自分のサポートチケットに返信を追加します。
close_ticket	問題が解決したら、自分のサポートチケットを 1 件閉じます。

プールアクセスキー（リセラーアカウント）

ツール	機能
pool_mint_key	顧客用のプールアクセスキー（pak_）を作成します。プロキシのパスワードとして使用されます。
pool_list_keys	使用量、上限、有効期限を含めてプールアクセスキーを一覧表示します。キーの値はマスクされます。
pool_topup_key	1 回の操作でプールアクセスキーの上限に GB を追加したり、有効期限を延長したりします。
pool_update_key	プールアクセスキーのラベル、有効フラグ、上限、有効期限、または品質ティアを変更します。
pool_regenerate_key	プールアクセスキーのシークレット pak_ 値を置き換えます。
pool_reveal_key	プールアクセスキーの pak_ 値全体を表示します。
pool_delete_key	プールアクセスキーを削除します。
pool_key_usage	1 件のプールアクセスキーの 1 日ごとのトラフィックを MB 単位で取得します。
pool_key_audit	1 件のプールアクセスキーの監査ログを新しい順に取得します。作成、変更、上限追加、再生成、表示、削除、および成功または失敗したゲートウェイへのログインが記録されます。

x402 セッション管理

ツール	機能
get_x402_session	すべてのポートを含む、x402 セッションの詳細を取得します。
list_x402_ports	接続文字列と有効期限を含めて、x402 セッション内のすべてのポートを一覧表示します
get_x402_port_status	トラフィック使用量と接続情報を含む、特定のポートの詳細なステータスを取得します
get_sessions_by_wallet	ウォレットアドレスに関連付けられたすべての x402 セッションを一覧表示します。
get_session_status	トラフィック使用量と有効期限を含む、セッションの簡易ステータスを確認します
replace_x402_port	x402 セッションのオフラインポートを、別のデバイス上の新しいポートに無料で置き換えます。
calculate_x402_topup	x402 セッションにトラフィックや時間を追加する費用を計算します。
topup_x402_session	x402 セッションにトラフィックや時間を追加します。

Ops（管理者キーのみ）

ツール	機能
ops_get_user	顧客の 360 度ビュー：残高、プールゲートウェイの使用状況、ポート、および（ファーマーの場合）AI メモ。
ops_get_user_audit	このユーザーに対して Ops エージェントが実行した最近の操作。
ops_reconcile_payments	ユーザーの Stripe と DB の支払い状況を読み取り専用で表示します（確認済み合計＋保留中）。
ops_list_tickets	サポートチケットを一覧表示します（管理者ビュー）。
ops_reply_ticket	チケットに管理者として返信します。オプションで顧客にもメールを送信できます。
ops_set_slots	ユーザーのポートスロット上限を設定します（上限あり）。
ops_credit_balance	ユーザーの残高に USD を入金します（管理者によるクレジット）。
ops_email_user	1 人のユーザーにパーソナライズしたメールを送信します（1 時間あたりの送信数に上限あり）。
ops_list_farmers	ファーマーの AI メモを一覧表示します（共有運用メモリ）。
ops_get_farmer	ファーマーのフリート状況（合計／オンライン／検証済み／掲載済み／ルーティング可能）と AI メモを取得します。
ops_write_farmer_note	ファーマーの AI メモ（状況、次のアクション、自由記述）を書き込みまたは追記します。今後の AI セッションと共有されます。

x402 ウォレット（任意、アカウント不要）

ツール	機能
x402_get_proxy	エージェントウォレットから USDC を支払って、1 つのキャリアモデム上の専用モバイルプロキシを購入します。アカウントは不要です。
x402_get_pricing	x402 の現在の GB あたりの料金、最小購入量、利用可能な期間、決済ネットワークを取得し、購入費用とウォレット残高を比較します。
x402_list_sessions	このウォレットがこのマシンから購入したアクティブな x402 プロキシセッションを、場所、有効期限、プロキシホストとともに一覧表示します。
x402_check_session	x402 プロキシセッションのステータス、残り時間、使用済みトラフィック、接続文字列を取得します。
x402_wallet_balance	エージェントウォレットのアドレスと、Base ネットワーク上の USDC および ETH（ガス代）の残高を取得します。
x402_rotate_ip	x402 プロキシを別のモデムに移動し、出口 IP を変更します。
x402_list_countries	現在 x402_get_proxy でプロキシを作成できる国と、空きモデムの数を一覧表示します。
x402_extend_session	x402 プロキシセッションに時間を追加します。
x402_service_status	x402 決済サービスが稼働していることを確認し、ウォレット残高とアクティブまたは期限切れ間近のセッション数を表示します。
x402_get_pool_access	エージェントウォレットから USDC を支払って Pool Gateway のトラフィックを購入します。アカウントは不要です。
x402_pool_credit	x402 プールセッションで購入済み、使用済み、残りの GB 数を取得します。
x402_pool_topup	x402 プールセッションに GB 数および／または時間を追加します。
x402_pool_regenerate	漏えい後などに、x402 プール認証情報のパスワードを変更します。
x402_pool_connection	x402 プールセッションのゲートウェイホスト、ポート、ユーザー名、パスワードを再表示します。
x402_pool_usage	x402 プールセッションの1日あたりのトラフィックを MB 単位で取得します。
x402_pool_pricing	x402 で購入できる Pool Gateway のプランと、現在の GB あたりの料金および最小購入量を取得します。

tools.json には、同じ一覧が機械可読形式（名前、カテゴリ、タイトル、説明文の最初の文、読み取り専用および破壊的操作のフラグ、モード、パラメーター）で記載されています。

専用ポート

専用ポートは、1つのポートを1つのキャリアモデムに割り当てます。モデムがあるのは US、GB、FR、NL、PL、GE（ジョージア）のみです。現在モデムに空きがある場所は list_available_countries で確認できます。それ以外の国では Pool Gateway を使用してください。

• rotate_port はポートを別のモデムに移動します。ログイン情報とパスワードは変わりませんが、ポート番号は変わります。ローテーションは5分ごとに1回まで可能です。
• reconfigure_port は別の場所に新しいポートを作成し、古いポートを削除します。ポート ID は変わります。
• API はポートの出口 IP を返しません。プロキシ経由でリクエストを送信して確認してください。

プライベートプールと予約済み IP

プライベートプールは、選択した国に限定され、アカウントの GB 残高から支払われる別個のゲートウェイ認証情報です（private_pool_build）。予約済み IP は、そのプール専用に1台のデバイスを確保します（reserved_ip_reserve）。解放するか、アイドル期間が終了するまで確保されます。サーバーは各国の在庫の一部を予約用に確保せず、ピアデバイスを保持できる時間にも上限を設けています。予約が拒否された場合は、その理由がメッセージに表示されます。ISP（静的）クラスは予約できません。

プールまたは予約済み IP の接続文字列では、パスワードとして pak_******** が返されます。その部分を private_pool_reveal から取得したキーに置き換えてください。

reserved_ip_list には、予約済みデバイスで最後に確認された出口 IP が表示されます。これは所有者だけに表示されます。公開しないでください。

x402：アカウントなしでの支払い（任意）

Base ネットワーク上に資金を入れた USDC ウォレットを持つエージェントは、x402 プロトコルを利用して、Proxies.sx アカウントを作成せずにトラフィックを購入できます。API は価格とともに 402 Payment Required を返し、サーバーがオンチェーンで支払いを行い、トランザクションハッシュを添えて再試行します。ウォレットツールを有効にするには、AGENT_WALLET_KEY を設定してください。

• x402_get_pool_access は Pool Gateway のトラフィックを購入します。ティア（peer または mbl）のすべての国で使える認証情報を1つ取得できます。x402_pool_pricing は最新のティアと価格を読み取ります。
• x402_get_proxy はキャリアモデム上の専用ポートを1つ購入します。x402_list_countries は空きがある国を、x402_get_pricing は最新の価格を表示します。
• ウォレットには購入用の USDC と、ガス代用の少量の ETH が必要です。いずれも Base 上で用意してください。x402_wallet_balance で両方を確認できます。（API は、自身で支払うクライアントからの Solana 上の USDC にも対応しています。このサーバーのウォレットは Base 上で支払います。）

アカウントを使う方法（API キーと入金済みの GB）が標準の方法です。x402 はアカウントを持てないエージェント向けの代替手段です。

帯域幅を共有して報酬を得る

peer SDK を通じて接続を共有するデバイスには、提供した GB ごとに報酬が支払われます。利用条件と設定については、agents.proxies.sx/peer/skill.mdをご覧ください。

レジストリ

レジストリ	エントリー
公式 MCP レジストリ	io.github.bolivian-peru/proxies-sx-mcp-server（server.jsonを参照）
npm	@proxies-sx/mcp-server
Glama	glama.ai/mcp/servers/bolivian-peru/proxies-sx-mcp-server
Claude Desktop 拡張機能（MCPB）	manifest.json。npm run build:manifest で生成されます

トラブルシューティング

• 起動時に「Authentication required」と表示される。 クライアントがサーバーを起動する環境で、PROXIES_API_KEY と AGENT_WALLET_KEY のどちらも設定されていません。
• すべてのツールが 401 を返す。 キーが間違っているか、有効期限切れ、または取り消されています。client.proxies.sx/accountで新しいキーを作成してください。
• ツールが 403「missing required scope」を返す。 該当するスコープを含むキーを作成してください。billing:write と customers:* は顧客キーに付与できません（上記を参照）。
• プロキシが 407 を返す。 エラーコードを確認してください。E_AUTH_INVALID はプロキシのパスワードが間違っていることを示します（pool_get_my_credentials を使用）。E_BALANCE_EXHAUSTED は残高がないことを示します（get_account_usage を使用）。
• プロキシが 502 E_NO_STOCK_COUNTRY を返す。 該当するプール、国、フィルターに一致するオンラインのプロキシがありません。pool_get_stock と pool_get_facets を確認してください。また、mbl は6か国でのみ利用できます。
• Claude Desktop にサーバーが表示されない。 設定ファイルの JSON 構文を確認し、Node.js 18 以降がインストールされていることを確かめてから、アプリを完全に再起動してください。

開発

npm install
npm run build            # compile to dist/
npm test                 # unit tests: registry, routes, username grammar, error mapping
npm run lint
npm run build:manifest   # regenerate manifest.json, tools.json and the tool lists in the docs

# Read-only check of every tool against production (needs a real key, changes nothing):
PROXIES_API_KEY=psx_... node tests/live-smoke.mjs

リンク

• ウェブサイト：proxies.sx
• 顧客ダッシュボード：client.proxies.sx
• エージェント向けドキュメント：agents.proxies.sx、Pool Gateway ガイド：agents.proxies.sx/pool/skill.md
• サポート：create_support_ticket ツール、client.proxies.sx/tickets、または [email protected]
• x402 仕様：x402.org

ライセンス

MIT License。LICENSEを参照してください。