Prokso MCP в Cursor: настройка mcp.json

1. Что нужно

Cursor с поддержкой MCP. Он работает с тремя транспортами — stdio, SSE и Streamable HTTP; сервер Prokso использует Streamable HTTP. Инструкция сверена с документацией Cursor о MCP по состоянию на ноябрь 2026.
Ключ API Prokso: кабинет, «Настройки» → «API» → «Создать ключ». Скопируйте ключ сразу — полностью он показывается один раз.
Проверьте ключ curl-ом по инструкции на странице «MCP-сервер Prokso».

2. Куда вписать сервер

Cursor читает MCP-серверы из двух файлов:

Файл	Где действует
`.cursor/mcp.json`	Только в этом проекте (файл в корне проекта)
`~/.cursor/mcp.json`	Во всех проектах (файл в домашней папке)

Создайте нужный файл или допишите сервер в существующий:

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

Запись ${env:PROKSO_API_KEY} Cursor заменяет значением переменной окружения. Переменные работают в полях url, headers, command, args и env. Задайте переменную, например в ~/.zshrc:

export PROKSO_API_KEY="КЛЮЧ"

Если Cursor запущен не из терминала, он может не видеть переменных из ~/.zshrc. Тогда запустите Cursor из терминала, где переменная задана, или впишите ключ прямо в глобальный файл ~/.cursor/mcp.json — он лежит вне проекта и в репозиторий не попадёт.

3. Как включить и проверить

Серверы включаются и выключаются в разделе Customize на боковой панели Cursor. Когда prokso включён, в списке Available Tools должны появиться пять инструментов: get_account, get_prices, list_plans, get_plan и get_proxy_lines. Выключенный сервер не загружается и не появляется в чате.

Если инструментов нет, откройте панель Output (Cmd+Shift+U на macOS) и выберите MCP Logs: там видно, как сервер инициализировался, вызовы инструментов и ошибки.

4. Первые запросы в чате агента

«Сколько трафика осталось на моих планах Prokso?»
«Дай 5 строк SOCKS5 с фиксированными IP в Польше для плана 12.»
«Добавь в config.py список из 10 прокси из Германии в формате url.»
«Возьми строку прокси из США и допиши в мой скрипт запрос к https://prokso.com/ip, чтобы проверить IP.»

Агент Cursor сам вызывает list_plans, чтобы найти номер плана. Точное гео (город, штат, оператор) считается вдвойне — порты и параметры описаны в справочнике шлюза.

5. Если не работает

В MCP Logs 401 с Pass your API key in the header — переменная PROKSO_API_KEY пуста для Cursor. Проверьте её и перезапустите Cursor.
401 с Invalid or revoked API key — ключ неверный или отозван. Проверьте, что в значении заголовка есть Bearer и пробел.
Cursor предлагает вход через OAuth — у сервера Prokso его нет. Убедитесь, что заголовок Authorization записан в headers именно этого сервера.
429 — превышен лимит 60 запросов в минуту на ключ, подождите.
Сервер не появляется — проверьте синтаксис JSON (запятая между серверами, кавычки) и что файл лежит именно в .cursor/mcp.json.

Другие ошибки — на странице MCP-сервера, проблемы с прокси — в проверке по шагам.

6. Безопасность ключа

Проектный .cursor/mcp.json часто коммитят вместе с кодом, поэтому ключ в него напрямую не пишите — только ${env:PROKSO_API_KEY}. Заведите для Cursor отдельный ключ: если его увидит кто-то посторонний, отзовите только его в «Настройки» → «API». Агент через MCP трафик не покупает; автоматизация с оплатой — через REST API, настройка прокси в других программах — в разделе «Инструкции».

MCP в VS Code →Как пользоваться Prokso