🔧 Что это

n8n MCP Setup Assistant — это навык для Claude, который автоматизирует подключение MCP-серверов (Model Context Protocol) к среде разработки n8n. Он задуман для инженеров, которые работают с n8n и хотят быстро интегрировать Claude с популярными сервисами: Linear, Notion, Context7 и Figma.

Вместо того чтобы вручную запоминать команды и URL для каждого MCP, навык проводит пользователя через весь процесс: проверяет уже установленные серверы, предлагает выбрать недостающие, настраивает их с нужной областью видимости (user или local) и напоминает про завершающую аутентификацию.

⚙️ Как работает

Навык запускается по команде /setup-mcps или по прямому запросу пользователя «настрой MCP для n8n». Выполняется несколько последовательных шагов.

🔍 Проверка уже установленных MCP

Сначала навык выполняет команду:

claude mcp list

Он анализирует вывод, сопоставляя серверы по URL или команде, а не по имени (пользователь мог назвать их произвольно). Проверяются целевые URL/команды:

• mcp.linear.app — Linear
• mcp.notion.com — Notion
• ctx7 или context7-mcp — Context7
• mcp.figma.com — Figma

Если какой-то MCP уже присутствует (независимо от области видимости и имени), он исключается из списка предлагаемых.

🗳️ Выбор MCP для установки

Если хотя бы один MCP ещё не настроен, навык выводит меню в виде вопроса с мультивыбором (multiSelect: true). В меню отображаются только те серверы, которые ещё не установлены. Если все четыре уже есть, пользователь получает сообщение, что настройка не требуется, и процесс завершается.

Меню содержит четыре опции:

• Linear — управление задачами через HTTP с OAuth (откроет браузер для аутентификации)
• Notion — интеграция с рабочим пространством Notion (HTTP + OAuth)
• Context7 — поиск по библиотеке документации (настройка OAuth через CLI)
• Figma — интеграция с макетами Figma (HTTP + OAuth)

🔄 Установка каждого MCP

После выбора навык обрабатывает каждый MCP по одному в цикле. Для каждого он:

1. Запрашивает область видимости (scope) отдельным вопросом: «Где установить {имя MCP}?»

   • user (рекомендуется) — доступен во всех проектах Claude
   • local — только в текущем проекте
   • Проектный scope (project) не предлагается, так как он изменяет файл .claude/settings.json, который часто находится под git-контролем.

2. Выполняет команду установки в зависимости от выбранного scope и типа MCP:

   • Linear

     claude mcp add -s {scope} linear-server --transport http https://mcp.linear.app/mcp
     

     После установки навык напоминает, что в следующей сессии нужно выполнить /mcp для аутентификации.

   • Notion

     claude mcp add -s {scope} notion --transport http https://mcp.notion.com/mcp
     

     То же напоминание про /mcp.

   • Context7 Установка выполняется самим пользователем (навык выдаёт команду, но не запускает её автоматически, так как она требует интерактивного OAuth):

     npx ctx7 setup --claude
     

     Эта команда сама обработает аутентификацию.

   • Figma

     claude mcp add -s {scope} figma --transport http https://mcp.figma.com/mcp
     

     Затем — напоминание про /mcp.

3. Подводит итог — перечисляет, какие MCP были настроены и какие ручные шаги ещё остаются (для Context7 — самостоятельный запуск, для остальных — /mcp в следующей сессии).

🎯 Когда использовать

• Вы n8n-разработчик и хотите подключить Claude к инструментам, которыми уже пользуетесь (Linear для задач, Notion для документации, Figma для дизайнов, Context7 для поиска по библиотекам).
• Вы впервые настраиваете MCP или хотите быстро добавить один или несколько из этих серверов без запоминания параметров.
• Вы предпочитаете интерактивный процесс с выбором и подтверждениями, а не написание команд вручную.

💡 Важно знать

• Нельзя батчить вопросы о scope — навык спрашивает про каждый MCP по отдельности. Это гарантирует, что пользователь осознанно выбирает область видимости для каждого сервера.
• Project scope исключён — чтобы случайно не изменить файл .claude/settings.json, который версионируется. Используйте local, если нужно ограничить доступ к одному проекту.
• Аутентификация через OAuth для Linear, Notion и Figma происходит в веб-браузере после запуска /mcp в следующем сеансе Claude. Это стандартный механизм, и навык о нём напоминает.
• Context7 требует ручного запуска npx ctx7 setup --claude — это связано с тем, что он самостоятельно открывает браузер и завершает OAuth-поток. Навык не может сделать это за пользователя, так как команда интерактивна.
• Навык не перезаписывает уже установленные MCP — он их пропускает. Если вы вручную добавили MCP с другим именем, но тем же URL, навык его обнаружит и не будет дублировать.

Синхронизируйте навыки с Claude Cowork, Claude Code, Codex и другими.

Установка одной командой.

npx skillfish add n8n-io/n8n setup-mcps