MCP-сервер Prokso: прокси для ИИ-агентов

1. Что такое MCP

Model Context Protocol (MCP) — открытый протокол, через который ИИ-приложения подключают внешние инструменты. Клиент (Claude Code, Cursor, Claude Desktop и т. п.) спрашивает у сервера, какие инструменты у него есть, а модель сама решает, когда их вызывать. Вам не нужно писать код или изучать REST API: достаточно сказать агенту, что нужно.

MCP-сервер Prokso даёт агенту доступ к вашему аккаунту в режиме чтения: баланс, планы, остаток трафика и данные для подключения. Самое полезное — инструмент, который генерирует строки прокси со страной, городом или оператором сразу в том формате, который нужен вашему скрипту или программе.

2. Адрес и технические данные

Адрес сервера: https://prokso.com/api/v1/mcp.
Транспорт — Streamable HTTP в режиме «запрос — JSON-ответ»: только POST, без потока событий (SSE) и без сессий. На GET сервер отвечает 405 — так разрешает спецификация, клиенты это учитывают.
Версии протокола: 2025-06-18 (основная), 2025-03-26 и 2024-11-05.
Вход — ключ API в заголовке Authorization: Bearer КЛЮЧ (подходит и заголовок X-API-Key). Входа через OAuth нет, поэтому клиент должен уметь передавать собственный заголовок.

Если нужна покупка трафика или другие действия с деньгами, используйте REST API или кабинет: MCP-сервер их не выполняет.

3. Инструменты

Сервер отдаёт пять инструментов. Все они только читают данные и денег не тратят.

Инструмент	Что возвращает
`get_account`	Почту аккаунта и баланс.
`get_prices`	Цены за ГБ для каждого типа прокси.
`list_plans`	Все планы: номер, название, тип, состояние и остаток трафика.
`get_plan`	Один план: логин, пароль, хост, порты и остаток трафика.
`get_proxy_lines`	Готовые строки прокси для плана. Параметры: `plan_id`, `count` от 1 до 100, `session` (`rotating` — новый IP на каждый запрос, `sticky` — фиксированный IP на порт), `protocol` (`http` или `socks5`), `format` (`lp@hp`, `hp:lp`, `url` и другие), `country`, `state`, `city`, `zip`, `asn`.

Штат, город, индекс и оператор — это точное гео: такой трафик считается вдвойне. Наличие адресов конкретного города или провайдера мы не гарантируем. Порты, длительность фиксированного IP и синтаксис параметров такие же, как в обычных строках, — см. справочник логина и портов.

4. Ключ API

Откройте кабинет, раздел «Настройки» → «API».
Нажмите «Создать ключ» и при желании дайте ему название, например «Cursor на ноутбуке».
Скопируйте ключ сразу: полностью он показывается только один раз.

На аккаунт можно иметь до 5 ключей. Заведите отдельный ключ для каждого клиента или компьютера: тогда, если одно устройство потеряется, вы отзовёте только его ключ, а остальные продолжат работать. Отозвать ключ можно там же, в «Настройки» → «API», кнопкой «Отозвать» — он перестаёт действовать сразу.

5. Безопасность ключа

Ключ даёт доступ к аккаунту: с ним можно получить логин и пароль ваших планов и строки прокси, то есть тратить ваш трафик. Храните его как пароль.
Держите ключ в переменной окружения (например PROKSO_API_KEY) и ссылайтесь на неё из конфигурации клиента. Так файл настроек можно спокойно класть в репозиторий.
Не коммитьте ключ в git и не пересылайте его в чатах. Если ключ попал в публичный репозиторий или лог — отзовите его и создайте новый.
Агент видит всё, что возвращают инструменты, в том числе пароль плана. Подключайте сервер только в клиенты, которым доверяете.

6. Лимиты

Лимиты такие же, как в REST API: до 60 запросов в минуту на ключ. Один запрос агента к инструменту — один запрос к серверу, плюс служебные запросы клиента при подключении. Если лимит превышен, сервер отвечает 429 с заголовком Retry-After — сколько секунд подождать. Для обычной работы с агентом этого лимита хватает с большим запасом.

Отдельно сервер считает неудачные попытки входа: если с одного адреса много раз отправить неверный ключ, следующие запросы тоже получат 429 на некоторое время.

7. Примеры запросов агенту

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

«Сколько трафика осталось на моих планах?»
«Какой у меня баланс?»
«Дай 5 строк SOCKS5 с фиксированными IP в Польше для плана 12.»
«Сгенерируй 20 строк с новым IP на каждый запрос, страна Германия, формат хост:порт:логин:пароль.»
«Покажи данные для подключения плана 12 и укажи, какие порты дают фиксированный IP.»
«Подставь строку прокси из США в мой скрипт и проверь, с какого IP он выходит.»

Номер плана агент может взять сам через list_plans. Если просите точное гео (город, штат, оператора), агент должен предупредить, что трафик считается вдвойне.

8. Клиенты и инструкции

Сервер работает с любым MCP-клиентом, который поддерживает удалённые серверы по HTTP и позволяет задать заголовок Authorization. Пошаговые инструкции:

Клиент	Как передать ключ	Инструкция
Claude Code	Команда `claude mcp add` с `--header` или файл `.mcp.json`	Открыть
Claude Desktop, claude.ai	Заголовки коннектора (бета) или мост `mcp-remote`	Открыть
Cursor	Поле `headers` в `mcp.json`	Открыть
VS Code (GitHub Copilot)	Отдельная страница	Открыть
Windsurf	Отдельная страница	Открыть
Zed	Отдельная страница	Открыть
Cline	Отдельная страница	Открыть

9. Проверка сервера curl-ом

Прежде чем настраивать клиент, убедитесь, что ключ работает. Команда запрашивает у сервера список инструментов:

curl -X POST https://prokso.com/api/v1/mcp \
  -H "Authorization: Bearer КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

В ответе должен быть result с пятью инструментами:

{"jsonrpc": "2.0", "id": 1, "result": {"tools": [{"name": "get_account", "title": "Account and balance", ...}, ...]}}

Команда рассчитана на macOS и Linux. В Windows выполните её в WSL или Git Bash: PowerShell иначе обрабатывает кавычки в JSON. Общая проверка прокси по шагам — на странице «Прокси не работает».

10. Типичные ошибки

401 с сообщением Pass your API key in the header — ключа в запросе нет: клиент не передал заголовок или переменная окружения пустая.
401 с сообщением Invalid or revoked API key — ключ неверный или отозван. Проверьте, что скопировали его полностью, без пробелов, и что перед ним стоит Bearer с пробелом.
429 — превышен лимит запросов. Подождите столько секунд, сколько указано в Retry-After.
405 на GET — нормальное поведение: сервер принимает только POST. Если открыть адрес в браузере, тоже будет 405.
Инструмент вернул текст ошибки (например, про plan_id или неизвестный город) — это не сбой сервера, а подсказка агенту исправить параметры.

Если ошибка другая, напишите в поддержку и приложите вывод curl, заменив ключ звёздочками. Инструкции для программ без агентов — в разделе «Инструкции».

MCP в Claude Code →Как пользоваться Prokso

MCP-сервер Prokso для ИИ-агентов