Работает ли это в n8n Cloud и в n8n на своём сервере?

Да. Ноды MCP Client Tool и MCP Client встроены в n8n, а наш сервер доступен по HTTPS из обоих вариантов. Разница — в авторизации прокси в нодах HTTP Request: в n8n Cloud используйте логин и пароль, потому что исходящие IP-адреса там общие для множества инстансов.

Нужен ли AI Agent, чтобы работать с MCP-сервером в n8n?

Нет. Нода MCP Client вызывает один инструмент как обычный шаг сценария, без языковой модели. Она подходит для отчётов и оповещений по расписанию, а MCP Client Tool с AI Agent — когда запросы разные и инструменты должна выбирать модель.

Попадает ли API-ключ в экспорт сценария?

Нет. Ключ хранится в учётных данных n8n. В экспортированный JSON сценария попадают имя и ID учётных данных, поэтому не пишите ключ в имени. Если ключ мог утечь, отзовите его в личном кабинете в разделе Настройки → API-ключи и создайте новый.

Может ли агент в n8n купить прокси без подтверждения?

Только если у его ключа есть право wallet:spend , и только в пределах баланса аккаунта. Без этого права платные вызовы отклоняются на нашей стороне. Если право есть, вынесите платные инструменты в отдельную ноду MCP Client Tool за шагом ручного подтверждения.

MCP-сервер платный?

Нет. MCP-сервер и REST API входят в каждый аккаунт PapaProxy.net, оплачиваются только заказанные прокси и дополнения. Языковую модель для AI Agent оплачиваете её провайдеру; нода MCP Client модель не использует.

Интеграция MCP

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

В n8n MCP-сервер PapaProxy.net работает двумя способами. ИИ-агент получает 56 инструментов и сам решает, какие вызвать, чтобы ответить на вопрос или выполнить действие в аккаунте. А обычный шаг сценария вызывает один заданный инструмент по расписанию — без языковой модели. В обоих случаях адрес, ключ и учётные данные в n8n одни и те же. В конце — как пустить ноды HTTP Request через ваши прокси.

Создать API-ключ Выбрать ноду Скачать руководство в .md для агента

Какую ноду выбрать
Ключ и учётные данные
AI Agent
Подтверждение действий
Шаги без модели
Готовые сценарии
Прокси в HTTP Request
Решение проблем
Вопросы и ответы

Какую ноду выбрать

В n8n две встроенные MCP-ноды, и задачи у них разные. Главный вопрос — кто выбирает инструмент: модель или вы.

Нода	Кто выбирает инструмент	Для чего подходит
MCP Client Tool на входе Tool ноды AI Agent	Модель, по смыслу запроса	Чат-боты и запросы своими словами: «Что сегодня не так с моими прокси?» Каждый запуск расходует токены модели.
MCP Client — обычный шаг сценария	Вы, когда собираете сценарий	Отчёты и оповещения по расписанию. Каждый раз вызывается один и тот же инструмент с теми же параметрами, модель не участвует.
HTTP Request (не MCP)	Вы	Прямые запросы к REST API (справочник на английском) или собственный трафик сценария через ваши прокси (см. ниже).

Инструменты аналитики, например get_usage_overview и get_diagnostics, доступны только через MCP. Чтобы получать их данные в сценарии по расписанию без агента, используйте ноду MCP Client.

Шаг 1. Ключ и учётные данные в n8n

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

Сценарий	Права ключа
Отчёты о трафике и ошибках	`services:read`, `usage:read`
Оповещение о низком балансе	`wallet:read`
Чат-бот с ценами для команды	`catalog:read`
Привязка IP сервера n8n	`services:read`, `services:write`, `customer:read`
Агент, который заказывает и продлевает	права выше плюс `wallet:read` и `wallet:spend` — вместе с ручным подтверждением

Затем сохраните ключ в n8n:

Откройте форму учётных данных. В MCP-ноде, которую добавляете, выберите в Authentication вариант Bearer Auth, затем раскройте список Credential и нажмите Create new credential.
Вставьте ключ. В поле Bearer Token — только сам ключ, он начинается с fb_. Слово Bearer не пишите: n8n добавит его в заголовок сам.
Назовите и сохраните. Имя — нейтральное, например «PapaProxy.net — отчёты».

Учётные данные n8n хранит отдельно от сценариев. В экспортированный JSON сценария попадают имя и ID учётных данных, но не сам ключ, так что сценарием можно делиться, не раскрывая ключ. Поэтому не пишите ключ или его часть в имени.

Вариант 1. Инструменты для AI Agent

Нужна нода AI Agent с подключённой языковой моделью, например после Chat Trigger. Нажмите + у входа Tool, найдите MCP Client Tool и заполните поля:

MCP Client Tool

Endpoint:           https://papaproxy.net/account_new/api/v1/mcp
Server Transport:   HTTP Streamable
Authentication:     Bearer Auth
Credential:         PapaProxy.net — отчёты
Tools to Include:   Selected

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

Tools to Include → Selected

list_services
get_service
get_usage_overview
get_usage_timeseries
get_top_destinations
get_diagnostics
get_recommendations

В системном сообщении объясните агенту его задачу. Суммы инструменты возвращают в центах — скажите, как их показывать:

AI Agent → Options → System Message

Ты управляешь прокси в аккаунте PapaProxy.net через инструменты PapaProxy.net.
Суммы из инструментов — в центах США; показывай их в долларах, например $12.50.
Перед любым платным действием сначала получи расчёт цены и покажи его.
Если инструмент вернул ошибку, назови её короткий код и объясни одним предложением.

Откройте чат и отправьте запрос, который ничего не стоит, например: «На каком из моих сервисов за неделю больше всего ошибок и почему?» В журнале выполнения видно, какие инструменты вызвал агент и что они вернули.

Ручное подтверждение платных действий

n8n умеет ставить сценарий на паузу перед вызовом конкретного инструмента и спрашивать человека — в Slack, Telegram, Microsoft Teams, Discord, Gmail или чате n8n, — разрешить вызов или отклонить. Подтверждение действует на инструменты, подключённые к шагу проверки, поэтому разделите инструменты PapaProxy.net на две ноды MCP Client Tool с одинаковым адресом и ключом:

«PapaProxy.net — чтение», напрямую к агентуИнструменты только для чтения, их агент вызывает когда угодно: list_countries, quote_composite, list_services, get_service, get_usage_overview, get_diagnostics, wallet_balance. Они ничего не меняют и ничего не списывают.

«PapaProxy.net — заказы», через подтверждениеИнструменты, которые списывают деньги с баланса или меняют доступ: order_composite, add_ips, renew_service, purchase_addon, refresh_ips, add_whitelist_ip, remove_whitelist_ip.

Добавьте шаг проверки. Нажмите на вход Tool у AI Agent, чтобы открыть панель инструментов, найдите раздел Human review и выберите канал, который читает ваша команда.
Подключите к нему платные инструменты. Ноду «заказы» соедините со входом инструментов шага проверки, а не самого агента.
Составьте текст запроса. В {{ $tool.name }} приходит имя ноды — поэтому ей нужно понятное имя, — а в {{ $tool.parameters }} то, что агент хочет отправить: страны, число IP, срок.

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

Вариант 2. Инструмент как обычный шаг, без модели

Нода MCP Client вызывает один выбранный вами инструмент и передаёт результат следующей ноде, как любой другой шаг. Ей не нужны AI Agent и языковая модель, поэтому проверка по расписанию не расходует токены и каждый раз возвращает данные одной и той же структуры.

MCP Client

Server Transport:   HTTP Streamable
MCP Endpoint URL:   https://papaproxy.net/account_new/api/v1/mcp
Authentication:     Bearer Auth
Credential:         PapaProxy.net — отчёты
Tool:               get_diagnostics
Input Mode:         Manual

Список Tool загружается с нашего сервера, а в режиме Manual нода показывает параметры выбранного инструмента. Режим JSON позволяет передать параметры из предыдущих нод выражением. Наши инструменты возвращают JSON, и нода кладёт его в structuredContent, так что следующие ноды читают поля напрямую — например, {{ $json.structuredContent.balance_cents }} после wallet_balance.

Готовые сценарии

Для каждого сценария указаны ноды по порядку и права ключа. Начинайте с ключа, который может только читать.

Утренняя сводка ошибокSchedule Trigger → MCP Client → MCP Client → SlackКаждое утро вызывайте get_usage_overview — общее число запросов и доля успешных, — затем get_diagnostics — ошибки по кодам и категориям — и отправляйте обе сводки в канал. Модель не нужна. Права: services:read, usage:read.

Оповещение о низком балансеSchedule Trigger → MCP Client → If → TelegramРаз в несколько часов вызывайте wallet_balance. В ноде If проверьте, что {{ $json.structuredContent.balance_cents }} меньше 2000, то есть $20.00, и отправьте напоминание пополнить баланс до автопродления. Права: wallet:read.

Чат-бот с ценами для командыChat Trigger → AI Agent + MCP Client ToolОтметьте только list_countries, get_pricing_info и quote_composite. Коллеги спрашивают «Сколько стоят 300 IP в Германии на три месяца?» и получают актуальный расчёт. С одним правом catalog:read ключ не видит ваших сервисов и ничего не купит.

Привязка IP своего сервера n8nManual Trigger → MCP Client → MCP Clientget_my_ip возвращает IP, с которого пришёл запрос, — для n8n на своём сервере это внешний IP сервера. Передайте его в add_whitelist_ip вместе с ID сервиса, и ноды HTTP Request смогут работать через прокси без пароля. В n8n Cloud так делать нельзя — почему.

Следите за частотой запросов в циклах. Лимит — 60 запросов в минуту на аккаунт, общий для всех API-ключей и MCP-сервера. Нода MCP Client внутри Loop Over Items делает по вызову на каждый элемент, поэтому в длинные циклы добавьте ноду Wait или получайте данные одним вызовом, где инструмент это позволяет.

Не отдавайте длинные списки модели. list_proxy_ips возвращает весь список IP сервиса одним ответом. В AI Agent этот список попадает в контекст модели и расходует токены на каждом следующем шаге. Вызывайте его из ноды MCP Client и разбирайте результат нодами Split Out или Code.

Все 56 инструментов с нужными правами и соответствующими методами REST API — в справочнике API (на английском).

Запросы HTTP Request через ваши прокси

MCP управляет аккаунтом с прокси. Чтобы собственные запросы сценария — например, при парсинге сайта — шли через прокси, задайте прокси в ноде HTTP Request: Add option → Proxy. IP, HTTP-порт, логин и пароль возьмите из списка прокси в личном кабинете.

HTTP Request → Options → Proxy

http://ЛОГИН:ПАРОЛЬ@IP:ПОРТ

Здесь работают только адреса HTTP- и HTTPS-прокси. Адрес, который начинается с socks5://, n8n пропускает: пишет предупреждение в журнал и отправляет запрос без этого прокси. Нода при этом не падает, и запрос уходит с собственного IP сервера n8n.
Спецсимволы в пароле — @, :, / — нужно закодировать для URL, например @ как %40.
Параметр ноды важнее переменных окружения HTTP_PROXY, HTTPS_PROXY и ALL_PROXY, поэтому один сценарий может ходить через прокси, а остальные — напрямую.

Привязка по IP или пароль — зависит от того, где работает n8n

Где работает n8n	Что использовать	Почему
На вашем сервере	Привязку по IP или логин и пароль	Внешний IP сервера принадлежит вам. Привяжите его по рецепту выше, и в адресе прокси не нужны логин и пароль: `http://IP:ПОРТ`.
n8n Cloud	Только логин и пароль	n8n Cloud отправляет исходящие запросы с IP-адресов, общих для множества инстансов. Если привязать их, вашими прокси смогут пользоваться чужие сценарии n8n Cloud, которые выходят с тех же адресов.

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

Откройте неудачное выполнение и нажмите на MCP-ноду: в панели ошибки — сообщение, которое вернул наш сервер.

Что видно	Причина и решение
`Missing or malformed Authorization header`	В Authentication стоит None или не выбраны учётные данные. Выберите Bearer Auth и учётные данные PapaProxy.net.
`Invalid or revoked API key`	Токен начинается с `Bearer` , и в заголовке слово оказывается дважды: в Bearer Token оставьте только ключ. Ещё причины — опечатка, лишний пробел или отозванный ключ.
Список Tools to Include или Tool пуст или показывает ошибку	n8n загружает список с нашего сервера по вашему ключу, поэтому он не открывается по тем же причинам, по которым не прошёл бы вызов. Сначала исправьте адрес и учётные данные, затем откройте список заново.
Ошибки подключения, когда в Server Transport выбран Server Sent Events	Наш сервер работает по Streamable HTTP. Выберите HTTP Streamable.
В ноде поле SSE Endpoint и нет выбора транспорта	Это первая версия ноды, она подключается только по SSE. Удалите её и добавьте MCP Client Tool заново; в старых версиях n8n сначала обновите n8n.
n8n на своём сервере не подключается совсем	Сервер не может достучаться до `papaproxy.net` по HTTPS: проверьте файрвол, а если n8n работает за корпоративным прокси — переменные `HTTPS_PROXY` и `NO_PROXY`.
Вызов инструмента падает с ошибкой прав	У ключа нет нужного права. Ошибка приходит текстом с коротким кодом и объяснением. Создайте ключ с недостающим правом и замените его в учётных данных.
Вызовы начинают падать посреди цикла	Лимит 60 запросов в минуту общий для всего аккаунта. Добавьте в цикл ноду Wait.
Сайты видят IP сервера n8n	Адрес прокси в HTTP Request начинается с `socks5://` или без схемы. Укажите `http://` и HTTP-порт.

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

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

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