Прокси MCP-сервер: прокси для Claude Code, Codex и Cursor

Две разные вещи, которые называют прокси MCP-сервером

Прокси MCP-сервер — это MCP-сервер, который управляет IP-прокси для ИИ-ассистента. Ассистент вызывает инструмент с понятным названием, например «получить адрес прокси для страны» или «открыть страницу через прокси», а логин, пароль и API-ключ остаются в настройках сервера, а не в чате.

Название легко спутать с mcp-proxy — открытой утилитой, которую репозиторий описывает так: «A bridge between Streamable HTTP and stdio MCP transports» (мост между транспортами Streamable HTTP и stdio). Она передаёт MCP-сообщения между двумя транспортами, чтобы клиент, знающий только один из них, мог подключиться к серверу с другим. К IP-адресам, странам и выходным узлам она отношения не имеет. В этом руководстве «прокси MCP-сервер» всегда означает первое.

• Источники:
• mcp-proxy (sparfenyuk) README

Локальные и удалённые MCP-серверы

Документация MCP делит серверы по месту запуска. Локальный сервер использует транспорт stdio: клиент запускает его как процесс на вашем компьютере и общается с ним через стандартный ввод и вывод, без сетевых накладных расходов. Удалённый сервер использует транспорт Streamable HTTP: он находится по URL, и этот транспорт поддерживает для аутентификации bearer-токены, API-ключи и свои заголовки.

От этого зависит, куда класть ключ. Локальному серверу клиент передаёт ключ как переменную окружения. Удалённому ключ обычно уходит HTTP-заголовком с каждым запросом. В обоих случаях смысл прокси MCP-сервера в том, что ключ не нужно писать в запросе.

• Источники:
• MCP documentation: Architecture overview

Что проверить перед установкой

Сначала прочитайте список инструментов. Прокси MCP-сервер работает с вашими учётными данными и может обращаться к платной инфраструктуре, поэтому изучите название и описание каждого инструмента.

Проверьте, может ли какой-нибудь инструмент что-то покупать или тратить баланс кошелька. Если может, решите, нужно ли вам это, и по возможности выбирайте серверы без покупки.

Проверьте, где хранится ключ. Его место — переменная окружения или файл настроек клиента, который вы не коммитите в репозиторий; не в запросе, потому что запросы остаются в истории диалога.

proxy302-mcp — официальный MCP-сервер

proxy302-mcp — официальный MCP-сервер Proxy302 с открытым кодом на GitHub, его поддерживает команда Proxy302. Вопросы об аккаунте и оплате — в поддержку Proxy302, ошибки сервера — в issues на GitHub.

Он бесплатный, с открытым кодом (MIT), устанавливается с GitHub через npx, работает на вашем компьютере по stdio, требует Node.js 20+ и API-ключ Proxy302 в переменной окружения PROXY302_API_KEY. Его инструменты: расход и баланс кошелька, страны и регионы, продукты и тарифы, готовый адрес ротируемого резидентного прокси для страны, ваши собственные прокси и загрузка URL через прокси (обычный HTTP, без выполнения JavaScript).

Он не может ничего покупать и тратить деньги с кошелька. Единственная операция записи — создание бесплатных учётных данных динамического прокси, она по умолчанию выключена; трафик тарифицируется только при использовании. Сам API Proxy302 описан в документации для разработчиков.

• документации для разработчиков

• Источники:
• README proxy302-mcp (официальный MCP-сервер Proxy302)

Установка proxy302-mcp в Claude Code, Codex CLI и Cursor

proxy302-mcp — локальный stdio-сервер, который запускается через npx: все три инструмента ниже запускают его как процесс и передают ему PROXY302_API_KEY. Замените <key id>:<secret> своим API-ключом. Ключ хранится в переменной окружения, а не в запросе.

Claude Code. Имя сервера пишется перед -e, а -- отделяет параметры самого Claude Code от команды запуска сервера. С -s user сервер доступен во всех проектах; без него — только в текущем.

• Источники:
• Claude Code docs: Connect Claude Code to tools via MCP
• Codex docs: Model Context Protocol
• Cursor docs: Model Context Protocol

Claude Code: команда установки

claude mcp add proxy302 -s user -e PROXY302_API_KEY="<key id>:<secret>" -- npx -y github:proxy302/proxy302-mcp

Только пример: замените <key id>:<secret> своим ключом.

• Источники:
• Claude Code docs: Connect Claude Code to tools via MCP

Установка в Codex CLI

Codex CLI. Используйте команду или впишите тот же сервер в ~/.codex/config.toml.

Codex CLI: команда установки

codex mcp add proxy302 --env PROXY302_API_KEY="<key id>:<secret>" -- npx -y github:proxy302/proxy302-mcp

Только пример: замените <key id>:<secret> своим ключом.

• Источники:
• Codex docs: Model Context Protocol

Codex CLI: вариант для config.toml

[mcp_servers.proxy302]
command = "npx"
args = ["-y", "github:proxy302/proxy302-mcp"]
env = { PROXY302_API_KEY = "<key id>:<secret>" }

Тот же сервер, записанный в ~/.codex/config.toml.

• Источники:
• Codex docs: Model Context Protocol

Установка в Cursor

Cursor. Добавьте сервер в ~/.cursor/mcp.json (для всех проектов) или в .cursor/mcp.json внутри одного проекта.

Cursor: mcp.json

{
  "mcpServers": {
    "proxy302": {
      "command": "npx",
      "args": [
        "-y",
        "github:proxy302/proxy302-mcp"
      ],
      "env": {
        "PROXY302_API_KEY": "<key id>:<secret>"
      }
    }
  }
}

Только пример: замените <key id>:<secret> своим ключом.

• Источники:
• Cursor docs: Model Context Protocol

Удалённый MCP

Можно ничего не устанавливать и подключиться к удалённому MCP по адресу https://proxy302.com/v1/mcp. Клиент работает по Streamable HTTP и передаёт API-ключ Proxy302 в заголовке Authorization в виде Bearer <key id>:<secret>. В нём 9 инструментов: баланс и расход аккаунта, списки стран и регионов, продукты и цены, ротируемый резидентный прокси для нужной страны, ваши прокси (для статических IP — с адресом выхода), смена IP, проверка чистоты IP и оценка расходов в сравнении с балансом кошелька. Ни один из них не тратит деньги: покупки делаются в консоли.

Для веб-версий Claude и ChatGPT есть второй адрес — https://mcp.proxy302.com/mcp, со страницей входа. В Claude откройте Settings → Connectors → Add custom connector («Настройки → Коннекторы → Добавить свой коннектор»); в ChatGPT включите режим разработчика (Developer mode) и добавьте коннектор. Введите адрес, а когда откроется страница авторизации Proxy302, вставьте ключ со страницы API-ключей консоли в виде <key id>:<secret> и подтвердите. Если удалить этот ключ в консоли, соединение прекратится. Клиенты, которые передают заголовки, — Claude Code, Cursor, Dify — работают с любым из двух адресов с заголовком Authorization.

• Источники:
• Proxy302 remote MCP endpoint

Claude Code: удалённый адрес

claude mcp add --transport http proxy302 https://proxy302.com/v1/mcp --header "Authorization: Bearer <key id>:<secret>"

Параметры --transport http и --header описаны в документации Claude Code о MCP. Cursor, VS Code, Codex и Gemini CLI принимают тот же адрес и заголовок Authorization в своей настройке MCP.

• Источники:
• Claude Code docs: Connect Claude Code to tools via MCP
• Proxy302 remote MCP endpoint

Как направить через прокси собственный трафик MCP-сервера

Дать инструменту прокси и направить через прокси исходящие запросы самого MCP-сервера — две разные задачи. Большинство MCP-серверов — программы на Node.js или Python, которые запускает клиент; они получают окружение от клиента, поэтому переменные прокси нужно передавать именно туда.

Node.js читает переменные прокси только по явному включению. Задайте NODE_USE_ENV_PROXY=1 (Node v24.0.0 и v22.21.0 или новее) или запустите Node с --use-env-proxy (v24.5.0 и v22.21.0 или новее), и он прочитает HTTP_PROXY, HTTPS_PROXY и NO_PROXY. Принимаются только адреса прокси HTTP или HTTPS, SOCKS не поддерживается. В Node 20 встроенной поддержки нет, поэтому сервер на Node 20 эти переменные не подхватит.

В Python проще: httpx и requests читают переменные окружения прокси по умолчанию. Если адрес прокси — SOCKS, для requests нужен пакет requests[socks].

Клиент передаёт эти переменные серверу в блоке env, рядом с API-ключом. Пример для сервера, который делает обычные веб-запросы:

• Источники:
• Node.js docs: command-line options and built-in proxy support
• Requests documentation: Advanced usage, proxies
• HTTPX documentation: Environment variables

Блок env с переменными прокси для MCP-сервера

{
  "mcpServers": {
    "some-other-server": {
      "command": "npx",
      "args": ["-y", "your-mcp-server-package"],
      "env": {
        "NODE_USE_ENV_PROXY": "1",
        "HTTPS_PROXY": "http://USERNAME:PASSWORD@HOST:PORT",
        "HTTP_PROXY": "http://USERNAME:PASSWORD@HOST:PORT",
        "NO_PROXY": "localhost,127.0.0.1"
      }
    }
  }
}

Только пример: замените HOST, PORT, USERNAME и PASSWORD своими значениями. Используйте адрес HTTP-прокси.

• Источники:
• Node.js docs: command-line options and built-in proxy support

Те же переменные в командной строке

Те же переменные работают и в командной строке:

Node.js: включение в командной строке

NODE_USE_ENV_PROXY=1 HTTPS_PROXY=http://USERNAME:PASSWORD@HOST:PORT node server.js

Только пример: замените значения-заполнители своими.

• Источники:
• Node.js docs: command-line options and built-in proxy support

Проверяйте два участка по отдельности

Соединение самого ассистента и исходящие запросы сервера — это два отдельных участка, проверяйте их по отдельности. Сравните страну и провайдера выхода, которые показывает сервис проверки, с тем регионом, который вы запрашивали.

Замеры выходов: ротируемые резидентные Proxy302, восемь стран

Это почасовая проверка связи Proxy302, а не замер proxy302-mcp: по одному запросу к Amazon из каждой страны через ротируемый резидентный выход, 3 ноября 2026 г., 18:18 UTC. Одно измерение на страну, а не среднее; следующие проверки дадут другие значения. Публикуются только первые три октета IP.

• Источники:
• Proxy302 hourly connectivity check

Какой тип прокси подходит для какого вызова

Ротируемые резидентные подходят для чтения открытых страниц из разных мест: страницы с ценами, результаты поиска, документация, которая различается по странам. Трафик покупается в гигабайтах, каждый созданный прокси расходует его; страну выбирают при создании.

Статический ISP-IP подходит для задач, привязанных к одному аккаунту: IP арендуется на срок от 1 до 90 дней и в течение аренды не меняется. IP дата-центров подходят для обычных вызовов API, где тип сети не важен.

Прокси меняет только сетевой адрес, который видит сервис. Что аккаунту разрешено и останется ли он открытым, решает сама платформа.

• Источники:
• Proxy302 product facts and price list

Как это сделать с Proxy302

Для работы прокси MCP-сервера чаще всего подходят ротируемые резидентные прокси: сервер запрашивает адрес прокси для страны, а использованный трафик списывается с кошелька. На странице продукта описаны линии и страны.

• странице ротируемых резидентных прокси

Как это сделать с Proxy302: шаги

1. Шаг 1

   Создайте API-ключ в консоли Proxy302 (страница /api-keys). Он состоит из двух частей — key id и secret — и записывается как <key id>:<secret>.

2. Шаг 2

   Выполните команду установки для своего инструмента из раздела выше, положив ключ в переменную окружения.

3. Шаг 3

   Если инструмент просит перезапуск, перезапустите его, затем попросите ассистента показать список инструментов сервера и получить адрес прокси для нужной страны.

4. Шаг 4

   Проверьте выход через прокси с помощью https://ipinfo.io/json. Поле country должно соответствовать выбранной вами стране. Другие сервисы проверки описаны в руководстве по проверке прокси.

   • как проверить IP и местоположение прокси

5. Шаг 5

   Из материкового Китая сначала запустите вспомогательную программу на странице «Подключение» и держите её открытой, пока работает прокси.

   • Руководство по вспомогательной программе

Цены и ограничения

proxy302-mcp бесплатный. Ротируемый резидентный трафик стоит от 1,5 доллара за ГБ на линии Budget и 5 долларов за ГБ на линии Premium, в больших пакетах цена за ГБ ниже. Статический ISP-IP стоит 0,5 доллара за день и 7,99 доллара за 30 дней, одинаково во всех странах; наличие меняется ежедневно и показано на странице заказа. Бесплатного пробного периода нет, минимальная покупка — 1 ГБ ротируемого резидентного трафика или один IP на один день. Прокси не снимает ограничений, не отменяет блокировок и не повышает лимиты.

• Источники:
• Proxy302 product facts and price list

Proxy302 коротко

Цены указаны в PTC и списываются с кошелька; 1 PTC = 1 доллар США. Бесплатного пробного периода нет: минимальная покупка — 1 ГБ ротируемого резидентного трафика или один IP на один день. Проверено 4 ноября 2026 г.

• Источники:
• Proxy302 product facts and price list
• Proxy302 ISP for AI subscriptions: public catalog

Частые вопросы

Что читать дальше

Прокси для Claude Code: настройка

Как запустить Claude Code за HTTP-прокси: HTTPS_PROXY, NO_PROXY, settings.json для фоновых агентов и проверка, что всё работает.

Прокси для Codex CLI

Как направить OpenAI Codex CLI через HTTP-прокси с помощью переменных окружения, сделать настройку постоянной и исправить типичные ошибки.

Прокси для Browser Use: агент через HTTP-прокси

Как направить агента Browser Use через HTTP-прокси: актуальный ProxySettings, свой прокси для каждого агента, настройки Playwright и Playwright MCP, часовой пояс и язык, типичные ошибки.

Ротируемые резидентные прокси

Реальные домашние IP в 195+ странах с выбором региона и города. Смена IP на каждый запрос или липкие сессии. От $1,50/ГБ, $1,35/ГБ при 100 ГБ. HTTP и SOCKS5.

Посмотреть параметры и цену