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

> Страница: https://papaproxy.net/ru/developers/mcp/n8n.php. В n8n MCP-сервер PapaProxy.net (56 инструментов для аккаунта с прокси) работает двумя способами: как инструменты для AI Agent (нода MCP Client Tool) и как обычный шаг сценария без модели (нода MCP Client). Адрес, ключ и учётные данные n8n — одни и те же.

- Адрес MCP: `https://papaproxy.net/account_new/api/v1/mcp`
- Транспорт: Streamable HTTP (в n8n: Server Transport → HTTP Streamable)
- Авторизация: учётные данные n8n типа Bearer Auth; в Bearer Token — сам ключ (`fb_...`), без слова `Bearer`
- Ключ: личный кабинет → Настройки → API-ключи (https://papaproxy.net/account_new/settings#api-keys). Полный ключ показывается один раз.
- Стоимость: входит в каждый аккаунт, оплачиваются только заказанные прокси. Нода MCP Client не расходует токены модели.

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

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

`get_usage_overview` и `get_diagnostics` доступны только через MCP — для запуска по расписанию без агента используйте MCP Client.

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

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

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

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

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

## Вариант 1. AI Agent и MCP Client Tool

Нажмите + у входа Tool ноды AI Agent и добавьте 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
```

Инструменты для агента отчётов: `list_services`, `get_service`, `get_usage_overview`, `get_usage_timeseries`, `get_top_destinations`, `get_diagnostics`, `get_recommendations`.

Системное сообщение:

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

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

n8n может поставить сценарий на паузу перед вызовом конкретных инструментов и спросить человека (Slack, Telegram, Microsoft Teams, Discord, Gmail, чат n8n и другие). Подтверждение действует на инструменты, подключённые к шагу проверки, поэтому нужны две ноды 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 }}` — что агент хочет отправить. Настоящая граница — ключ: без `wallet:spend` оплатить ничего нельзя, с ним — только с баланса аккаунта.

## Вариант 2. 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 принимает их выражением. Результат доступен в `structuredContent`, например `{{ $json.structuredContent.balance_cents }}` после `wallet_balance`.

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

- Утренняя сводка ошибок: Schedule Trigger → MCP Client (`get_usage_overview`) → MCP Client (`get_diagnostics`) → Slack. Права: `services:read`, `usage:read`.
- Оповещение о низком балансе: Schedule Trigger → MCP Client (`wallet_balance`) → If `{{ $json.structuredContent.balance_cents }}` < `2000` ($20.00) → Telegram. Права: `wallet:read`.
- Чат-бот с ценами: Chat Trigger → AI Agent + MCP Client Tool только с `list_countries`, `get_pricing_info`, `quote_composite`. Права: `catalog:read` (не видит сервисы и не может купить).
- Привязка IP своего сервера n8n: `get_my_ip` (внешний IP сервера n8n) → `add_whitelist_ip` с ID сервиса. Не для n8n Cloud (общие исходящие IP).

Лимит: 60 запросов в минуту на аккаунт, общий для всех API-ключей и MCP-сервера; в Loop Over Items добавьте ноду Wait. `list_proxy_ips` возвращает весь список одним ответом — вызывайте его из MCP Client, а не из AI Agent, и разбирайте нодами Split Out или Code.

Все 56 инструментов: https://papaproxy.net/developers/reference/#mcp-tools (на английском)

## Прокси в ноде HTTP Request

HTTP Request → Add option → Proxy:

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

- Работают только адреса `http://` и `https://`. Адрес `socks5://` n8n пропускает с предупреждением в журнале, и запрос уходит без прокси — с IP сервера n8n.
- Спецсимволы в пароле кодируйте для URL (`@` → `%40`).
- Параметр ноды важнее `HTTP_PROXY`, `HTTPS_PROXY` и `ALL_PROXY` для этой ноды.

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

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

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

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

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

Cursor: https://papaproxy.net/ru/developers/mcp/cursor.md. Claude Code: https://papaproxy.net/ru/developers/mcp/claude-code.md. VS Code, Windsurf, Cline, Codex CLI, Gemini CLI, Claude Desktop: https://papaproxy.net/ru/developers.php#mcp