# Как управлять прокси через ИИ-агента: 4 рабочих сценария > Агент уже умеет писать и запускать парсер. С MCP-сервером он может управлять и прокси под ним: посчитать цену, обновить привязку по IP, выяснить, почему выросли ошибки, и продлить услуги. Ниже четыре сценария: запрос, что делает агент и что вы получаете в итоге. - Источник: https://papaproxy.net/ru/blog/manage-proxies-with-ai-agent.php - Опубликовано: 2026-10-05 - Автор: Alex Young - Рубрика: Автоматизация · Блог PapaProxy.net --- ## Ключевые выводы - MCP-сервер PapaProxy.net даёт Cursor, Claude Code и другим MCP-клиентам 50 инструментов для работы с аккаунтом, без доплаты. - Заведите два ключа: для мониторинга — на каждый день, для закупки с `wallet:spend` — только когда агенту нужно платить. - Для расчёта цены ключ не нужен: остатки по странам и расчёт стоимости открыты всем. - Самый полезный сценарий — диагностика: агент сравнивает использование по времени, разбивает ошибки по категориям и предлагает решение. - Когда сценарий начинает повторяться по расписанию, переносите его в код на REST API и вебхуки. ИИ-агенты уже пишут парсеры, запускают их и чинят, когда сайт меняет вёрстку. А прокси под этими парсерами по-прежнему настраивают вручную: зайти в личный кабинет, найти нужную услугу, скопировать список IP, обновить привязку по IP после каждой смены адреса сервера. Всё меняется, когда агент получает доступ к аккаунту через MCP-сервер. Вместо того чтобы переключаться в личный кабинет, вы пишете в чате, какой нужен результат, а агент сам выбирает вызовы, выполняет их и показывает итог. В статье четыре сценария: расчёт цены, обновление привязки по IP, разбор ошибок и ежемесячная проверка услуг. Для каждого — запрос, шаги агента, нужные права ключа и результат. ## Что агент может делать с вашим аккаунтом MCP-сервер PapaProxy.net — удалённый сервер по протоколу Model Context Protocol с 50 инструментами для работы с аккаунтом: остатки и цены, заказы и продления, привязка по IP, логины и пароли, замена IP, статистика использования, финансы и тикеты поддержки. Он работает с Cursor, Claude Code и любым MCP-клиентом, который поддерживает удалённые серверы с заголовками. Доступ входит в любой аккаунт без доплаты. [Полный список инструментов и эндпоинтов](/ru/developers.php#mcp) — на странице для разработчиков. Здесь речь о том, как они складываются в работу. ## Перед началом: два ключа вместо одного У каждого API-ключа есть набор прав, и MCP-сервер проверяет их так же, как REST API. Поэтому главный инструмент безопасности — сам ключ, и ключей лучше завести два. Первый — **ключ для мониторинга** с правами `services:read` и `usage:read`. Он нужен для повседневных вопросов: что сейчас активно, что скоро закончится, откуда выросли ошибки. Агент с таким ключом видит всё о ваших услугах, но ничего не может изменить. Второй — **ключ для закупки**: к нему добавляются `wallet:spend`, а также `services:write` и `catalog:read`, если они нужны. Переключайтесь на него, только когда агенту действительно нужно купить, продлить услугу или оплатить внеплановую замену IP. Без `wallet:spend` агент может анализировать, считать и настраивать, но не может ничего оплатить. Что разрешает каждое право — в [таблице прав](/ru/developers.php#scopes) на странице для разработчиков. ## Сценарий 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-прокси](/ru/isp-proxy.php) в США и Испании на 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`. **Результат:** диагноз с цифрами и точечное исправление — вместо того чтобы менять весь список [серверных прокси](/ru/server-proxy.php) в надежде, что ошибки пропадут. ## Сценарий 4: ежемесячная проверка услуг **Ключ:** `services:read` для проверки. Для продления нужны ещё `services:write` и `wallet:spend`. **Запрос:** > Какие услуги заканчиваются в этом месяце и у каких из них выключено автопродление? **Что делает агент:** выводит список услуг с датами окончания и статусом автопродления и отмечает те, что могут закончиться. Дальше можно попросить включить автопродление или сразу продлить услугу на 1, 3, 6 или 12 месяцев со скидкой за срок. Прежде чем что-то оплачивать, попросите агента показать итоговую сумму и дождаться вашего подтверждения. Cursor и Claude Code тоже обычно спрашивают разрешение на каждый вызов инструмента, если вы не включили автоматическое подтверждение. **Результат:** проверка продлений одним запросом вместо обхода всех услуг, и ни одной оплаты без вашего явного согласия. ## Чего агент сделать не может Границы задают ключ и биллинг, а не решения агента: - **Без `wallet:spend` он не может платить.** Ключ без этого права читает, считает и настраивает, но любая покупка, продление или платная замена будут отклонены. - **Он платит только с баланса.** Данные карты остаются у платёжной системы, агенту они недоступны. - **Повторный запрос не создаст второй заказ.** Заказы, продления, платная замена IP и пополнения принимают ключ идемпотентности: повтор вернёт исходный результат, а не спишет деньги ещё раз. - **Ключ можно отозвать в любой момент.** По каждому ключу видно, когда и с какого IP он использовался. Подробнее — в [разделе о защите](/ru/developers.php#safety) на странице для разработчиков. ## Подключение за две минуты Сначала [создайте API-ключ](https://papaproxy.net/account_new/settings?locale=ru#api-keys) в личном кабинете в разделе «Настройки → API-ключи» с правами из раздела выше. **Cursor:** [установите сервер в один клик](cursor://anysphere.cursor-deeplink/mcp/install?name=papaproxy&config=eyJ1cmwiOiJodHRwczovL3BhcGFwcm94eS5uZXQvYWNjb3VudF9uZXcvYXBpL3YxL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciBmYl9ZT1VSX0FQSV9LRVkifX0%3D), затем замените `fb_YOUR_API_KEY` своим ключом в настройках MCP. **Claude Code:** выполните одну команду: BashКопировать код ```bash claude mcp add --transport http papaproxy \ https://papaproxy.net/account_new/api/v1/mcp \ --header "Authorization: Bearer fb_YOUR_API_KEY" ``` Другие клиенты и ручная настройка `mcp.json` — в разделе [подключение MCP-сервера](/ru/developers.php#mcp). Готовые файлы конфигурации есть и в нашем [репозитории на GitHub](https://github.com/alexyoungpapaproxy/papaproxy-mcp). ## Когда переходить с MCP на API MCP лучше всего подходит для разовых задач и диагностики: вы описываете результат, агент сам подбирает вызовы. У этой гибкости есть обратная сторона: агент каждый раз заново интерпретирует запрос, поэтому последовательность вызовов от раза к разу может отличаться. Когда сценарий начинает повторяться по расписанию, его стоит перенести в код. Обновлять привязку по IP при каждом деплое, получать свежий список прокси перед каждым запуском парсера, выгружать счета в конце месяца — всё это надёжнее делать скриптом на REST API с вебхуками. Скрипт каждый раз выполняет одни и те же вызовы, и его можно протестировать. С этим переходом агент тоже поможет. Попросите его один раз выполнить операцию и показать ответ API как есть, а затем напишите тот же вызов в коде. Все эндпоинты описаны в [справочнике API](/developers/reference/) (на английском), а [спецификацию OpenAPI](/openapi.json) можно загрузить в генератор кода или дать агенту прочитать напрямую. ## Частые вопросы ### Видит ли агент пароли от прокси? Да, если у ключа есть право `services:read`. Оно включает данные для подключения: пароли по умолчанию скрыты, но агент может запросить их в открытом виде. Поэтому ключ нельзя вставлять в текст запроса и коммитить в репозиторий — храните его в конфигурации MCP-клиента или в менеджере секретов. ### Что, если агент закажет не то? Просите расчёт цены перед любым заказом и выдавайте агенту ключ с `wallet:spend`, только когда действительно собираетесь покупать. Если лишняя услуга всё же заказана, её можно отменить: неиспользованное оплаченное время вернётся на баланс пропорционально. Подробные условия — в разделе [гарантии и возврат средств](/ru/docs/guarantees.php). ### Можно ли пользоваться всей командой? Да. API-ключей можно создать сколько угодно и назвать как удобно, так что схему выбираете вы: ключ на каждого сотрудника, на каждую интеграцию или на каждое окружение. С отдельными ключами любой можно отозвать, не затрагивая остальные, а по каждому видно, когда и с какого IP он использовался. ### Нужно ли агенту знать API? Нет. MCP-сервер сам описывает агенту каждый инструмент, и агент выбирает нужные по вашему запросу. Достаточно своими словами описать, что вам нужно. [Создать API-ключ](https://papaproxy.net/account_new/settings?locale=ru#api-keys) [Попробовать прокси 48 часов](/ru/free-test.php) Впервые в новом личном кабинете? Вот [что в нём изменилось](/ru/new-dashboard.php).