Как управлять прокси через ИИ-агента: 4 рабочих сценария

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

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

В статье четыре сценария: расчёт цены, обновление привязки по IP, разбор ошибок и ежемесячная проверка услуг. Для каждого — запрос, шаги агента, нужные права ключа и результат.

Что агент может делать с вашим аккаунтом

MCP-сервер PapaProxy.net — удалённый сервер по протоколу Model Context Protocol с 50 инструментами для работы с аккаунтом: остатки и цены, заказы и продления, привязка по IP, логины и пароли, замена IP, статистика использования, финансы и тикеты поддержки. Он работает с Cursor, Claude Code и любым MCP-клиентом, который поддерживает удалённые серверы с заголовками. Доступ входит в любой аккаунт без доплаты.

Полный список инструментов и эндпоинтов — на странице для разработчиков. Здесь речь о том, как они складываются в работу.

Перед началом: два ключа вместо одного

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

Первый — ключ для мониторинга с правами services:read и usage:read. Он нужен для повседневных вопросов: что сейчас активно, что скоро закончится, откуда выросли ошибки. Агент с таким ключом видит всё о ваших услугах, но ничего не может изменить.

Второй — ключ для закупки: к нему добавляются wallet:spend, а также services:write и catalog:read, если они нужны. Переключайтесь на него, только когда агенту действительно нужно купить, продлить услугу или оплатить внеплановую замену IP. Без wallet:spend агент может анализировать, считать и настраивать, но не может ничего оплатить.

Что разрешает каждое право — в таблице прав на странице для разработчиков.

Сценарий 1: посчитать цену, ничего не покупая

Ключ: не нужен. Остатки по странам и расчёт стоимости доступны всем.

Запрос: подойдёт промпт из блока «Попробуйте без ключа» на странице для разработчиков:

Прочитай https://papaproxy.net/ru/developers.md. Через открытые эндпоинты, описанные там (API-ключ не нужен), покажи, в каких странах сейчас есть серверные прокси в наличии, и рассчитай цену 100 IP в США на 1 месяц. Затем расскажи, что ты сможешь делать с моим аккаунтом PapaProxy.net, когда я подключу MCP-сервер с API-ключом.

Что делает агент: читает памятку для разработчиков, проверяет остатки по странам через открытый список и запрашивает расчёт цены. Попросите повторить расчёт на 3, 6 и 12 месяцев — он покажет скидку за срок рядом. Когда MCP-сервер подключён, те же шаги идут через инструменты list_countries и quote_composite.

Запрос можно сделать таким же конкретным, как ваш проект: «300 IP в США и 200 в Германии» или «1 000 ISP-прокси в США и Испании на 3 месяца». Если в какой-то стране не хватает IP, это будет видно в расчёте ещё до оплаты.

Результат: готовая конфигурация с ценой по одному запросу, ещё до регистрации. Так удобно сравнивать варианты — например, одну страну и микс стран или серверные прокси и ISP.

Сценарий 2: у офиса сменился IP

Ключ: services:read и services:write.

Запрос:

У офиса сменился IP на 198.51.100.24 — обнови привязку по IP во всех активных услугах.

Что делает агент: получает список услуг и оставляет активные. В каждой читает текущую привязку по IP, добавляет новый адрес через add_whitelist_ip и удаляет старый. Полезно сразу назвать и старый адрес или попросить агента уточнить, какую запись заменить, — чтобы он не удалил IP, с которого ещё работают ваши серверы. А если сначала добавить новый адрес и только потом удалить старый, доступ не прервётся.

В привязку добавляются отдельные IPv4-адреса, подсети CIDR не принимаются, так что агент добавит ровно тот адрес, который вы назвали.

Результат: сводка по строке на услугу: что удалено и что добавлено. В личном кабинете то же самое — это открыть каждую услугу, найти привязку, добавить новый IP и удалить старый. При 5–10 услугах выходят десятки кликов, и одну легко пропустить.

Сценарий 3: выросли ошибки — выясняем почему

Ключ: usage:read для анализа. Для замены IP — services:write, а если замена платная, ещё и wallet:spend.

Запрос:

Почему вчера выросло число ошибок на серверных прокси? Разбей по категориям.

Что делает агент: здесь он не просто выполняет команду, а разбирается в проблеме. Сравнивает использование по времени через get_usage_timeseries, чтобы найти момент, когда начались ошибки. Разбивает их по категориям и кодам ответа через get_diagnostics и смотрит, на каких хостах они сосредоточены. Затем через get_recommendations предлагает, что изменить.

Обычно разбор указывает на одну из нескольких причин. Ошибки авторизации на всех хостах, как правило, означают проблему с логином и паролем или с привязкой по IP на вашей стороне. Ошибки на одном сайте, например HTTP 403 или 429, говорят о том, что этот сайт ограничивает частоту запросов или блокирует отдельные IP. Таймауты в определённые часы часто связаны с числом одновременных подключений или частотой запросов.

Если на одном сайте блокируют несколько IP, продолжите:

Замени только те IP, которые блокируют.

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

Результат: диагноз с цифрами и точечное исправление — вместо того чтобы менять весь список серверных прокси в надежде, что ошибки пропадут.

Сценарий 4: ежемесячная проверка услуг

Ключ: services:read для проверки. Для продления нужны ещё services:write и wallet:spend.

Запрос:

Какие услуги заканчиваются в этом месяце и у каких из них выключено автопродление?

Что делает агент: выводит список услуг с датами окончания и статусом автопродления и отмечает те, что могут закончиться. Дальше можно попросить включить автопродление или сразу продлить услугу на 1, 3, 6 или 12 месяцев со скидкой за срок.

Прежде чем что-то оплачивать, попросите агента показать итоговую сумму и дождаться вашего подтверждения. Cursor и Claude Code тоже обычно спрашивают разрешение на каждый вызов инструмента, если вы не включили автоматическое подтверждение.

Результат: проверка продлений одним запросом вместо обхода всех услуг, и ни одной оплаты без вашего явного согласия.

Чего агент сделать не может

Границы задают ключ и биллинг, а не решения агента:

• Без wallet:spend он не может платить. Ключ без этого права читает, считает и настраивает, но любая покупка, продление или платная замена будут отклонены.
• Он платит только с баланса. Данные карты остаются у платёжной системы, агенту они недоступны.
• Повторный запрос не создаст второй заказ. Заказы, продления, платная замена IP и пополнения принимают ключ идемпотентности: повтор вернёт исходный результат, а не спишет деньги ещё раз.
• Ключ можно отозвать в любой момент. По каждому ключу видно, когда и с какого IP он использовался.

Подробнее — в разделе о защите на странице для разработчиков.

Подключение за две минуты

Сначала создайте API-ключ в личном кабинете в разделе «Настройки → API-ключи» с правами из раздела выше.

Cursor: установите сервер в один клик, затем замените fb_YOUR_API_KEY своим ключом в настройках MCP.

Claude Code: выполните одну команду:

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

Другие клиенты и ручная настройка mcp.json — в разделе подключение MCP-сервера. Готовые файлы конфигурации есть и в нашем репозитории на GitHub.

Когда переходить с MCP на API

MCP лучше всего подходит для разовых задач и диагностики: вы описываете результат, агент сам подбирает вызовы. У этой гибкости есть обратная сторона: агент каждый раз заново интерпретирует запрос, поэтому последовательность вызовов от раза к разу может отличаться.

Когда сценарий начинает повторяться по расписанию, его стоит перенести в код. Обновлять привязку по IP при каждом деплое, получать свежий список прокси перед каждым запуском парсера, выгружать счета в конце месяца — всё это надёжнее делать скриптом на REST API с вебхуками. Скрипт каждый раз выполняет одни и те же вызовы, и его можно протестировать.

С этим переходом агент тоже поможет. Попросите его один раз выполнить операцию и показать ответ API как есть, а затем напишите тот же вызов в коде. Все эндпоинты описаны в справочнике API (на английском), а спецификацию OpenAPI можно загрузить в генератор кода или дать агенту прочитать напрямую.

Частые вопросы

Впервые в новом личном кабинете? Вот что в нём изменилось.