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 для ШІ-агентів