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