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

> Страница: https://papaproxy.net/ru/developers/mcp/cursor.php. MCP-сервер PapaProxy.net даёт агенту Cursor 56 инструментов для прокси-аккаунта: наличие IP, расчёт цены, заказы, привязка по IP, выгрузка списка прокси и анализ ошибок. Это удалённый сервер на Streamable HTTP, локально ничего ставить не нужно.

- Адрес MCP: `https://papaproxy.net/account_new/api/v1/mcp`
- Авторизация: заголовок `Authorization: Bearer <api_key>`
- Создать ключ: личный кабинет → Настройки → API-ключи (https://papaproxy.net/account_new/settings#api-keys). Полный ключ показывается один раз.
- Стоимость: входит в каждый аккаунт, оплачиваются только заказанные прокси.

## Шаг 1. Ключ API с нужными правами

Права проверяются на сервере, поэтому ограничивают агента независимо от настроек Cursor.

| Что должен делать агент | Права |
|---|---|
| Только анализ: наличие IP, цены, услуги, статистика, ошибки | `catalog:read`, `services:read`, `usage:read` |
| Ещё и настройка: привязка по IP, логины и пароли, автопродление | то же плюс `services:write` |
| Ещё и оплата с баланса: заказы, продления, дополнения, докупка IP | то же плюс `wallet:read`, `wallet:spend` |

Начните без `wallet:spend`: агент всё равно сможет рассчитать любой заказ.

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

Cursor читает `~/.cursor/mcp.json` (все проекты) и `.cursor/mcp.json` (один проект) и объединяет их; при совпадении имён приоритет у файла проекта.

Способ 1, установка в один клик: https://papaproxy.net/ru/developers/mcp/cursor.php#one-click добавляет сервер с заглушкой `fb_YOUR_API_KEY` в общий файл `~/.cursor/mcp.json` (скрытая папка `.cursor` в домашней папке). Чтобы заменить заглушку:

1. Откройте файл в Cursor через Cmd+O (macOS) или Ctrl+O (Windows, Linux) и введите путь: в 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 ` перед ним оставьте. Другие серверы не трогайте.
3. Сохраните файл, затем выключите и включите сервер в Customize или перезапустите Cursor.

Способ 2, `mcp.json` (удалённому серверу нужны только `url` и `headers`; значение начинается с `Bearer ` и пробела):

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

Способ 3, ключ в переменной окружения (для `.cursor/mcp.json` в репозитории; Cursor подставляет `${env:NAME}` в `url` и `headers`):

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

Задайте `export PAPAPROXY_API_KEY="fb_..."` в `~/.zshrc` или `~/.bashrc` (в Windows — в «Свойствах системы» → «Переменные среды»), затем закройте и снова откройте Cursor. `envFile` работает только для локальных stdio-серверов.

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

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

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

Агент должен вызвать `list_countries` и `quote_composite`. Расчёт цены бесплатный и ничего не резервирует.

## Разрешения

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

- Можно добавить в allowlist (только чтение): `list_countries`, `quote_composite`, `list_services`, `get_service`, `list_proxy_ips`, `get_whitelist`, `get_usage_overview`, `get_diagnostics`, `get_recommendations`, `wallet_balance`.
- Оставьте с подтверждением (списывают с баланса или меняют доступ): `order_composite`, `order_dedicated`, `add_ips`, `renew_service`, `purchase_addon`, `refresh_ips`, `rotate_proxy_credentials`, `remove_whitelist_ip`. Для `cancel_service` и `disable_addon` нужно ещё `confirm: true`.

Настоящее ограничение — права ключа, а не подтверждения Cursor: ключ без `wallet:spend` ничего не оплатит, а ключ с ним платит только с баланса аккаунта.

## Сценарии

- Парсер на актуальных прокси: агент использует `list_services` и `list_proxy_ips` и пишет код, который загружает список прокси из REST API при запуске и берёт ключ из `PAPAPROXY_API_KEY`.
- Привязка IP: `get_my_ip` возвращает IP, с которого пришёл запрос (для Cursor на компьютере обычно ваш внешний IP); `add_whitelist_ip` добавляет его.
- Разбор ошибок: `get_usage_timeseries`, `get_diagnostics` (ошибки по кодам ответа и сайтам), `get_top_destinations`, `get_recommendations`.
- Цена до покупки: `list_countries`, `quote_composite`; с `wallet:spend` — `order_composite` с ключом идемпотентности.

Все инструменты с правами и REST-эндпоинтами: https://papaproxy.net/developers/reference/#mcp-tools (на английском). Для регулярных задач по расписанию используйте REST API: https://papaproxy.net/ru/developers.php#api.

## Решение проблем

Логи: панель Output (Cmd+Shift+U в macOS, Ctrl+Shift+U в Windows и Linux) → MCP Logs.

| Что видно | Причина и решение |
|---|---|
| `Missing or malformed Authorization header` | Нет блока `headers`, или значение не начинается с `Bearer `; при ключе в переменной она может быть пустой — задайте её и перезапустите Cursor |
| `Invalid or revoked API key` | Опечатка, отозванный ключ или оставленная заглушка `fb_YOUR_API_KEY` |
| Вызов падает с ошибкой прав | У ключа нет нужного права; ошибки приходят текстом с коротким кодом и пояснением |
| Вызовы падают после серии запросов | 60 запросов в минуту на аккаунт, общий лимит для всех ключей API и MCP-сервера |
| Сервера нет в списке или нет инструментов | Некорректный JSON (например, лишняя запятая), сервер выключен в Customize или Cursor не перезапущен |
| Локально работает, в Cloud Agents — нет | У Cloud Agents своя конфигурация MCP; добавьте сервер там отдельно |

Ошибки сервера: напишите на support@papaproxy.net и укажите время неудачного вызова.

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

Руководство для Claude Code: https://papaproxy.net/ru/developers/mcp/claude-code.md. Руководство для n8n: https://papaproxy.net/ru/developers/mcp/n8n.md. VS Code, Windsurf, Cline, Codex CLI, Gemini CLI, Claude Desktop: https://papaproxy.net/ru/developers.php#mcp