$
ВойтиРегистрация

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