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

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