AI автоматизация / n8n / MCP / ChatGPT / Claude / Gemini

n8n + MCP: как открыть workflow для ChatGPT, Claude и Gemini

Подключите ваши автоматизации в n8n к AI-клиентам через Model Context Protocol. После настройки ChatGPT, Claude или Gemini сможет видеть доступные workflow, выбирать нужный и запускать его — без кода и без переключения между интерфейсами. Нужна помощь с внедрением — напишите в чат, обсудим.

Что этоПодключение n8n workflow к ChatGPT, Claude, Gemini и другим AI-клиентам через Model Context Protocol.
Два режимаInstance-level MCP — для всего инстанса; MCP Server Trigger — для одного workflow.
АвторизацияOAuth2 (для пользователей и org) или Access Token (для CLI и тестов).
ТребованияПубличный HTTPS URL, права owner/admin в n8n, понятные описания workflow.
БезопасностьОткрывать только нужные workflow, разделять read-only и write actions, требовать подтверждение.

Короткий ответ

n8n + MCP — это способ подключить ваши автоматизации в n8n к AI-клиентам: ChatGPT, Claude, Claude Code, Gemini CLI, Google ADK и другим MCP-совместимым инструментам. После настройки AI сможет видеть доступные workflow, выбирать нужный по названию и описанию, запускать его и возвращать результат.

Самый простой путь:

  1. В n8n откройте Settings → Instance-level MCP.
  2. Включите Enable MCP access.
  3. Откройте Connection details и выберите авторизацию: OAuth2 или Access Token.
  4. Отметьте нужный workflow как Available in MCP.
  5. Подключите MCP URL к ChatGPT, Claude или Gemini.
  6. Проверьте, что 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:

  1. Скопируйте server URL из OAuth-вкладки.
  2. Добавьте его в MCP-клиент.
  3. Клиент перенаправит вас в n8n для подтверждения доступа.
  4. Проверьте, что клиент появился в списке connected clients.

Если используете Access Token:

  1. Откройте вкладку Access Token.
  2. Скопируйте personal MCP Access Token сразу после генерации.
  3. Сохраните его в password manager или secret storage.
  4. Добавьте header в клиент: Authorization: Bearer <YOUR_N8N_MCP_TOKEN>

Важный нюанс: n8n показывает токен полностью только при первом создании. Потом значение будет скрыто. Если потеряли токен — сгенерируйте новый и обновите все подключённые клиенты.

Как открыть конкретный workflow для MCP

По умолчанию MCP-клиенты не видят ваши workflow. Нужно включить доступ для каждого workflow отдельно.

Способ 1. Через страницу Instance-level MCP

  1. Откройте Settings → Instance-level MCP.
  2. Нажмите Enable workflows.
  3. Найдите workflow по названию или описанию.
  4. Выберите его и нажмите Enable.

Способ 2. Через редактор workflow

  1. Откройте нужный workflow.
  2. Нажмите меню ... в правом верхнем углу.
  3. Выберите Settings.
  4. Включите toggle Available in MCP.

Способ 3. Через список workflows

  1. Откройте раздел Workflows.
  2. Найдите нужный workflow.
  3. Откройте меню карточки workflow.
  4. Выберите 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.

  1. Откройте Claude и перейдите в Customize → Connectors.
  2. Нажмите + и выберите Add custom connector.
  3. Укажите remote MCP server URL из n8n.
  4. При необходимости откройте Advanced settings и задайте OAuth Client ID/Secret.
  5. В новом чате включите 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.

Пошаговое подключение

  1. В n8n включите Instance-level MCP и скопируйте MCP server URL.
  2. В ChatGPT откройте Settings → Connectors → Create.
  3. Заполните metadata: Connector name: n8n MCP, Connector URL: https://your-n8n-domain/mcp-server/http.
  4. Нажмите Create.
  5. После успешного подключения ChatGPT покажет список tools.
  6. В новом чате выберите 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).

Базовая настройка

  1. Создайте новый workflow.
  2. Добавьте node MCP Server Trigger.
  3. Добавьте один или несколько tool nodes.
  4. Опишите каждый tool: название, назначение, параметры.
  5. Настройте credentials.
  6. Протестируйте через Test URL.
  7. Активируйте 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 не видит локальный n8nClaude подключается из cloud, а не с вашей машиныИспользуйте публичный сервер или tunnel для тестов
ChatGPT просит HTTPSMCP 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.