ProxyCove

ProxyCove MCP Server

AI エージェントが実際にプロキシを購入・管理できます。サインアップもダッシュボードも不要で、チャットにカード情報を入力する必要もありません。

ProxyCove は、170 か国以上で利用できるレジデンシャル、モバイル、データセンターのプロキシを、GB 単位の前払いで販売しています。この MCP サーバーはそれらを 14 個のツールとして提供するため、エージェントは自分のアカウントを作成し、人間に決済リンクを渡し、プロキシを購入して接続に必要な認証情報を取得できます。すべてを 1 回の会話で行えます。

https://mcp.proxycove.com/mcp     ← remote endpoint (streamable HTTP)

ステータス：稼働中です。 上記のエンドポイントは公開されています。接続してご利用ください。 get_pricing、list_locations、create_account では匿名での呼び出しが許可されています。 それ以外の操作にはキーが必要です。OAuth 2.1 を利用するクライアントは /.well-known/oauth-protected-resource で検出できます。

対象ユーザー： スクレイピング／自動化／テスト用のエージェントを構築する開発者、エージェントに特定の国の出口 IP が必要な方、そして REST API を自分でラップするのではなく、プロキシプロバイダーを直接呼び出したい MCP クライアントです。

エージェントが最初から最後までできること

1. create_account → API キー（pc_live_...）を取得します。登録フォームもメールアドレスも不要です。
2. create_topup → payment_url を取得します。人間がブラウザーで支払います（SBP、銀行カード、暗号資産）。
3. buy_proxy → http://login:[email protected]:824 を取得して、プロキシの利用を開始します。

料金：レジデンシャル $2.7/GB · モバイル $3.8/GB · データセンター $1.5/GB。 アカウントが有効な間、前払いしたトラフィックの有効期限は切れません。

---

クイックスタート

サーバーはリモートにあるため、インストールは不要です。エンドポイントをクライアントに追加し、キーを取得したらベアラートークンとして送信します。

キーなしでもコネクターを追加できます。get_pricing、list_locations、create_account は認証なしで動作します。create_account を実行して、返された pc_live_... キーを保存し、ヘッダーに設定してから再接続してください。

Claude Code

claude mcp add --transport http proxycove https://mcp.proxycove.com/mcp \
  --header "Authorization: Bearer pc_live_YOUR_KEY"

まだキーがない場合（先に create_account を呼び出す場合）：

claude mcp add --transport http proxycove https://mcp.proxycove.com/mcp

Claude Desktop / Claude.ai（コネクター）

設定 → コネクター → カスタムコネクターを追加

フィールド	値
名前	ProxyCove
リモート MCP サーバー URL	https://mcp.proxycove.com/mcp

OAuth が提供されるまでは、Claude Desktop から stdio ブリッジ経由でサーバーに接続することもできます。ヘッダーはここに設定します。

{
  "mcpServers": {
    "proxycove": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.proxycove.com/mcp",
        "--header", "Authorization: Bearer pc_live_YOUR_KEY"
      ]
    }
  }
}

ChatGPT（開発者モード）

設定 → コネクター → 詳細設定 → 開発者モードを有効にし、作成を選択します。

フィールド	値
名前	ProxyCove
MCP サーバー URL	https://mcp.proxycove.com/mcp
認証	アクセストークン／API キー → pc_live_YOUR_KEY を貼り付け

Cursor

グローバル設定の場合は ~/.cursor/mcp.json、プロジェクトごとの設定の場合は .cursor/mcp.json：

{
  "mcpServers": {
    "proxycove": {
      "url": "https://mcp.proxycove.com/mcp",
      "headers": {
        "Authorization": "Bearer pc_live_YOUR_KEY"
      }
    }
  }
}

Codex CLI

~/.codex/config.toml：

[mcp_servers.proxycove]
url = "https://mcp.proxycove.com/mcp"
bearer_token_env_var = "PROXYCOVE_API_KEY"

export PROXYCOVE_API_KEY=pc_live_YOUR_KEY

その他の MCP クライアント

{
  "mcpServers": {
    "proxycove": {
      "type": "http",
      "url": "https://mcp.proxycove.com/mcp",
      "headers": {
        "Authorization": "Bearer pc_live_YOUR_KEY"
      }
    }
  }
}

トランスポートはステートレスなストリーミング可能 HTTPです。POST のみを受け付け、呼び出しごとに JSON-RPC リクエストを 1 件処理します。SSE ストリームもセッション ID もありません。エンドポイントへの GET／DELETE は 405 を返します。

---

エージェントスキル

ツールの説明に加え、このリポジトリには エージェントスキル が含まれています。このスキルは、タスクに応じてどのツールを選ぶべきかをエージェントに伝えます。作業に適したプロキシタイプの選び方、スティッキーセッションが必要な場合、各エラーコードの実際の意味、人間が主導権を保つためのルール（決済情報を扱わない、支出前に料金を伝える、キーを保存する）を説明します。

npx skills add proxycove/mcp-server

---

ツール

ツール	説明	API キー
get_pricing	レジデンシャル／モバイル／データセンターの GB あたりの料金（USD）	不要
list_locations	指定したプロキシタイプで利用できる国	不要
create_account	登録フォームなしでアカウントを作成し、pc_live_... キーを返します	不要
get_account	残高（USD）、登録メールアドレス、有効なプロキシ数	必要
create_topup	請求書を作成し、人間に渡す payment_url を返します	必要
get_payment_status	請求書のステータス：pending ／ paid ／ cancelled	必要
buy_proxy	残高からプロキシを購入し、接続認証情報を返します	必要
list_proxies	残りの通信量と認証情報を含むすべてのプロキシ	必要
get_credentials	1つのプロキシの接続文字列	必要
extend_proxy	既存のプロキシにプリペイドの GB を追加します（認証情報は変更されません）	必要
get_usage	1つのプロキシの現在の使用済み／残り通信量	必要
set_rotation	リクエストごとのローテーション ↔ 1～120分間のスティッキー IP	必要
link_telegram	Telegram ボットにアカウントをリンクするコードを返します（キーを紛失した場合の2つ目のログイン方法）	必要
attach_recovery	人間がウェブサイトにログインできるよう、メールアドレスを登録します	必要

読み取り専用ツールには readOnlyHint が設定されています。どのツールもデータを削除しません — このサーバーには破壊的な操作はなく、アカウントから資金を移動できるツールもありません。

接続モデル

すべてのプロキシは go.proxycove.com からアクセスできます。

ポート	動作
824	リクエストごとに新しい IP
10000	設定した1～120分間維持されるスティッキー IP

set_rotation はプロキシを2つのモード間で切り替えます。ログイン名とパスワードは変わりません。

buy_proxy の実行後、最初のリクエストを送る前に約5秒待ってください。国のフィルターが上流に反映されるまで少し時間がかかるため、すぐに最初のリクエストを送ると、別の国から接続される場合があります。

---

認証

• アカウント API キーは pc_live_... の形式で、Authorization: Bearer pc_live_... として送信します。
• create_account でキーを発行します。認証不要の3つのツールは、エージェントが利用を開始できるように用意されています。料金と対応国を確認し、アカウントを作成した後、人間がコネクターの設定にキーを保存します。
• MCP サーバーは独自の状態を保持しません。Authorization ヘッダーを ProxyCove REST API に転送し、JSON レスポンスを返します。
• キーなしで認証が必要なツールを呼び出すと、クラッシュするのではなく、対処方法を説明する構造化された no_api_key エラーが返されます。
• OAuth 2.1 + PKCE に近日対応予定です。これにより、対応クライアントで手動のヘッダー設定が不要になります。ベアラーキーも引き続き使用できます。

---

支払い：エージェントがカード情報を扱うことはありません

これはツールの設計によって強制される、厳格な境界です。

• create_topup は payment_url を返します。エージェントが受け取るのはそれだけです。
• エージェントは URL を人間に渡します。人間は自分のブラウザーで開いて支払いを行います。
• 支払い方法：sbp（ロシアの即時銀行振込）、card_ru、card_international、crypto、crypto_cryptomus。チャージの最低額は $1.50 です。
• カード番号、CVV、支払い認証情報を受け取るツールはありません。スキーマのどこにもそのためのフィールドはありません。
• その後、エージェントは get_payment_status を paid になるまでポーリングし、処理を続けます。

購入（buy_proxy、extend_proxy）には、プリペイド残高のみを使用します。人間が事前に入金していない資金をエージェントが使うことはできません。

---

セルフホスト／ローカルでの実行

このサーバーは、公開されている ProxyCove REST API をラップする薄型のステートレスなラッパーです。データベース、キャッシュ、永続化機能はなく、Node のコードは約200行です。通信を監査したい場合、バージョンを固定したい場合、または独自のネットワーク内で実行したい場合は、セルフホストしてください。

要件： Node 20+（または Docker）。

git clone https://github.com/proxycove/mcp-server.git
cd mcp-server
npm install

export BACKEND_BASE_URL=https://proxycove.com
export MCP_PORT=4010
export MCP_SECRET_PATH=/mcp

npm start
# → http://localhost:4010/mcp

Docker：

docker build -t proxycove-mcp .
docker run -d --name proxycove-mcp \
  -p 4010:4010 \
  -e BACKEND_BASE_URL=https://proxycove.com \
  -e MCP_PORT=4010 \
  -e MCP_SECRET_PATH=/mcp \
  proxycove-mcp

環境変数

変数	デフォルト	用途
MCP_PORT	4010	HTTP サーバーがリッスンするポート
MCP_SECRET_PATH	/mcp	MCP エンドポイントがマウントされるパス
BACKEND_BASE_URL	http://backend:5000	ProxyCove API のベース URL。セルフホストする場合は https://proxycove.com を使用します
PUBLIC_API_INVITE_CODE	(空)	create_account に転送される任意の招待コード

設定はすべて環境変数から行います。設定ファイルはなく、イメージにシークレットが埋め込まれることもありません。

GET /healthz は { "ok": true, "service": "proxycove-mcp" } を返します。

同じ方法で、クライアントを独自のインスタンスに接続してください。

{
  "mcpServers": {
    "proxycove": {
      "type": "http",
      "url": "http://localhost:4010/mcp",
      "headers": { "Authorization": "Bearer pc_live_YOUR_KEY" }
    }
  }
}

---

REST API（MCP 以外の統合）

MCP サーバーでできることはすべて、HTTP 経由でも直接利用できます。エンドポイントもキーも同じです。

• ベース URL：https://proxycove.com/api/v1
• OpenAPI 仕様：https://proxycove.com/api/v1/openapi.json

curl https://proxycove.com/api/v1/pricing

curl https://proxycove.com/api/v1/account \
  -H "Authorization: Bearer pc_live_YOUR_KEY"

通常のクライアント、LangChain／LlamaIndex ツール、CI ジョブなど、MCP ホスト以外のものを作成する場合にご利用ください。

---

セキュリティ

• API キーが表示されるのは一度だけです。create_account の実行時にすぐ保存してください。ProxyCove では再表示できません。
• キーは、proxycove.com のアカウントから、またはサポートに連絡して、いつでも失効させることができます。失効させるとエージェントのアクセスは即座に停止しますが、残高とプロキシはそのまま維持されます。
• 早めに attach_recovery または link_telegram を実行してください。アカウントに復旧手段を設定していない場合、キーを紛失すると残高も失われます。
• pc_live_... はパスワードのように扱ってください。これは支払いに使う認証情報です。共有チャットや公開リポジトリ、このトラッカーの Issue に貼り付けないでください。
• コミットされる設定ファイルにキーを直接記述するより、環境変数による間接指定（bearer_token_env_var、${VAR} による置換）を優先してください。
• 脆弱性、またはエージェントが想定以上に支出できてしまう問題を発見した場合は、[email protected] までメールでご連絡ください。セキュリティ上の報告について、公開 Issue は作成しないでください。

---

貢献

Issue とプルリクエストを歓迎します。バグ報告、上記で取り上げていない MCP ホスト向けのクライアント設定例、ツールの説明の改善などは特に歓迎します。ここではツールスキーマが製品の表面です。説明がエージェントを誤解させた場合は、報告する価値のあるバグです。

ライセンス

MIT © ProxyCove

---

ウェブサイト： proxycove.com · MCP エンドポイント： https://mcp.proxycove.com/mcp · REST API： https://proxycove.com/api/v1 · サポート： [email protected]