Как подключить MCP-сервер PapaProxy.net в Cursor

Что понадобится

• Cursor на вашем компьютере. Настройка одинакова для macOS, Windows и Linux.
• Аккаунт PapaProxy.net. Доступ к API и MCP-серверу входит в аккаунт бесплатно, вы платите только за заказанные прокси.
• Node.js, Python и локальные пакеты не нужны. Сервер работает по адресу https://papaproxy.net/account_new/api/v1/mcp по протоколу Streamable HTTP, который Cursor поддерживает без дополнительных программ.

Шаг 1. Создайте ключ API с нужными правами

В личном кабинете откройте Настройки → API-ключи, назовите ключ (например, «Cursor») и выберите права. Полный ключ показывается один раз, сразу после создания. Права проверяются на нашей стороне, поэтому ограничивают агента независимо от настроек Cursor.

Начните без wallet:spend. Агент всё равно сможет рассчитать любой заказ и показать цену. Право на оплату добавьте или выпустите второй ключ, когда действительно захотите, чтобы агент покупал. Полный список прав — на странице для разработчиков.

Шаг 2. Добавьте сервер в Cursor

Cursor берёт MCP-серверы из двух файлов mcp.json и объединяет их: ~/.cursor/mcp.json действует во всех проектах, а .cursor/mcp.json в корне проекта — только в этом проекте. Если в обоих файлах есть сервер с одним именем, приоритет у файла проекта.

Способ 1: установка в один клик

Кнопка «Установить в Cursor» открывает Cursor с уже заполненным сервером — подтвердите установку. Передавать ключ в ссылке небезопасно, поэтому в настройках стоит заглушка fb_YOUR_API_KEY. Cursor сохраняет сервер в общий файл ~/.cursor/mcp.json: это файл mcp.json в скрытой папке .cursor внутри вашей домашней папки. Замените заглушку в нём:

1. Откройте файл в CursorНажмите Cmd+O в macOS или Ctrl+O в Windows и Linux и введите путь в окне выбора файла. Папка .cursor скрытая, поэтому при обычном просмотре её не видно, но по введённому пути файл откроется сразу.
   • macOS: нажмите Cmd+Shift+G и вставьте ~/.cursor/mcp.json. Из Терминала то же делает команда open -a Cursor ~/.cursor/mcp.json.
   • Windows: вставьте %USERPROFILE%\.cursor\mcp.json в поле «Имя файла». Полный путь — C:\Users\<имя пользователя>\.cursor\mcp.json.
   • Linux: нажмите Ctrl+L и вставьте ~/.cursor/mcp.json.
2. Замените заглушкуНайдите запись papaproxy-net и строку с fb_YOUR_API_KEY. Замените только заглушку на свой ключ, а слово Bearer и пробел перед ключом оставьте. Если в файле есть другие серверы, их не трогайте.
   Было и стало

   "Authorization": "Bearer fb_YOUR_API_KEY"
   "Authorization": "Bearer fb_…ваш ключ…"

3. Сохраните и переподключитеСохраните файл (Cmd+S или Ctrl+S). Затем откройте Customize и выключите и снова включите сервер или перезапустите Cursor, чтобы он подключился с новым ключом.

Способ 2: правка mcp.json

Добавьте запись papaproxy-net в объект mcpServers. Удалённому серверу нужны только url и headers: ни command, ни поля с транспортом не требуется. Имя сервера можно выбрать любое.

{
  "mcpServers": {
    "papaproxy-net": {
      "url": "https://papaproxy.net/account_new/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer fb_YOUR_API_KEY"
      }
    }
  }
}

Значение заголовка должно начинаться с Bearer и пробела. Сохраните файл. Если сервер не появился в разделе Customize, перезапустите Cursor.

Способ 3: ключ в переменной окружения

Подходит, если .cursor/mcp.json лежит в репозитории. Cursor подставляет ${env:NAME} в url и headers: в файле указано только имя переменной, а каждый разработчик хранит свой ключ вне Git.

{
  "mcpServers": {
    "papaproxy-net": {
      "url": "https://papaproxy.net/account_new/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PAPAPROXY_API_KEY}"
      }
    }
  }
}

export PAPAPROXY_API_KEY="fb_..."

Cursor читает переменную при запуске, поэтому после добавления строки полностью закройте его и откройте снова. В Windows задайте переменную в «Свойствах системы» → «Переменные среды». Параметр envFile работает только для локальных (stdio) серверов, для удалённых он не подходит.

Шаг 3. Проверьте подключение

Откройте Customize на боковой панели Cursor и найдите papaproxy-net среди MCP-серверов. Сервер должен быть включён и показывать список инструментов. Затем откройте чат с агентом и отправьте запрос, который ничего не стоит:

Через MCP-сервер papaproxy-net покажи страны, где есть серверные прокси, и рассчитай цену 100 IP в США на месяц. Ничего не покупай.

Агент должен вызвать list_countries и quote_composite и ответить ценой в долларах. Расчёт цены бесплатный, ничего не резервирует и не списывает. Если вызов завершился ошибкой, загляните в раздел «Решение проблем».

Разрешения: что агенту можно запускать без подтверждения

По умолчанию Cursor спрашивает разрешение перед каждым вызовом инструмента MCP и показывает аргументы, если развернуть вызов. Для инструментов MCP действуют те же режимы, что и для команд терминала. Они задаются в Settings → Agents → Approvals & Execution: Auto-review, Allowlist или Run Everything.

Подтверждения в Cursor — это удобство, а не защита: в документации Cursor прямо сказано, что классификатор Auto-review может ошибаться. Настоящее ограничение — права ключа. Ключ без wallet:spend ничего не оплатит, в каком бы режиме ни работал Cursor, а ключ с этим правом платит только с баланса аккаунта.

Что делать с этим в Cursor

Cursor и так пишет и запускает ваши парсеры. С подключённым MCP-сервером в том же чате можно управлять прокси, на которых они работают.

Все 56 инструментов с нужными правами и REST-эндпоинтами описаны в справочнике API (на английском). Когда сценарий превращается в регулярную задачу по расписанию, перенесите его на REST API: обычный код дешевле и проще тестировать, чем агента.

Решение проблем: MCP в Cursor не работает

Начните с логов: откройте панель Output (Cmd+Shift+U в macOS, Ctrl+Shift+U в Windows и Linux) и выберите MCP Logs. Там видны попытка подключения, каждый вызов инструмента и ответ сервера.

Если в логах ошибка сервера, а не настройки, напишите в поддержку и укажите время неудачного вызова — мы проверим его на своей стороне.

Другие MCP-клиенты

Тот же адрес и заголовок работают и в других клиентах, отличаются только файл настроек и его формат. Есть пошаговые руководства для Claude Code и n8n, а настройка для VS Code, Windsurf, Cline, Codex CLI, Gemini CLI и Claude Desktop — на странице для разработчиков.