Дмитрий вставил в Cursor конфиг «npx n8n-mcp» с API key: в логах «Found 20 tools», в чате – «Server not found». Instance-level MCP на localhost:5678 облачный Cursor не увидел. Боль знакомая: два разных «n8n MCP» в гайдах, зелёный статус без реальных tool-вызовов, workflow из промпта не создаётся. Ниже один путь – native instance-level MCP, Bearer Access Token, HTTPS, n8n 2.18.4+ – и первый сценарий из чата за вечер.
TL;DR / Быстрый инсайт: Для workflow из промпта в Cursor нужен instance-level MCP n8n (URL /mcp-server/http), не npx n8n-mcp. MCP Access Token ≠ REST API key. Минимум n8n 2.18.4, оба toggle: MCP на инстансе и Available in MCP на workflow. Self-hosted без HTTPS из облачного Cursor не заработает.
MCP (Model Context Protocol) – «розетка», через которую Cursor подключается к внешним инструментам. У n8n с 2026 года встроенный сервер на уровне инстанса: один URL, один токен, агент в чате может запускать workflow и собирать новые из текста. На практике это выглядит как мастерская на одном столе: слева промпт, справа n8n с Instance-level MCP – без форка community-гайдов из GitHub.
Разведите два разных «n8n MCP» – и не путайте API key с MCP-токеном
В гайдах смешивают community npx n8n-mcp (справочник по нодам через stdio) и instance-level MCP из Settings n8n (сборка workflow из промпта). Типичная ошибка: N8N_API_KEY в mcp.json вместо MCP Access Token из Connection details. API key – для REST, Bearer Access Token – для /mcp-server/http.
| Параметр | Community npx n8n-mcp | Native instance-level MCP |
|---|---|---|
| Задача | Документация нод, get_node | Сборка и запуск workflow из Cursor |
| Подключение | stdio, command npx | HTTP, url + Bearer |
| Авторизация | N8N_API_KEY (опционально) | MCP Access Token или OAuth2 |
| Версия n8n | Любая с API | От 2.18.4 для builder из промпта |
Итоговый вердикт: Для темы «как подключить n8n MCP к Cursor» и сборки workflow из промпта выбирайте только native instance-level. Community оставьте как сноску для справки по нодам.
Проверьте версию n8n и включите Instance-level MCP на инстансе
Builder из промпта – Public Preview (апрель 2026); нужен n8n 2.18.4+. Ниже этой версии агент в основном list/execute, не builder. Проверьте версию в Settings → About n8n или через CLI перед включением MCP.
Затем Settings → Instance-level MCP → Enable MCP access (owner/admin), скопируйте URL https://ваш-домен/mcp-server/http и Access Token в env (${env:N8N_MCP_TOKEN}), не в git. Для одного разработчика – Bearer Access Token; OAuth2 – для команды. Токен показывают один раз – сразу сохраните в менеджер паролей.
Добавьте n8n как HTTP MCP-сервер в Cursor – и разберитесь, если статус зелёный, а tools молчат
Cursor принимает remote MCP через url и headers в .cursor/mcp.json (проект) или ~/.cursor/mcp.json (глобально). Секреты – через ${env:NAME}, как в документации Cursor:
Пример mcp.json: в mcpServers.n8n задайте url https://ваш-домен/mcp-server/http и headers.Authorization Bearer ${env:N8N_MCP_TOKEN} — полный шаблон в документации Cursor.
Перезапустите Cursor – статус в Tools & MCP должен стать зелёным. «Found 20 tools» в логах, но «Server not found» в чате – типичный баг stdio community (forum Cursor, февраль 2026): переходите на HTTP native, смотрите MCP Logs.
- Проверьте версию n8n – для сборки из промпта нужен 2.18.4+.
- Включите Instance-level MCP в Settings n8n и скопируйте Connection details.
- Задайте N8N_MCP_TOKEN в окружении ОС, не в git.
- Добавьте блок в mcp.json с url и Authorization Bearer.
- Перезапустите Cursor и убедитесь, что статус MCP зелёный.
- Smoke-test curl – POST на /mcp-server/http с Bearer; ответ без 401.
- Спросите в чате: «Какие n8n MCP tools доступны?» – должны появиться search_workflows, create/update.
Схема подключения:
Промпт в Cursor → Agent вызывает MCP tool → HTTPS /mcp-server/http → n8n создаёт или обновляет workflow → результат виден в UI n8n
Обеспечьте публичный HTTPS, если n8n на своём сервере
localhost:5678 из облачного Cursor недоступен – нужен публичный HTTPS (VPS, tunnel с TLS, n8n Cloud). На паузе отключите MCP: N8N_DISABLED_MODULES=mcp.
Не перепутайте instance MCP с MCP Client Tool внутри n8n
Cursor → instance MCP: редактор снаружи дергает инстанс. MCP Client Tool – агент внутри n8n ходит во внешний MCP. MCP Server Trigger – один workflow как сервер. Для подключения Cursor к n8n нужен первый вариант.
| Режим | Кто клиент | Кто сервер |
|---|---|---|
| Instance-level MCP | Cursor (внешний) | Весь инстанс n8n |
| MCP Client Tool | AI Agent внутри n8n | Внешний MCP (другой сервис) |
| MCP Server Trigger | Claude, Cursor | Один workflow n8n |
Включите Available in MCP и соберите первый workflow из промпта
Включите Available in MCP на workflow (или создайте новый из чата). Нужны оба toggle: MCP на инстансе и на сценарии – без второго builder-tools не применятся к нужному workflow.
Как понять, что всё сработало: зелёный MCP в Cursor; агент перечисляет search_workflows, create/update; промпт создаёт workflow в UI; curl к /mcp-server/http с Bearer без 401. У Дмитрия после HTTPS, MCP Access Token и 2.18.4 это заняло 15 минут.
Пройдите чек-лист запуска: безопасность, HITL и ротация токена
search_workflows светит имена workflow даже при «пробном» включении – риск осознанный. Важно пройти чек-лист перед продакшеном:
- Важно: HTTPS и ротация токена при утечке; не коммитьте mcp.json с секретами.
- Human-in-the-loop на write-tools – агент из Cursor не пишет в прод без approve.
- Избегайте смешения community npx и native HTTP в одном mcp.json без явных имён серверов.
- Available in MCP только на нужных workflow.
- Отключите MCP toggle при простое; smoke-test после обновления n8n.
На neuroalex.site помогаем внедрить связку под ваш стек.
Что дальше
После первого workflow добавьте HITL на запись в CRM. Справочники: n8n MCP server, Cursor MCP, workflow builder preview. Актуальность – 2026-06-23.
Редакционная проверка: Алексей Доронин, эксперт по автоматизации бизнеса и ИИ (neuroalex.site).
Факты сверены с docs.n8n.io, blog.n8n.io и документацией Cursor на 2026-06-23; оценки спроса – экспертный intent-кластер (Wordstat MCP недоступен в Cloud run).
Частые вопросы
Нужен ли публичный HTTPS для self-hosted n8n?
Да, если Cursor не в той же сети. Используйте VPS с TLS, tunnel или n8n Cloud – тот же путь /mcp-server/http в mcp.json.
Чем instance-level MCP отличается от MCP Client Tool?
Instance-level – Cursor управляет инстансом n8n снаружи. MCP Client Tool – узел внутри workflow, когда агент n8n вызывает внешний MCP (Wordstat и т.п.). Для подключения Cursor настраивайте Settings → Instance-level MCP, не Client Tool на canvas.
Какую версию n8n ставить для сборки из Cursor?
2.18.4+ для builder из промпта (Public Preview, апрель 2026). Цикл generate → validate → execute из блога n8n рассчитан на свежий релиз.
Можно ли npx n8n-mcp вместо native?
Community-пакет – справочник 1800+ нод через stdio (GitHub czlonkowski/n8n-mcp). Для workflow из чата нужен native HTTP MCP с Bearer Access Token. Оба можно держать параллельно, токены не путать.
Почему зелёный статус, но tools не вызываются?
Частые причины: stdio community вместо HTTP native, n8n ниже 2.18.4, не включён Available in MCP, API key вместо MCP Access Token. Откройте MCP Logs, перезапустите Cursor, проверьте curl POST с Bearer на /mcp-server/http.
OAuth2 или Access Token?
Одному разработчику хватит personal MCP Access Token в Authorization Bearer. OAuth2 – для нескольких пользователей или когда политика компании требует единый вход.