MCP сервер для n8n

MCP сервер для n8n — это приложение, которое предоставляет AI-ассистентам доступ к платформе автоматизации рабочих процессов n8n через стандартный протокол Model Context Protocol (MCP). Сервер разворачивается на виртуальной машине в Yandex Cloud.

Основные возможности и преимущества

• Интеграция с Yandex AI Studio. MCP сервер интегрируется с AI Studio MCP Серверы — подключите его к вашим AI-агентам в несколько кликов.
• Управление рабочими процессами. Создание, обновление, валидация и запуск рабочих процессов n8n через AI-ассистента.
• Доступ к 500+ узлам n8n. Информация обо всех доступных узлах, их документация, параметры и примеры использования.
• Шаблоны рабочих процессов. Поиск и использование готовых шаблонов для быстрого создания автоматизаций.
• Валидация и автоисправление. Проверка структуры, соединений и выражений рабочих процессов с автоматическим исправлением ошибок.
• Авторизация Bearer-токеном. Все запросы к MCP-серверу защищены Bearer-токеном, который хранится в Yandex Lockbox.
• Безопасное хранение секретов. API-ключ n8n хранится в Yandex Lockbox и извлекается при запуске.
• Стандартный протокол MCP. Использует открытый протокол Model Context Protocol для взаимодействия с AI-моделями.
• HTTP транспорт. MCP сервер доступен на порту 8000 (HTTP).
• Минимальные ресурсы. Приложение работает на виртуальной машине с минимальной конфигурацией (2 vCPU, 2 GB RAM).
• Docker-контейнеризация. Сервер запускается в Docker-контейнерах (MCP + nginx auth proxy).

1. Подготовьте инстанс n8n: разверните n8n (self-hosted или облачный) и создайте API-ключ в настройках инстанса (Settings → API).
2. Создайте секрет в Yandex Lockbox для хранения API-ключа n8n. Секрет должен содержать ключ api_key со значением API-ключа.
3. Создайте секрет в Yandex Lockbox для хранения Bearer-токена авторизации. Секрет должен содержать ключ bearer_token с произвольным токеном.
4. Создайте сервисный аккаунт с ролями compute.editor, iam.serviceAccounts.admin, lockbox.payloadViewer, vpc.admin (роль admin включает все указанные роли).
5. В консоли управления выберите сервис Cloud Apps.
6. На панели слева выберите Магазин приложений.
7. Выберите MCP n8n и нажмите кнопку Использовать.
8. Укажите:
   • Имя приложения.
   • (Опционально) Описание приложения.
   • Сервисный аккаунт, созданный ранее.
   • Облачную подсеть, в которой будет развёрнута виртуальная машина.
   • Идентификатор секрета Lockbox с Bearer-токеном для авторизации.
   • Идентификатор секрета Lockbox с API-ключом n8n.
   • URL инстанса n8n (например, https://your-n8n.example.com).
   • (Опционально) Сертификат из Yandex Certificate Manager для подключения к n8n по HTTPS.
9. Нажмите кнопку Установить и дождитесь, пока приложение установится.
10. После установки MCP сервер будет доступен по адресу http://<vm-ip>:8000.
11. Настройте ваш AI-клиент (Claude Desktop, Cursor и др.) для подключения к MCP серверу, указав заголовок Authorization: Bearer <ваш-токен>.

Подключение MCP-сервера к Yandex AI Studio

1. В консоли управления откройте сервис AI Studio и перейдите в раздел MCP Hub.
2. Нажмите Создать MCP-сервер и выберите тип Внешний MCP-сервер.
3. Укажите имя сервера и идентификатор сети VPC, в которой развёрнута виртуальная машина MCP-сервера. Идентификатор сети доступен на странице приложения в разделе Данные приложения, поле Идентификатор сети VPC.
4. На шаге подключения к MCP-серверу заполните параметры значениями из раздела Данные приложения:
   • Тип MCP-сервера — значение из поля Тип MCP-сервера.
   • URL MCP-сервера — значение из поля URL MCP-сервера (внутренний).
   • В блоке HTTP-заголовков добавьте заголовок Authorization со значением Bearer <bearer_token>, где <bearer_token> — токен из секрета Yandex Lockbox, указанного при установке приложения.
5. Нажмите Подключиться. После успешной проверки подключения выберите необходимые инструменты (tools) и нажмите Подключить — MCP-сервер будет зарегистрирован в AI Studio и доступен для использования AI-агентами.

• Создание и настройка рабочих процессов n8n через AI-ассистента (Claude, ChatGPT).
• Просмотр документации по узлам n8n и поиск подходящих шаблонов автоматизаций.
• Валидация и автоматическое исправление ошибок в рабочих процессах.
• Управление выполнением рабочих процессов: запуск, просмотр истории, удаление записей.
• Создание AI-агентов, автоматизирующих бизнес-процессы через n8n.

Служба технической поддержки Yandex Cloud отвечает на запросы 24 часа в сутки, 7 дней в неделю. Доступные виды запросов и срок их обработки зависят от тарифного плана. Подключить платную поддержку можно в консоли управления. Подробнее о порядке оказания технической поддержки.