2extract

2extract MCP サーバー

2extract のリモート Model Context Protocol サーバーです。AI エージェントから、レジデンシャルプロキシやモバイルプロキシの作成・管理、都市、ZIP コード、キャリアまで指定したジオターゲティング、通信量と利用額の上限設定、使用量と費用のレポート作成ができます。

これはホスト型サーバーです。インストールやローカルでの実行は不要です。MCP クライアントから、以下の URL に 2extract の API キーを使って接続します。

エンドポイント	https://mcp.2extract.com/mcp
トランスポート	Streamable HTTP
認証	Authorization: Bearer 2xt_...（2extract API キー）

API キーを取得する

1. 2extract に登録するか、ログインします。
2. API キーを開き、キーを作成します。
3. エージェントに必要なスコープを付与します：proxies:read、proxies:write、balance:read、stats:read、geo:read。書き込みスコープに読み取りアクセスは含まれないため、ほとんどのワークフローでは proxies:read と proxies:write の両方が必要です。

読み取り専用キー（proxies:write なし）でも、レポート作成や検索には十分です。

接続する

Claude Code

claude mcp add --transport http 2extract https://mcp.2extract.com/mcp \
  --header "Authorization: Bearer 2xt_your_api_key"

Codex CLI

キーは EXTRACT_API_KEY 環境変数から読み取られます。Bearer は Codex が自動で追加します。

export EXTRACT_API_KEY=2xt_your_api_key
codex mcp add 2extract --url https://mcp.2extract.com/mcp --bearer-token-env-var EXTRACT_API_KEY

または、~/.codex/config.toml（または信頼済みプロジェクト内の .codex/config.toml）を編集します。

[mcp_servers.2extract]
url = "https://mcp.2extract.com/mcp"
bearer_token_env_var = "EXTRACT_API_KEY"

Gemini CLI

gemini mcp add -s user --transport http \
  --header "Authorization: Bearer 2xt_your_api_key" \
  2extract https://mcp.2extract.com/mcp

または、~/.gemini/settings.json（またはプロジェクト内の .gemini/settings.json）を編集します。

{
  "mcpServers": {
    "2extract": {
      "httpUrl": "https://mcp.2extract.com/mcp",
      "headers": { "Authorization": "Bearer 2xt_your_api_key" }
    }
  }
}

OpenCode

プロジェクト内の opencode.json（または ~/.config/opencode/opencode.json）を使います。キーは EXTRACT_API_KEY 環境変数から読み取られます。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "2extract": {
      "type": "remote",
      "url": "https://mcp.2extract.com/mcp",
      "enabled": true,
      "headers": { "Authorization": "Bearer {env:EXTRACT_API_KEY}" }
    }
  }
}

Claude Desktop

claude_desktop_config.json：

{
  "mcpServers": {
    "2extract": {
      "type": "http",
      "url": "https://mcp.2extract.com/mcp",
      "headers": { "Authorization": "Bearer 2xt_your_api_key" }
    }
  }
}

Cursor

~/.cursor/mcp.json または .cursor/mcp.json：

{
  "mcpServers": {
    "2extract": {
      "url": "https://mcp.2extract.com/mcp",
      "headers": { "Authorization": "Bearer 2xt_your_api_key" }
    }
  }
}

VS Code

.vscode/mcp.json（キーは初回使用時に要求され、ファイルには保存されません）：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "2extract-api-key",
      "description": "2extract API key",
      "password": true
    }
  ],
  "servers": {
    "2extract": {
      "type": "http",
      "url": "https://mcp.2extract.com/mcp",
      "headers": { "Authorization": "Bearer ${input:2extract-api-key}" }
    }
  }
}

Cline

Cline パネルを開き、MCP Servers、次に Configure MCP Servers をクリックして、cline_mcp_settings.json に追加します。

{
  "mcpServers": {
    "2extract": {
      "type": "streamableHttp",
      "url": "https://mcp.2extract.com/mcp",
      "headers": { "Authorization": "Bearer 2xt_your_api_key" },
      "disabled": false
    }
  }
}

"type": "streamableHttp" はそのままにしてください。これがないと、Cline は旧式の SSE トランスポートにフォールバックします。

その他のクライアント

リモート MCP サーバーに対応したクライアントであれば利用できます。エンドポイント URL、Streamable HTTP トランスポート、Authorization ヘッダーを指定してください。

ツール

アカウント

ツール	内容	スコープ
getAccountBalance	利用可能な資金、新しいプロキシを作成できるかどうか、プロキシのユーザー名プレフィックス	balance:read
getAccountTrafficUsage	アカウントまたは1つのプロキシについて、期間中の通信量と利用額を取得します	stats:read
listAccountBalanceHistory	期間中の入金と請求を取得します	stats:read

ジオターゲティング

ツール	内容	スコープ
listGeoCountries	ターゲティングに利用できる国	geo:read
searchGeoRegions	国ごとの地域と州	geo:read
searchGeoCities	国または地域内の都市	geo:read
searchGeoZips	国ごとの ZIP コードと郵便番号	geo:read
searchGeoISP	ISP ターゲティング用のモバイルキャリア	geo:read

プラン

ツール	内容	スコープ
listProxyPlans	利用可能なプランと価格	proxies:read

プロキシ

ツール	内容	スコープ
listProxyResources	アカウント上のすべてのプロキシと、トラフィック量および利用料金を表示します	proxies:read
getProxyResource	1つのプロキシの詳細を表示します	proxies:read
createProxyResource	プロキシを作成します（課金対象）	proxies:write
updateProxyResource	説明、ステータス、地域、許可リスト、または上限を変更します	proxies:write
deactivateProxyResource	プロキシを削除せずにトラフィックを停止します	proxies:write
deleteProxyResource	プロキシを完全に削除します（確認を求めます）	proxies:write
regenerateProxyPassword	新しいパスワードを発行します（確認を求めます）	proxies:write
setProxyLimits	1日または1か月あたりのトラフィック量または利用料金に上限を設定します	proxies:write
setProxyIpWhitelist	プロキシを使用できるIPアドレスを制限します	proxies:write
setProxyTargetHosts	プロキシがアクセスできるドメインを制限します（*.example.com のようなワイルドカードを使用できます）	proxies:write

破壊的な操作を行うツールの確認は、クライアント側で行われます。クライアントが確認を求めない場合、proxies:write を持つキーであれば実行できるため、適切なスコープのキーを使用してください。

プロンプト

プロンプト	引数	内容
create-proxy-resource	purpose、proxy_type?、country?	指定された用途のプロキシを作成し、接続文字列を返します
build-connection-string	proxy_id?、purpose?	既存のプロキシの接続文字列を作成します
monthly-cost-report	period	期間ごとのプロキシ別トラフィック量と利用料金を表示し、外れ値に印を付けます。読み取り専用です
cleanup-unused-proxies	なし	30日間トラフィックのないプロキシを見つけ、確認後に無効化します。削除は行いません

リクエスト例

• 「ドイツのベルリンに、価格監視用のレジデンシャルプロキシを作成し、月5 GBを上限に設定してください。」
• 「serp_us プロキシ用のスティッキーセッション接続文字列を教えてください。」
• 「先月のトラフィック料金はいくらでしたか？プロキシごとに教えてください。」
• 「過去30日間にトラフィックがなかったプロキシはどれですか？無効化してください。」
• 「ターゲットにできる米国のモバイル通信事業者を見つけてください。」

ドキュメント

• MCP サーバーの概要
• クイックスタート
• ツールリファレンス
• プロンプト
• 使用例
• よくある質問
• 接続ページ

サポート

• メール：[email protected]
• この掲載内容に関する問題：このリポジトリで issue を作成してください

法的情報

• 利用規約
• プライバシーポリシー

サーバーのソースコードは公開されていません。このリポジトリには、公開用の掲載情報、クライアント設定例、およびレジストリマニフェスト（server.json）が含まれています。