Навыки n8n: как подключить их к ИИ-ассистенту — это два шага: включить instance-level MCP на инстансе и поставить пакет навыков в кодирующий агент. MCP-сервер даёт агенту доступ к вашему инстансу, навыки дают знание конвенций n8n: выражения, конфигурацию узлов, обработку ошибок. Навыки помогают соблюдать эти конвенции.
Чем навыки отличаются от MCP-сервера
Встроенный MCP-сервер n8n, как описывает официальная документация n8n, позволяет поддерживаемым клиентам подключаться к вашему инстансу. После подключения клиент ищет workflow, взаимодействует с теми, что помечены доступными в MCP, запускает и тестирует их, создаёт и редактирует workflow и таблицы данных. Это транспорт и права доступа: что агенту разрешено делать в вашем инстансе.
Технически навык — это markdown-файл. Frontmatter сообщает агенту, когда навык загружать. Официальный пакет содержит 14 навыков покрытия, 50+ справочных документов и примеров, SessionStart-хук, который загружает протокол в каждой сессии, и PreToolUse-хуки, подсказывающие агенту свериться с навыком перед важными вызовами MCP. Пятнадцатый мета-навык using-n8n-skills-official маршрутизирует агента к нужному навыку.
Предпосылки: инстанс, версии, клиент
Официальный README перечисляет требования. Нужен инстанс n8n любого плана, Cloud или self-hosted, с включённым instance-level MCP-сервером: Settings → Instance-level MCP. Минимальная версия n8n — 2.2.0; для лучшего результата README советует актуальный stable. Для Codex требуется версия ≥ 0.142.0 — поддержка root-plugin marketplace.
Документация n8n разводит границы версий точнее. Сборка и редактирование workflow через встроенный MCP доступны с n8n 2.13.0. Современный диалог Connect a client, раскладка настроек Connection details, Access, Connected clients и Allowed callback URLs — с n8n 2.33.0; на более старых версиях страница показывает упрощённую раскладку без пошаговой настройки по клиентам. Управление доступом на уровне проектов и папок — с 2.24.0. Автоматическое открытие MCP-доступа для новых workflow постепенно появляется с 2.36.0; настройка пока может быть доступна не на каждом инстансе. Управление агентами из MCP-клиентов — с 2.34.0.
Для пошагового сценария ниже ориентируйтесь на актуальный stable. Если инстанс старше 2.33.0, шаги диалога Connect a client заменяются ручной настройкой клиента.
Отдельно про доступ: instance-level MCP не открывает все workflow сразу. Включается доступ на уровне инстанса, затем каждый workflow помечается отдельно. Исключение — search_workflows: он видит все workflow, доступные пользователю, но возвращает только превью.
Таблица выбора: официальный или сторонний пакет
| Критерий | n8n-io/skills | czlonkowski/n8n-skills |
|---|---|---|
| Владелец | Команда n8n | Romuald Członkowski |
| Источник | README репозитория n8n-io/skills | README репозитория czlonkowski/n8n-skills |
| Что подключает | Навыки к instance-level MCP n8n; плагин Claude Code несёт сервер n8n-mcp |
Навыки к стороннему серверу n8n-mcp |
| Состав | 14 навыков покрытия + мета-навык, 50+ справочных документов | 14 навыков + router + слой хуков |
| Где конфиг | Claude Code: ввод URL инстанса при установке плагина; Codex: codex mcp add |
.mcp.json с сервером n8n-mcp |
| Хуки | SessionStart, PreToolUse | Router, PreToolUse, PostToolUse |
| Кому подходит | Тем, кто работает с инстансом n8n и хочет официальную поддержку | Тем, у кого уже развёрнут сторонний n8n-mcp |
Каталог claudecowork.io описывает ещё один самостоятельный пакет — n8n Workflow Skills из репозитория haunchen/n8n-skills для Claude Code и Claude Cowork. Его владелец отличается от владельцев двух пакетов в таблице. Перед установкой проверяйте README выбранного репозитория и требуемые им MCP-серверы.
Установка официального пакета под Claude Code CLI
Внутри сессии claude README предписывает такой порядок. Сначала добавьте маркетплейс: /plugin marketplace add n8n-io/skills. Затем установите плагин: /plugin install n8n-skills@n8n-io. При установке плагин запросит URL вашего инстанса n8n — вводите только базовый URL, например https://acme.app.n8n.cloud, без пути: плагин сам добавит /mcp-server/http. После ввода выполните /reload-plugins.
Остаётся авторизация. Запустите /mcp, выберите n8n-mcp и нажмите Authenticate — вход проходит через браузер.
Для десктопного приложения Claude Code порядок тот же, но команды вводятся в поле промпта, а установка идёт через + → Plugins → Add plugin. Если запрос URL не появился, задайте его командой /plugin configure n8n-skills@n8n-io и перезагрузите. Авторизация — через Settings → Connectors.
Установка под Codex
Codex требует версии ≥ 0.142.0. Работает в CLI и в режиме Codex десктопного приложения ChatGPT. В терминале: codex plugin marketplace add n8n-io/skills, затем codex plugin add n8n-skills@n8n-io. После этого перезапустите Codex и подтвердите запрос доверия к хукам — он включает напоминания SessionStart, PreToolUse и PostToolUse.
MCP-сервер Codex сам не настраивает, поэтому добавьте его один раз вручную:
codex mcp add n8n-mcp --url https://<your-n8n-domain>/mcp-server/http
Подставьте свой домен вместо <your-n8n-domain>. Без терминала, только в десктопном приложении, сервер добавляется через GUI: Settings → MCP servers → Add server → Streamable HTTP, вставить URL, сохранить, перезапустить. Авторизация проходит по OAuth при первом использовании либо кнопкой Authenticate в списке MCP-серверов.
Установка под OpenCode и через skills.sh
В OpenCode CLI добавьте одну строку в opencode.jsonc — глобальный ~/.config/opencode/ или проектный .opencode/ — и перезапустите:
{
"plugin": ["n8n-skills@git+https://github.com/n8n-io/skills.git"]
}
OpenCode сам скачает и установит плагин, который регистрирует навыки n8n и запускает bash-хуки после вызовов инструментов n8n MCP. Клонирование, симлинки и skills.paths не нужны. Версия фиксируется суффиксом вида ...skills.git#v1.2.0.
В десктопном приложении OpenCode плагины грузятся из ~/.config/opencode/plugins/. README предлагает клонировать репозиторий и слинковать файл плагина в эту папку:
git clone https://github.com/n8n-io/skills.git ~/.local/share/opencode/n8n-skills
mkdir -p ~/.config/opencode/plugins/
ln -s ~/.local/share/opencode/n8n-skills/opencode/plugin.ts \
~/.config/opencode/plugins/n8n-skills-hooks.ts
После этого полностью закройте и откройте приложение: плагин сам регистрирует навыки. Обновление — git pull в клоне.
Для остальных платформ README указывает skills.sh, который работает через npx. Из папки проекта: npx skills add n8n-io/skills. Совместимость различается по агентам — у каждого кодирующего агента свой формат навыков, поэтому сверьтесь с документацией своей платформы. При установке без плагина SessionStart-хука нет, и README советует добавить в AGENTS.md сниппет, который велит агенту начинать каждую задачу n8n с загрузки мета-навыка using-n8n-skills-official.
Установка стороннего пакета
Сторонний пакет czlonkowski/n8n-skills ставится тремя способами. Как плагин Claude Code: /plugin install czlonkowski/n8n-skills. Через маркетплейс: /plugin marketplace add czlonkowski/n8n-skills, затем /plugin install и выбор n8n-mcp-skills из списка. Вручную: клонировать репозиторий и скопировать навыки в ~/.claude/skills/.
Через skills.sh пакет ставится командой npx skills add czlonkowski/n8n-skills — сайт n8n-skills.com указывает её как установку навыков для любого агента.
Ключевое предупреждение: пакет завязан на сторонний сервер n8n-mcp. В предпосылках README требует установленный и настроенный n8n-mcp, а .mcp.json — сконфигурированный с этим сервером. Версия 2.97.0+ добавляет то, на что опирается нативная логика: get_node перечисляет options узла, search_nodes ранжирует ядровый узел первым для фраз вроде «group by», tools_documentation документирует хелперы выражений. Более старые серверы работают, но тогда навыки несут эту подсказку сами.
Слой хуков работает только при установке плагином в Claude Code и Codex. При загрузке отдельных навыков на Claude.ai они активируются по описанию, без проактивных подсказок. Каждый хук завершается безопасно и не блокирует вызов инструмента.
Проверка, что навыки загрузились
Проверка идёт по трём точкам. Первая — соединение: команда /mcp в Claude Code должна показывать сервер n8n-mcp. Если сервера нет в списке, проверьте установку плагина и шаг добавления MCP-сервера. Для добавленного сервера выберите Authenticate и завершите вход через браузер.
Вторая — активация навыка по описанию. Сторонний README приводит примеры: запрос «How do I write n8n expressions?» активирует навык Expression Syntax, «Find me a Slack node» — MCP Tools Expert, «Build a webhook workflow» — Workflow Patterns, «Why is validation failing?» — Validation Expert. Официальный пакет работает по той же логике: frontmatter сообщает агенту, когда загружать навык.
Третья — первый запрос на сборку workflow. Попросите агента собрать простой workflow и посмотрите, ссылается ли он на конвенции n8n: синтаксис {{}}, доступ к данным вебхука через $json.body, обработку ошибок. Если ответ остался общим, попросите агента назвать загруженный навык и повторите проверку на конкретной задаче.
Типовые ошибки
MCP-доступ не включён. Документация n8n описывает характерный симптом: клиент отправляет вас в n8n подтвердить доступ, и вы попадаете на страницу «You do not have sufficient permissions to authorize this request». Для instance MCP-сервера это означает, что MCP-доступ выключен на инстансе. Пока сервер работает, любой вошедший пользователь может подтвердить клиента; пока выключен, n8n отказывает всем. Решение — попросить владельца или админа инстанса включить доступ и подключить клиента заново.
Дублирующее подключение n8n-mcp. README официального пакета предупреждает: если MCP n8n уже настроен где-то ещё, плагин добавляет собственное соединение n8n-mcp. Два набора инструментов мешают друг другу — лишний отключается из /mcp.
Отсутствие хуков при установке без плагина. README прямо говорит: плагины несут SessionStart-хук, который загружает входной навык за вас. При установке только навыков хука нет, поэтому сниппет в AGENTS.md и служит сигналом агенту начинать каждую задачу n8n с загрузки мета-навыка. Копирование папок вручную пропускает слой хуков — для его получения нужна установка плагином.
Прокси и заголовки. Документация n8n отмечает: если инстанс стоит за обратным прокси, балансировщиком или WAF, убедитесь, что они не срезают заголовки MCP-запроса. Клиенты шлют MCP-Protocol-Version, Mcp-Method и Mcp-Name; с n8n 2.36.0 они разрешены в CORS-политике. Если фильтр пропускает только allowlist, добавьте эти три заголовка, иначе клиенты могут не подключиться или откатиться на старую версию протокола.
Частые вопросы
Что такое навыки n8n и зачем они нужны?
Навыки n8n — набор markdown-модулей, которые передают кодирующему агенту знание конвенций n8n: синтаксис выражений, конфигурацию узлов, обработку ошибок. Документация n8n объясняет их назначение так: подключённый к MCP агент умеет собирать workflow, но не знает этих конвенций. Навыки закрывают этот разрыв и снижают число итераций на исправление.
Чем навыки отличаются от MCP-сервера n8n?
MCP-сервер даёт агенту доступ к вашему инстансу: поиск workflow, запуск, создание и редактирование. Навыки дают знание, как это делать по правилам n8n. Официальный README формулирует коротко: MCP даёт соединение, навыки задают стандарт. Ставятся они отдельно.
Какую версию n8n нужно для instance-level MCP?
Официальный README называет минимум n8n 2.2.0 и советует актуальный stable. Документация n8n уточняет границы: сборка и редактирование workflow через встроенный MCP — с 2.13.0, современный диалог Connect a client — с 2.33.0, доступ на уровне проектов и папок — с 2.24.0.
Какой пакет навыков выбрать — официальный или сторонний?
Официальный n8n-io/skills выпущен командой n8n, работает с instance-level MCP и несёт SessionStart- и PreToolUse-хуки. Сторонний czlonkowski/n8n-skills завязан на сторонний сервер n8n-mcp и требует его отдельной настройки в .mcp.json. Выбор зависит от того, какой MCP-сервер у вас уже развёрнут.
Почему навык не активируется после установки?
Проверьте три вещи: показывает ли /mcp сервер n8n-mcp, включён ли MCP-доступ на инстансе и не мешает ли дублирующее подключение. При установке без плагина SessionStart-хука нет — тогда нужен сниппет в AGENTS.md, который велит агенту начинать задачу n8n с загрузки мета-навыка.