API и MCP: прокси под управлением вашего кода и ИИ-агентов

REST API или MCP: кто принимает решение

Оба интерфейса дают доступ к одним и тем же операциям. Разница в том, где живёт логика: в коде, который вы написали и проверили, или в агенте, который сам разбирает запрос и выбирает вызовы. Часто их используют вместе: API — в рабочих пайплайнах, MCP — для разовых задач и разбора проблем.

Первый запрос за три шага

Начать можно ещё до создания ключа: список стран с остатками и расчёт цены доступны без авторизации.

1. Посмотрите страны и остатки

   Ответ содержит все страны с ISO-кодами и количеством IP, доступных прямо сейчас. Параметр product_kind принимает proxy_datacenter или proxy_isp. При расчёте и заказе можно также указать proxy_personal — персональные прокси.

   bashКопировать

   curl -s "https://papaproxy.net/account_new/api/v1/billing/countries?product_kind=proxy_datacenter"

2. Рассчитайте цену для набора стран

   Расчёт бесплатный и ни к чему не обязывает. В ответе — цена каждого сегмента, скидка за объём и итог за месяц в центах. Укажите period_months 3, 6 или 12, чтобы увидеть скидку за срок.

   bashКопировать

   curl -s -X POST https://papaproxy.net/account_new/api/v1/billing/composite/quote \
     -H "Content-Type: application/json" \
     -d '{
       "product_kind": "proxy_datacenter",
       "period_months": 1,
       "segments": [
         {"country": "US", "count": 300},
         {"country": "DE", "count": 200}
       ]
     }'

3. Создайте ключ и обратитесь к своему аккаунту

   В личном кабинете откройте Настройки → API-ключи, задайте название и отметьте только нужные права. Полный ключ показывается один раз, сразу после создания, — сохраните его в менеджере секретов или переменной окружения.

   bashКопировать

   export PAPA_API_KEY="fb_..."
   
   curl -s https://papaproxy.net/account_new/api/v1/customer/services \
     -H "Authorization: Bearer $PAPA_API_KEY"

Что умеет REST API

Все пути ниже указаны относительно базового URL. Схемы запросов и ответов, коды ошибок и консоль для пробных вызовов — в справочнике API в личном кабинете.

Заказ из кода

Запрос на заказ принимает те же сегменты, что и расчёт, плюс IP для привязки и ключ идемпотентности. Если из-за сетевой ошибки запрос пришлось повторить, вернётся уже созданная услуга, а повторного списания не будет.

curl -s -X POST https://papaproxy.net/account_new/api/v1/billing/composite/order \
  -H "Authorization: Bearer $PAPA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_kind": "proxy_datacenter",
    "period_months": 1,
    "segments": [
      {"country": "US", "count": 300},
      {"country": "DE", "count": 200}
    ],
    "whitelist_ips": ["203.0.113.10"],
    "use_balance": true,
    "idempotency_key": "eu-us-500-2026-10"
  }'

MCP-сервер: личный кабинет в виде инструментов для агента

Model Context Protocol позволяет агенту узнавать, какие инструменты есть на удалённом сервере, и вызывать их. Подключите сервер PapaProxy.net один раз — и агент будет работать с аккаунтом так же, как вы: проверит остатки, сравнит цены, купит, настроит и отчитается в чате.

Подключение

Вставьте конфигурацию в настройки MCP вашего клиента. В Cursor это файл .cursor/mcp.json в проекте или ~/.cursor/mcp.json для всех проектов. Название сервера можно выбрать любое.

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

В Claude Code тот же сервер добавляется одной командой:

claude mcp add --transport http papaproxy \
  https://papaproxy.net/account_new/api/v1/mcp \
  --header "Authorization: Bearer fb_YOUR_API_KEY"

Подойдёт и любой другой MCP-клиент, который поддерживает удалённые серверы с собственными заголовками: адрес и заголовок те же.

Как агент покупает прокси

Что ещё умеет агент

Примеры запросов агенту

Права ключей: только то, что нужно

Запрос выполняется, только если у ключа есть право, которое требует эндпоинт. Права действуют одинаково для REST-вызовов и инструментов MCP: ключ без wallet:spend не сможет ничего оплатить ни через API, ни через агента.

Типовые наборы прав

Вебхуки: уведомления вместо опроса

Укажите HTTPS-адрес и выберите нужные события; актуальный список типов событий возвращает GET /customer/webhooks/events. Секрет адреса показывается только один раз, в ответе на создание, — сохраните его сразу.

• История доставок по каждому адресу: что отправлено и что ответил ваш сервер.
• Тестовое событие, чтобы проверить обработчик до прихода настоящих.
• Повторная отправка конкретного события после исправления ошибки в обработчике.
• В карточке адреса видно число неудачных доставок подряд и причину, если адрес отключён.

Защита, когда автоматика тратит деньги