Короткий ответ
n8n + MCP — это способ подключить ваши автоматизации в n8n к AI-клиентам: ChatGPT, Claude, Claude Code, Gemini CLI, Google ADK и другим MCP-совместимым инструментам. После настройки AI сможет видеть доступные workflow, выбирать нужный по названию и описанию, запускать его и возвращать результат.
Самый простой путь:
- В n8n откройте Settings → Instance-level MCP.
- Включите Enable MCP access.
- Откройте Connection details и выберите авторизацию: OAuth2 или Access Token.
- Отметьте нужный workflow как Available in MCP.
- Подключите MCP URL к ChatGPT, Claude или Gemini.
- Проверьте, что AI видит tools и запускает только то, что вы разрешили.
Главное правило: n8n не открывает все workflow автоматически. Сначала MCP включается на уровне инстанса, потом каждый workflow нужно разрешить отдельно. Для облачных клиентов вроде ChatGPT и Claude ваш n8n должен быть доступен по публичному HTTPS-адресу.
Что такое n8n + MCP
n8n — это платформа для автоматизации workflow: вы соединяете приложения, API, базы данных, таблицы, мессенджеры, CRM, почту, AI-модели и внутренние сервисы в цепочки действий. В n8n такие цепочки называются workflow: они состоят из nodes, credentials, условий, триггеров, HTTP-запросов, AI Agent node и других блоков.
MCP — это Model Context Protocol, открытый стандарт, который позволяет AI-приложениям подключаться к внешним системам: данным, API, инструментам и workflow. Проще говоря, MCP — это «универсальный порт» между AI-моделью и вашими рабочими системами.
Когда мы говорим n8n + MCP, мы говорим о связке, где:
- n8n хранит и исполняет реальные автоматизации;
- MCP описывает, какие действия доступны AI-клиенту;
- ChatGPT, Claude или Gemini выступают интерфейсом, через который пользователь просит выполнить действие;
- AI-клиент вызывает разрешённые tools/workflows через MCP;
- n8n выполняет workflow и возвращает результат.
Пример: вы пишете Claude: «Проверь новые лиды в CRM, обогати их данными, добавь в Google Sheets и отправь мне сводку в Telegram». Claude видит MCP-инструмент из n8n, вызывает нужный workflow, n8n выполняет цепочку, Claude возвращает понятный результат.
Это принципиально отличается от обычного чата. Без MCP модель может только советовать, писать текст и генерировать код. С MCP она получает контролируемый доступ к действиям: найти запись, вызвать workflow, обновить таблицу, создать задачу, запустить проверку или собрать отчёт.
Три сценария использования
1. AI видит выбранные workflow и запускает их. Самый частый сценарий. Вы создали workflow: «Собрать отчёт по заявкам за день», «Добавить лид в CRM», «Получить данные из Google Sheets», «Сделать RAG-поиск по базе знаний». Включаете для каждого Available in MCP — и AI-клиент может вызывать их по запросу.
2. AI помогает создавать и редактировать workflow. Instance-level MCP может открывать инструменты для работы с workflow: поиск, просмотр, тестирование, создание. Полезно для разработчиков и автоматизаторов — но несёт больше риска.
3. Один workflow становится отдельным MCP-сервером. Через MCP Server Trigger конкретный workflow сам становится MCP-сервером и предоставляет только те tools, которые вы подключили внутри. Хороший вариант для точечных production-сценариев.
Архитектура: кто здесь сервер, клиент и tool
MCP host
Host — это приложение, где сидит пользователь и AI-модель. В нашем случае host может быть: ChatGPT, Claude, Claude Desktop, Claude Code, Gemini CLI, Google ADK agent, Cursor или другой MCP-совместимый клиент. Host принимает ваш запрос и передаёт его модели.
MCP client
MCP client — это часть host-приложения, которая умеет подключаться к MCP server, получать список tools и вызывать их. Например, когда ChatGPT подключается к вашему n8n MCP endpoint, ChatGPT выступает MCP-клиентом.
MCP server
MCP server — это сторона, которая предоставляет AI-клиенту capabilities: tools, resources, prompts или workflow. В этой статье MCP server чаще всего — это n8n:
- Instance-level MCP server — встроенный MCP-сервер всего n8n-инстанса;
- MCP Server Trigger — отдельный workflow, который ведёт себя как MCP-сервер;
- внешний MCP-сервер — если уже n8n подключается к нему как client.
MCP tool
Tool — конкретное действие, которое AI может вызвать. В n8n это может быть: запуск workflow, поиск по базе данных, чтение Google Sheets, отправка сообщения, создание задачи и другие.
Хорошее описание tool критически важно. AI выбирает инструменты по названию, описанию и схеме параметров. Если workflow называется test_2_final_new, модель не поймёт, когда его использовать. Если он называется send_daily_sales_report_to_telegram с описанием «Собирает продажи за выбранную дату и отправляет отчёт в Telegram» — качество вызовов будет намного выше.
Два режима: Instance-level MCP и MCP Server Trigger
В n8n есть два главных способа работать с MCP. Их важно не смешивать.
| Параметр | Instance-level MCP | MCP Server Trigger |
|---|---|---|
| Где включается | В настройках n8n-инстанса | Внутри конкретного workflow |
| Что открывает | Инструменты уровня инстанса и выбранные workflow | Только tools, подключённые к этому workflow |
| Подходит для | Подключения Claude/ChatGPT/Gemini к n8n как к рабочей панели | Создания одного точечного MCP-инструмента |
| Управление доступом | MCP включается глобально, workflow разрешаются отдельно | Доступ ограничен содержимым конкретного workflow |
| Риск | Выше: можно открыть управление workflow/data tables | Ниже, если workflow узкий и безопасный |
| Когда использовать | AI-ассистент автоматизатора, внутренняя AI-панель, разработка | Один production-tool: «создать лид», «найти документ», «сделать отчёт» |
Что умеет Instance-level MCP
Instance-level MCP — встроенный MCP-сервер n8n. После включения он позволяет подключённым MCP-клиентам: искать workflow, взаимодействовать с workflow, отмеченными как доступные в MCP, запускать и тестировать открытые workflow, создавать и редактировать workflow, работать с data tables.
Ключевой нюанс: это не автоматическое открытие всех workflow. n8n требует включить MCP на уровне инстанса и затем отдельно включить доступ для каждого workflow.
Что умеет MCP Server Trigger
MCP Server Trigger — это node, который делает конкретный workflow входной точкой для MCP-клиентов. Он открывает URL, по которому MCP-клиент может получить список tools и вызвать их.
Важное отличие: MCP Server Trigger не запускает workflow как классический Webhook Trigger. Он подключается к tool nodes и позволяет клиенту вызвать конкретный tool. MCP Server Trigger поддерживает Server-Sent Events (SSE) и Streamable HTTP, но не поддерживает stdio transport напрямую.
Что нужно перед настройкой
1. Рабочий n8n-инстанс
Подойдёт: n8n Cloud, self-hosted n8n на VPS, self-hosted n8n в Docker Compose, корпоративная установка n8n. Для локального эксперимента можно использовать n8n на компьютере, но cloud-клиенты не смогут подключиться к localhost. В таком случае нужен tunnel: Cloudflare Tunnel, ngrok или аналог.
2. Публичный HTTPS URL
Если вы подключаете n8n к ChatGPT, Claude web, Claude Desktop через remote connector, MCP endpoint должен быть доступен из интернета по HTTPS. Не подойдут без дополнительной настройки: http://localhost:5678, приватный IP в домашней сети, сервер без валидного TLS. Для production используйте нормальный домен: https://n8n.example.com
3. Права owner/admin в n8n
Включение Instance-level MCP требует прав владельца или администратора инстанса. Если вы обычный пользователь workspace, попросите администратора включить MCP.
4. Понятные описания workflow
AI-клиент выбирает tools по описанию. Перед публикацией workflow для MCP добавьте: понятное название, описание когда использовать, список входных параметров, ограничения, ожидаемый результат, предупреждение если workflow меняет данные.
Плохое описание: Workflow for leads
Хорошее описание: Добавляет новый лид в CRM из входных данных: имя, email, телефон, источник, комментарий. Использовать только когда пользователь явно просит создать нового лида. Не использовать для редактирования существующих лидов.
5. Решение по авторизации
- OAuth2 — предпочтительно для пользователей и организаций, где важно управлять consent и отзывом доступа;
- Access Token — проще для CLI, тестов, Claude Code, Gemini CLI и быстрых интеграций.
Как включить Instance-level MCP в n8n
Шаг 1. Откройте настройки MCP
В n8n перейдите: Settings → Instance-level MCP
Если раздела нет, проверьте: версию n8n, права пользователя, не отключён ли MCP переменной окружения. Для self-hosted полного отключения MCP используется: N8N_DISABLED_MODULES=mcp
Шаг 2. Включите MCP access
Включите переключатель Enable MCP access. После этого n8n покажет страницу управления MCP: список workflow, открытых для MCP; список подключённых OAuth-клиентов; главный toggle; кнопку Connection details.
Шаг 3. Откройте Connection details
Нажмите Connection details. Там обычно есть две вкладки: OAuth2 и Access Token. Вам понадобится MCP server URL. Для token-based подключения endpoint выглядит так:
https://<your-n8n-domain>/mcp-server/http
Шаг 4. Выберите OAuth2 или Access Token
Если используете OAuth2:
- Скопируйте server URL из OAuth-вкладки.
- Добавьте его в MCP-клиент.
- Клиент перенаправит вас в n8n для подтверждения доступа.
- Проверьте, что клиент появился в списке connected clients.
Если используете Access Token:
- Откройте вкладку Access Token.
- Скопируйте personal MCP Access Token сразу после генерации.
- Сохраните его в password manager или secret storage.
- Добавьте header в клиент:
Authorization: Bearer <YOUR_N8N_MCP_TOKEN>
Важный нюанс: n8n показывает токен полностью только при первом создании. Потом значение будет скрыто. Если потеряли токен — сгенерируйте новый и обновите все подключённые клиенты.
Как открыть конкретный workflow для MCP
По умолчанию MCP-клиенты не видят ваши workflow. Нужно включить доступ для каждого workflow отдельно.
Способ 1. Через страницу Instance-level MCP
- Откройте Settings → Instance-level MCP.
- Нажмите Enable workflows.
- Найдите workflow по названию или описанию.
- Выберите его и нажмите Enable.
Способ 2. Через редактор workflow
- Откройте нужный workflow.
- Нажмите меню
...в правом верхнем углу. - Выберите Settings.
- Включите toggle Available in MCP.
Способ 3. Через список workflows
- Откройте раздел Workflows.
- Найдите нужный workflow.
- Откройте меню карточки workflow.
- Выберите Enable MCP access.
Как правильно описать workflow для AI
Перед включением MCP добавьте description по шаблону:
Назначение: что делает workflow.
Когда использовать: при каких запросах вызывать.
Входные параметры: какие поля нужны.
Ограничения: чего workflow не делает.
Результат: что пользователь получит.
Риск: меняет ли workflow данные.
Пример рабочего описания: Назначение: создаёт задачу в Notion по входному описанию. Когда использовать: когда пользователь просит поставить задачу или создать follow-up. Входные параметры: title, description, due_date, priority. Ограничения: не удаляет и не редактирует существующие задачи. Результат: возвращает ссылку на созданную задачу. Риск: создаёт новую запись в Notion — использовать только после явного запроса.
Как подключить n8n MCP к Claude
Claude можно подключать к n8n MCP несколькими способами: через remote custom connector, через Claude Desktop или через Claude Code CLI.
Вариант A. Claude custom connector через remote MCP
Подходит, если ваш n8n доступен по публичному HTTPS URL.
- Откройте Claude и перейдите в Customize → Connectors.
- Нажмите + и выберите Add custom connector.
- Укажите remote MCP server URL из n8n.
- При необходимости откройте Advanced settings и задайте OAuth Client ID/Secret.
- В новом чате включите connector через кнопку
+ → Connectors.
Важно: remote connector в Claude подключается из облачной инфраструктуры Anthropic, а не с вашего компьютера. Поэтому MCP server должен быть доступен из интернета.
Вариант B. Claude Desktop через Access Token
Добавьте в claude_desktop_config.json:
{
"mcpServers": {
"n8n-mcp": {
"type": "http",
"url": "https://<your-n8n-domain>/mcp-server/http",
"headers": {
"Authorization": "Bearer <YOUR_N8N_MCP_TOKEN>"
}
}
}
}
После изменения файла перезапустите Claude Desktop и проверьте подключение через список connectors/tools.
Вариант C. Claude Code через CLI
Для Claude Code можно добавить HTTP MCP server командой:
claude mcp add --transport http n8n-mcp \
https://<your-n8n-domain>/mcp-server/http \
--header "Authorization: Bearer <YOUR_N8N_MCP_TOKEN>"
Проверочный запрос в Claude Code:
List available n8n workflows exposed through MCP. Explain what each workflow
does and ask before executing anything that modifies data.
Хорошая практика — явно указать Claude не запускать destructive workflow без подтверждения: Before calling any n8n MCP tool that creates, updates, deletes, sends, publishes, or charges anything, ask me for confirmation and summarize the exact parameters.
Как подключить n8n MCP к ChatGPT
В ChatGPT MCP-подключения реализованы через Apps / Connectors. Доступность зависит от плана и настроек workspace. Логика такая: ChatGPT подключается к вашему remote MCP server по HTTPS, получает список tools и позволяет использовать их в чате.
Что нужно проверить
- Ваш MCP server доступен по HTTPS;
- в ChatGPT доступен раздел Connectors или Apps;
- у вас есть права на создание connector;
- workflow включены как Available in MCP.
Пошаговое подключение
- В n8n включите Instance-level MCP и скопируйте MCP server URL.
- В ChatGPT откройте Settings → Connectors → Create.
- Заполните metadata: Connector name: n8n MCP, Connector URL: https://your-n8n-domain/mcp-server/http.
- Нажмите Create.
- После успешного подключения ChatGPT покажет список tools.
- В новом чате выберите connector через
+ → More.
Проверочный prompt:
Покажи, какие n8n workflow доступны через MCP. Для каждого workflow объясни,
когда его использовать. Ничего не запускай без моего подтверждения.
Описание connector для ChatGPT
Не пишите слишком общее описание вроде «n8n automation». Лучше так:
Этот connector предоставляет доступ к выбранным workflow n8n. Используй его, когда пользователь просит выполнить бизнес-автоматизацию: собрать отчёт, создать лид, проверить оплату, обновить Google Sheets или отправить Telegram-уведомление. Перед любыми write действиями сначала уточни параметры и запроси подтверждение.
Как подключить n8n MCP к Gemini
Для Gemini самый практичный путь — Gemini CLI, потому что он поддерживает MCP servers через settings.json. Также можно использовать Google ADK, если вы строите собственного агента.
Вариант A. Gemini CLI через settings.json
Откройте файл настроек Gemini CLI и добавьте mcpServers:
{
"mcpServers": {
"n8n": {
"httpUrl": "https://<your-n8n-domain>/mcp-server/http",
"headers": {
"Authorization": "Bearer <YOUR_N8N_MCP_TOKEN>"
},
"timeout": 30000,
"trust": false
}
}
}
Что значат поля: httpUrl — endpoint со streamable HTTP transport; headers — Bearer token; timeout — timeout запроса в ms; trust: false — Gemini CLI будет запрашивать подтверждение tool calls.
Для проверки используйте команду /mcp — она показывает статус подключения и доступные tools.
Вариант B. Google ADK agent
Если вы строите агента на Google ADK, подключите remote MCP service через MCP toolset:
from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
n8n_tools = MCPToolset(
connection_params=StreamableHTTPConnectionParams(
url="https://<your-n8n-domain>/mcp-server/http",
headers={"Authorization": "Bearer <YOUR_N8N_MCP_TOKEN>"},
)
)
Дальше подключите n8n_tools к агенту и опишите в system instruction, какие действия разрешены, а какие требуют подтверждения.
Как сделать один workflow отдельным MCP-сервером
Если не нужно открывать весь instance-level MCP, используйте MCP Server Trigger. Это хороший вариант, если вы хотите: открыть AI только один безопасный сценарий, минимизировать поверхность доступа, быстро сделать MCP API без отдельного backend.
Как работает MCP Server Trigger
Claude / ChatGPT / Gemini
↓
MCP URL workflow
↓
MCP Server Trigger
↓
Tool nodes
↓
API / CRM / DB / Telegram / Google Sheets
MCP Server Trigger открывает test URL (при тестировании) и production URL (после публикации workflow).
Базовая настройка
- Создайте новый workflow.
- Добавьте node MCP Server Trigger.
- Добавьте один или несколько tool nodes.
- Опишите каждый tool: название, назначение, параметры.
- Настройте credentials.
- Протестируйте через Test URL.
- Активируйте workflow и используйте Production URL в MCP-клиенте.
Когда выбирать MCP Server Trigger
- Нужен один конкретный AI-tool;
- хотите минимизировать поверхность доступа;
- не хотите давать AI возможность редактировать workflow;
- строите production-сервис для внешнего AI-клиента;
- нужен быстрый MCP API без отдельного backend.
n8n как MCP client
До этого мы рассматривали n8n как MCP server. Но n8n может работать и в обратную сторону — как MCP client. Workflow в n8n может подключаться к внешним MCP-серверам и вызывать их tools.
MCP Client node
MCP Client node позволяет использовать tools внешнего MCP server как обычные шаги workflow:
Webhook Trigger → MCP Client → IF → Google Sheets → Telegram
Сценарии: вызвать внешний MCP-сервер поиска, получить данные из инструмента обёрнутого в MCP, объединить несколько MCP tools внутри одного n8n workflow.
MCP Client Tool node
MCP Client Tool node подключается к AI Agent node в n8n. Это значит, что агент внутри n8n может сам использовать внешние MCP tools:
Chat Trigger → AI Agent → MCP Client Tool → External MCP Server
Сценарии: AI Agent в n8n использует MCP tool для поиска в GitHub, агент обращается к базе данных через MCP, агент комбинирует n8n nodes и MCP tools.
Примеры workflow для ChatGPT, Claude и Gemini
Пример 1. AI-ассистент для Telegram-бота
Задача: пользователь пишет в ChatGPT: «Отправь клиенту в Telegram напоминание о встрече завтра в 15:00».
AI client → n8n MCP → workflow "send_telegram_reminder" → Telegram node → result
Описание workflow: Отправляет Telegram-сообщение выбранному пользователю. Использовать только когда пользователь явно просит отправить сообщение. Перед отправкой всегда подтвердить текст, получателя и время.
Риск: отправка внешнего сообщения — нужен human confirmation.
Пример 2. AI-отчёт по Google Sheets
Задача: «Собери продажи за неделю и скажи, какие товары просели».
AI client → n8n MCP → Google Sheets node → aggregation → return JSON/summary
Описание workflow: Читает таблицу продаж из Google Sheets и возвращает агрегированный отчёт. Workflow read-only: не изменяет таблицу.
Пример 3. RAG-поиск по базе знаний
Задача: «Найди в документации, как настроить оплату для B2B-клиента».
AI client → n8n MCP → vector database / Notion / Google Drive → retrieved chunks → answer
Описание workflow: Ищет релевантные фрагменты во внутренней базе знаний и возвращает источники. Workflow read-only. Использовать для вопросов по документации, процедурам, продукту.
Пример 4. CRM lead enrichment
Задача: «Обогати новых лидов и поставь менеджерам задачи».
AI client → n8n MCP → CRM node → enrichment API → task manager → summary
Риск: высокий. Workflow меняет CRM — требуется подтверждение.
Пример 5. Проверка статуса заказа
Задача: «Проверь заказ 10984 и скажи, когда доставка».
AI client → n8n MCP → order API → delivery API → result
Описание workflow: Проверяет статус заказа по order_id и возвращает статус оплаты, комплектации и доставки. Read-only. Не изменяет заказ.
MCP vs Webhook vs API
Многие путают MCP, webhook и API. Это разные уровни интеграции.
| Подход | Что это | Когда использовать | Пример |
|---|---|---|---|
| Webhook | URL, который запускает workflow при HTTP-запросе | Когда внешняя система заранее знает, какой endpoint вызвать | Форма отправила заявку в n8n |
| API | Набор методов для программного управления системой | Когда разработчик пишет интеграцию вручную | Backend вызывает n8n REST API |
| MCP | Протокол, через который AI-клиент узнаёт tools и вызывает их по описанию | Когда AI должен сам выбрать подходящий tool/workflow | Claude видит workflow «создать лид» и вызывает его |
Webhook проще, если сценарий фиксированный: форма → webhook → workflow.
MCP полезнее, когда пользователь говорит естественным языком, а AI должен понять, какой workflow подходит: пользователь → ChatGPT/Claude/Gemini → MCP tools → n8n workflow.
MCP особенно силён, когда: есть много разных workflow, пользователь не хочет помнить названия endpoint, нужно запускать автоматизации из AI-чата, AI должен выбрать tool по контексту, требуется human-in-the-loop.
Безопасность
n8n MCP — мощная связка. Если AI получает доступ к workflow, он может не только читать данные, но и запускать действия: отправлять сообщения, менять CRM, создавать документы, обновлять таблицы, вызывать внешние API.
Главный принцип
Открывайте AI только то, что ему действительно нужно.
Не делайте так: включить MCP для всех workflow и дать всем клиентам один общий токен.
Делайте так: создать безопасные workflow, дать им понятные descriptions, включить MCP только для них, использовать OAuth2 или отдельные tokens, включить confirmations для write actions.
Чеклист безопасности
- Используйте HTTPS;
- не подключайте production n8n к AI-клиентам через случайные публичные tunnels на постоянной основе;
- не включайте MCP для workflow, которые удаляют данные, без отдельного подтверждения;
- разделяйте read-only и write workflow;
- добавляйте предупреждения в workflow description;
- используйте OAuth2 там, где возможно;
- если используете Access Token — храните в secret manager и ротируйте при утечке;
- для Gemini CLI держите
trust: false, если не уверены; - проверяйте logs n8n и историю executions;
- не давайте AI доступ к credentials, которые ему не нужны.
Read-only и write tools
Read-only: поиск по базе знаний, чтение Google Sheets, проверка статуса заказа, получение отчёта, анализ данных без записи.
Write / destructive: отправить email или Telegram-сообщение, создать лид, обновить CRM, удалить запись, создать платёж, опубликовать документ.
Для write actions добавьте правило в system prompt AI-клиента: Перед вызовом любого n8n tool, который создаёт, изменяет, удаляет, отправляет, публикует или списывает деньги, сначала покажи пользователю точные параметры и дождись явного подтверждения.
Особый риск: доступ не scoped к каждому MCP-клиенту
У instance-level MCP есть важный нюанс: workflow, включённые для MCP, видны всем подключённым MCP-клиентам в рамках доступа пользователя. Если нужно разделить доступ по клиентам — используйте разные n8n-пользователи, разные проекты, отдельные токены или MCP Server Trigger для узких сценариев.
Типовые ошибки и решения
| Проблема | Вероятная причина | Что сделать |
|---|---|---|
| ChatGPT/Claude не подключается | n8n недоступен из интернета | Проверьте публичный HTTPS URL, firewall, reverse proxy, DNS |
| Клиент видит MCP server, но tools пустые | Workflow не отмечены как Available in MCP | Включите MCP-доступ для нужных workflow |
| 401 Unauthorized | Неверный token | Пересоздайте token и проверьте header Authorization: Bearer ... |
| 403 Forbidden | Недостаточно прав пользователя | Проверьте роль пользователя n8n и доступ к проекту/workflow |
| Claude remote connector не видит локальный n8n | Claude подключается из cloud, а не с вашей машины | Используйте публичный сервер или tunnel для тестов |
| ChatGPT просит HTTPS | MCP endpoint не по HTTPS | Поднимите TLS через reverse proxy или tunnel |
| Gemini CLI не показывает tools | Неверный settings.json или transport | Проверьте httpUrl для Streamable HTTP, url для SSE, token и /mcp |
| AI вызывает не тот workflow | Плохое название/описание | Переименуйте workflow и перепишите description |
| AI запускает workflow без нужных параметров | Нет schema/описания входа | Уточните параметры tool и добавьте проверки в workflow |
| Token потерян | n8n скрывает token после первого просмотра | Сгенерируйте новый token и обновите клиентов |
| Workflow запускается, но не меняет production-версию | Вы тестируете unpublished workflow | Проверьте published/manual execution mode |
Диагностический prompt для AI-клиента
Проверь подключение к n8n MCP. Покажи список доступных tools/workflows,
их описания, входные параметры и отметь, какие из них read-only,
а какие изменяют данные. Ничего не запускай.
Диагностика на стороне n8n
- MCP включён в Settings;
- workflow включён как Available in MCP;
- workflow опубликован, если нужен production execution;
- credentials внутри workflow валидны;
- reverse proxy не режет long-lived HTTP/SSE;
- CORS/headers/firewall не блокируют клиента;
- token не отозван и не заменён.
FAQ
Что такое n8n MCP простыми словами?
n8n MCP — это способ подключить n8n к AI-клиентам через Model Context Protocol. После настройки ChatGPT, Claude, Gemini или другой MCP-клиент может видеть разрешённые workflow и вызывать их как инструменты.
Можно ли подключить n8n workflow к ChatGPT?
Да, если в ChatGPT доступна функция Apps/Connectors и ваш n8n MCP endpoint доступен по HTTPS. В n8n нужно включить Instance-level MCP и отметить нужные workflow как Available in MCP.
Можно ли подключить n8n к Claude Desktop?
Да. Claude Desktop подключается к MCP server через OAuth2, Access Token, remote connector или локальную конфигурацию. Для remote MCP ваш n8n должен быть доступен из интернета.
Можно ли подключить n8n к Claude Code?
Да. Для Claude Code используйте команду: claude mcp add --transport http n8n-mcp https://<your-n8n-domain>/mcp-server/http --header "Authorization: Bearer <TOKEN>"
Можно ли подключить n8n к Gemini?
Да. Практичный вариант — Gemini CLI. В settings.json добавляется блок mcpServers с httpUrl или url, headers и token. После этого /mcp покажет статус подключения и tools.
Чем Instance-level MCP отличается от MCP Server Trigger?
Instance-level MCP включается на уровне всего n8n-инстанса и позволяет AI-клиентам работать с разрешёнными workflow и инструментами управления. MCP Server Trigger создаётся внутри конкретного workflow и открывает только tools этого workflow.
Нужно ли публиковать workflow?
Для production-запуска обычно нужен опубликованный workflow. Для надёжного production-сценария проверяйте, какую версию запускает AI — production или manual.
Почему ChatGPT или Claude не видит мой workflow?
Чаще всего: workflow не отмечен как Available in MCP, MCP не включён на уровне инстанса, endpoint недоступен по HTTPS или неверно настроена авторизация.
Можно ли использовать n8n MCP локально?
Для локальных desktop-клиентов — иногда да, если клиент обращается к локальному серверу. Для cloud-клиентов вроде ChatGPT/Claude remote connector — нет, им нужен публично доступный HTTPS endpoint или tunnel.
Что безопаснее: OAuth2 или Access Token?
OAuth2 обычно безопаснее для пользовательских и корпоративных сценариев: поддерживает consent и отзыв доступа. Access Token проще для CLI и тестов, но его нужно хранить как секрет и ротировать при риске утечки.
MCP заменяет webhook в n8n?
Нет. Webhook хорош для фиксированных интеграций, когда внешняя система точно знает endpoint. MCP лучше для AI-сценариев, где модель сама выбирает tool по описанию и контексту.
Можно ли открыть только один workflow?
Да. Можно либо включить Available in MCP только для одного workflow в Instance-level MCP, либо использовать MCP Server Trigger, чтобы сделать отдельный MCP endpoint для конкретного workflow.
Нужно ли давать AI доступ к редактированию workflow?
Не обязательно. Для большинства business-сценариев достаточно дать AI право запускать заранее подготовленные workflow. Редактирование workflow лучше оставить для staging или технических пользователей.
Какие workflow лучше открывать первыми?
Начните с read-only workflow: поиск по базе знаний, получение отчётов, проверка статусов, чтение таблиц. Потом добавляйте write actions с обязательным подтверждением.
Что делать, если SSE/Streamable HTTP нестабилен?
При работе n8n в queue mode с несколькими webhook replicas направьте все /mcp* запросы на одну dedicated webhook replica.
Глоссарий
- n8n
- Платформа для автоматизации workflow: объединяет интеграции приложений, API, бизнес-процессы и AI-workflow в визуальные цепочки действий.
- MCP (Model Context Protocol)
- Открытый протокол для подключения AI-приложений к внешним инструментам, источникам данных и workflow.
- Instance-level MCP
- Встроенный MCP-сервер n8n на уровне инстанса. Открывает выбранные workflow и инструменты управления для MCP-клиентов.
- MCP Server Trigger
- Node в n8n, который превращает конкретный workflow в MCP-сервер, открывая подключённые tool nodes для внешних клиентов.
- MCP client
- Компонент на стороне AI, который обнаруживает и вызывает MCP tools. Например: ChatGPT, Claude или Gemini CLI.
- MCP tool
- Конкретное действие, открытое через MCP: запуск workflow, чтение данных, создание записи в CRM, отправка сообщения.
- Available in MCP
- Настройка workflow в n8n, которая делает его видимым и вызываемым для MCP-клиентов.
- Streamable HTTP
- Транспорт MCP, использующий HTTP с поддержкой потоковой передачи данных. Поддерживается MCP Server Trigger.
- SSE (Server-Sent Events)
- Транспорт MCP на основе событий, отправляемых с сервера. Поддерживается MCP Server Trigger.
- OAuth2
- Протокол авторизации с consent-flow и возможностью отзыва доступа. Рекомендуется для пользовательских и организационных подключений.
- Access Token
- Секретный токен для авторизации MCP-клиента. Проще OAuth2, но требует строгого хранения и ротации.
- RAG (Retrieval-Augmented Generation)
- Подход, при котором AI получает релевантные фрагменты из базы знаний перед генерацией ответа. В n8n реализуется через vector store nodes.