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

MCP-сервер Prokso у Windsurf

Cascade, агент редактора Windsurf, підключає віддалені MCP-сервери через Streamable HTTP. Досить одного запису в mcp_config.json, а ключ API можна тримати в змінній середовища, а не у файлі.

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

  • Windsurf з панеллю Cascade.
  • Ключ API Prokso. Створіть його в кабінеті: «Налаштування» → «API». Ключ показується повністю лише один раз.
  • Доступ до домашньої папки, де лежить файл налаштувань MCP.

Шляхи й назви полів нижче — за документацією Windsurf станом на 02.11.2026. Англійська версія тієї сторінки вже переадресовує в документацію Devin Desktop, тож у нових збірках пункти меню можуть називатися інакше. Що вміє сам сервер — на сторінці MCP-сервер Prokso.

2. Файл mcp_config.json

Відкрийте налаштування MCP: іконка MCPs угорі праворуч на панелі Cascade або Windsurf Settings → Cascade → MCP Servers. Свій сервер додають вручну в сирий файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "prokso": {
      "serverUrl": "https://prokso.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PROKSO_API_KEY}"
      }
    }
  }
}

Віддалений сервер задається полем serverUrl (Windsurf приймає і url) замість command. Запис ${env:PROKSO_API_KEY} Windsurf замінює значенням змінної середовища: підстановка працює в полях serverUrl, url і headers. Задайте змінну й перезапустіть редактор:

# macOS, Linux
export PROKSO_API_KEY=КЛЮЧ

# Windows
setx PROKSO_API_KEY КЛЮЧ

У macOS і Linux змінну бачать програми, запущені з того самого термінала, тож відкрийте Windsurf звідти. Можна вписати ключ і прямо, "Bearer КЛЮЧ": файл лежить у домашній папці, а не в проєкті, але тоді ключ прочитає кожен, хто відкриє файл.

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

  1. Збережіть файл і оновіть список серверів на панелі MCP кнопкою оновлення.
  2. У списку з'явиться prokso з п'ятьма інструментами: get_account, get_prices, list_plans, get_plan, get_proxy_lines. Cascade одночасно бачить до 100 інструментів, тож якщо серверів багато, вимкніть зайві.
  3. Напишіть у Cascade: «Через prokso покажи мій баланс». Агент має викликати get_account і показати пошту й баланс.

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

  • «Скільки трафіку лишилося на моїх планах?»
  • «Дай 5 рядків SOCKS5 з фіксованими IP у Польщі для плану 12».
  • «Які ціни за ГБ зараз діють?»
  • «Дай 3 рядки HTTP з Німеччини для плану 12 у форматі з протоколом і додай їх у конфіг мого скрапера».

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

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

  • 401 — ключ неправильний чи відкликаний, або змінна не дійшла до редактора й у заголовку пішов порожній Bearer. Перевірте змінну в тому середовищі, з якого запущено Windsurf.
  • 429 — понад 60 запитів на хвилину з одним ключем. Зачекайте стільки секунд, скільки в заголовку Retry-After.
  • Сервер не з'являється — перевірте JSON (зайва чи пропущена кома ламає весь файл) і адресу: /api/v1/mcp без слеша в кінці.

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

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. Безпека ключа

  • Ключ дає доступ до рядків проксі акаунта — тримайте його в змінній середовища й не копіюйте mcp_config.json з ключем у репозиторій.
  • Для Windsurf створіть окремий ключ (до 5 на акаунт): тоді його можна відкликати, не ламаючи інших інтеграцій.
  • Якщо ключ міг потрапити в чужі руки, відкличте його в «Налаштування» → «API».

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

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