n8n в MonstarX

Q: Почему мой ключ отклонён?

Проверьте, что адрес начинается с https:// и в нём нет части после ?, что ваш тариф включает API n8n (это не пробный период n8n Cloud) и что срок действия ключа не истёк.

КраткоУкажите адрес своего экземпляра n8n и ключ API n8n в строке n8n в разделе «Облачные сервисы» → «Облако». После этого конструктор MonstarX сможет показывать и читать ваши рабочие процессы и их запуски — например, чтобы создать приложение, которое вызывает вебхук процесса, или выяснить, почему запуск завершился ошибкой. Он только читает — не запускает и не меняет рабочие процессы.

Читает ваши рабочие процессы n8n и результаты их запусков.

Тип: Рабочий сервис · ключ API
Категория: Автоматизация
Как подключить: Ключ API

n8n — инструмент для автоматизации: вы соединяете приложения и шаги в рабочие процессы (workflows), которые срабатывают по триггеру, а каждый запуск называется execution. Подключите свой экземпляр n8n по ключу API (коду вроде пароля, через который программа пользуется вашим n8n), и конструктор MonstarX — ИИ, с которым вы общаетесь в чате, — сможет во время работы читать ваши рабочие процессы и их запуски: посмотреть, что ожидает вебхук процесса, прежде чем связывать с ним приложение, или разобраться, почему ночной запуск завершился ошибкой.

Это рабочий сервис: MonstarX читает n8n за вас. Само приложение, которое вы создаёте, ваш ключ никогда не получает.

Что может MonstarX?

Что может MonstarX	Когда
Показать ваши рабочие процессы, до 100 за раз	В любом режиме
Прочитать рабочий процесс — его шаги и настройки	В любом режиме
Показать запуски — всех процессов или одного	В любом режиме
Прочитать запуск — как он прошёл	В любом режиме

Чего MonstarX никогда не делает: не запускает, не активирует, не деактивирует, не создаёт, не редактирует и не удаляет рабочие процессы, не повторяет и не останавливает запуски.

Что понадобится

Экземпляр n8n, доступный из интернета по HTTPS по обычному веб-адресу, — n8n Cloud (например, https://your-name.app.n8n.cloud) или ваш собственный сервер. Адреса в частной сети, адреса в виде одного IP и localhost не принимаются.
API n8n. Он недоступен в бесплатном пробном периоде n8n Cloud — сначала перейдите на платный тариф. На собственном сервере публичный API не должен быть выключен.
Вы — владелец проекта в MonstarX. Подключать и отключать сервисы может только владелец.

Получите ключ

Войдите в n8n и откройте Settings > n8n API.
Выберите Create an API key, задайте Label (например, MonstarX) и Expiration.
На тарифе Enterprise нужно ещё выбрать Scopes: дайте ключу workflow:list, workflow:read, execution:list и execution:read. На остальных тарифах у ключа полный доступ.
Скопируйте My API Key.

Инструкция n8n: Authentication.

Подключите ключ в MonstarX

Откройте проект, нажмите Облачные сервисы на верхней панели, затем Облако.
Прокрутите до раздела Подключения, найдите n8n и нажмите Подключить.
Введите адрес экземпляра в поле URL экземпляра n8n (только адрес, например https://your-name.app.n8n.cloud), вставьте ключ в поле Ключ API n8n и нажмите Подключить.
MonstarX проверяет адрес и ключ, запрашивая один рабочий процесс. Если всё в порядке, в строке появится Подключён экземпляр и адрес вашего экземпляра. Если адрес или ключ отклонён, вы увидите ошибку, и ничего не сохранится.

Как попросить MonstarX

Вы пишете	Что происходит
«Прочитай мой рабочий процесс в n8n „Новая запись“ и сделай так, чтобы форма записи отправляла данные в его вебхук.»	MonstarX читает процесс, выясняет, что ожидает вебхук, и в режиме Создать связывает с ним форму.
«Почему мой процесс „Ежедневный отчёт“ упал прошлой ночью?»	MonstarX получает список запусков этого процесса, читает неудачный и объясняет причину.
«Какие из моих рабочих процессов в n8n активны?»	MonstarX показывает список процессов и их состояние.

Безопасность и конфиденциальность

Ключ остаётся в MonstarX. Он хранится в зашифрованном виде на серверах MonstarX, никогда не попадает в код приложения и не передаётся самому приложению.
Только чтение. MonstarX только читает. На тарифе Enterprise дайте ключу только права на чтение.
Только как информация. Данные рабочих процессов и результаты запусков могут содержать данные вашего бизнеса. MonstarX воспринимает их как информацию, а не как инструкции.
Отключить можно в любой момент. Нажмите Отключить рядом с n8n в разделе Облачные сервисыОблако и подтвердите вопрос Отключить n8n от этого проекта?. MonstarX удалит адрес и ключ. Если ключ больше не нужен, удалите его и в n8n, в разделе Settings > n8n API.

Полезно знать

Ваш экземпляр должен отвечать на каждый запрос в течение 15 секунд. Очень медленный или «спящий» экземпляр может не успеть — попробуйте ещё раз.
Когда срок действия ключа в n8n истечёт, запросы перестанут проходить. Создайте новый ключ и подключите его заново.
Чтобы приложение запускало рабочий процесс, попросите MonstarX вызывать из приложения вебхук этого процесса: адрес вебхука — часть самого процесса, а не этого подключения.

Вопросы и ответы

Может ли MonstarX запускать мои рабочие процессы n8n?

Не через это подключение — оно только читает процессы и запуски. Но приложение может запустить процесс, вызвав его вебхук; попросите MonstarX это сделать.

Работает ли это с n8n на своём сервере?

Да, если экземпляр доступен из интернета по адресу HTTPS и на нём включён публичный API. До экземпляров в частной сети или на localhost MonstarX не достучится.

Почему мой ключ отклонён?

Проверьте, что адрес начинается с https:// и в нём нет части после ?, что ваш тариф включает API n8n (это не пробный период n8n Cloud) и что срок действия ключа не истёк.