$
УвійтиРеєстрація

MCP-сервер Prokso в Cline

Cline — агент для VS Code та інших редакторів, є й консольна версія — працює з віддаленими MCP-серверами. Для Prokso важливі дві речі: тип streamableHttp і заголовок із ключем API.

1. Що потрібно

  • Розширення Cline у редакторі або Cline CLI. Мінімальної версії документація Cline не називає — оновіть розширення, якщо налаштувань MCP не видно.
  • Ключ API Prokso. Створіть його в кабінеті: «Налаштування» → «API». Ключ показується повністю лише один раз.

Що вміє сервер — на сторінці MCP-сервер Prokso.

2. Файл cline_mcp_settings.json

У розширенні натисніть іконку MCP Servers у верхній панелі Cline, відкрийте вкладку Configure і внизу — Configure MCP Servers. Відкриється файл cline_mcp_settings.json; у Cline CLI це ~/.cline/data/settings/cline_mcp_settings.json (інший шлях задає змінна CLINE_MCP_SETTINGS_PATH). Додайте запис у mcpServers:

{
  "mcpServers": {
    "prokso": {
      "type": "streamableHttp",
      "url": "https://prokso.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer КЛЮЧ"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
  • "type": "streamableHttp" — обов'язково. Без цього рядка Cline обирає застарілий транспорт SSE, а наш сервер працює без SSE.
  • headers — тут передається ключ. Вкладка Remote Servers у панелі приймає лише назву, адресу й транспорт, поле для заголовків там не описане, тому сервер Prokso додавайте через JSON.
  • autoApprove — інструменти, які агент викликає без підтвердження. Наші інструменти лише читають дані, але get_plan і get_proxy_lines повертають доступи до проксі, тож вирішуйте самі.

3. Як перевірити

  1. Збережіть файл: prokso з'явиться в списку серверів Cline.
  2. Розгорніть сервер — має бути п'ять інструментів: get_account, get_prices, list_plans, get_plan, get_proxy_lines.
  3. Скажіть агента: «Через prokso покажи мій баланс» — і підтвердьте виклик get_account. Якщо сервер не відповідає, перезапустіть його в налаштуваннях MCP.

4. Приклади запитів

  • «Скільки трафіку лишилося на моїх планах?»
  • «Дай 5 рядків SOCKS5 з фіксованими IP у Польщі для плану 12».
  • «Візьми 10 рядків з новою адресою на кожен запит для плану 12 і додай їх у змінну PROXIES у .env».
  • «Порівняй залишок трафіку на всіх планах і скажи, на якому його менше».

Інструменти лише читають дані — покупка в кабінеті або через REST API. Порти й гео — як у довіднику шлюзу; точне гео рахує трафік удвічі.

5. Якщо не працює

  • 401 — ключ неправильний або відкликаний. Скопіюйте новий ключ і перевірте, що він стоїть після Bearer і одного пробілу.
  • Помилки про SSE чи 405 — у записі немає "type": "streamableHttp", і Cline звертається до сервера не тим транспортом.
  • 429 — понад 60 запитів на хвилину з одним ключем. Зачекайте стільки секунд, скільки в заголовку Retry-After.
  • Довгі запити обриваються — у налаштуваннях MCP Cline можна збільшити тайм-аут запиту.

Перевірте ключ без агента — у відповіді має бути п'ять інструментів:

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"}'

Решта кодів — на сторінці MCP-сервера.

6. Безпека ключа

  • Файл cline_mcp_settings.json лежить у налаштуваннях Cline, а не в проєкті. Не копіюйте його в репозиторій і не діліться ним: ключ у ньому відкритим текстом.
  • Створіть для Cline окремий ключ (до 5 на акаунт), щоб за потреби відкликати лише його.
  • Якщо ключ міг потрапити в чужі руки, відкличте його в «Налаштування» → «API».

Налаштування проксі в програмах — у розділі «Інструкції»; якщо рядки від агента не працюють — перевірка за кроками.

Як користуватися Prokso