Use o n8n com o MonstarX
ResumindoInforme o endereço da sua instância do n8n e uma chave de API do n8n na linha do n8n em Backend → Nuvem. O agente do MonstarX passa a listar e ler seus workflows e as execuções deles — por exemplo, para criar um app que chama o webhook de um workflow ou descobrir por que uma execução falhou. Ele só lê: não executa nem altera workflows.
Leia seus workflows do n8n e como foram as execuções.
- Tipo
- Ferramenta de negócios · chave de API
- Categoria
- Automação
- Conecte com
- Chave de API
O n8n é uma ferramenta de automação: você liga apps e etapas em workflows que rodam a partir de um gatilho, e cada rodada é uma execução. Conecte sua instância do n8n com uma chave de API (um código, parecido com uma senha, que permite que um software use o seu n8n) e o agente do MonstarX (a IA com quem você conversa) consegue ler seus workflows e as execuções enquanto trabalha: ver o que o webhook de um workflow espera antes de ligar o seu app a ele, ou investigar por que a execução da noite passada falhou.
Esta é uma ferramenta de negócio: o MonstarX lê o n8n por você. O app que você cria nunca recebe a sua chave.
O que o MonstarX pode fazer com ele?
Seção intitulada “O que o MonstarX pode fazer com ele?”| O que o MonstarX pode fazer | Quando |
|---|---|
| Listar seus workflows, até 100 por vez | Qualquer modo |
| Ler um workflow: as etapas e configurações | Qualquer modo |
| Listar execuções, de todos os workflows ou de um só | Qualquer modo |
| Ler uma execução: como foi uma rodada | Qualquer modo |
O que ele nunca faz: executar, ativar, desativar, criar, editar ou excluir workflows, nem tentar de novo ou interromper execuções.
Antes de começar
Seção intitulada “Antes de começar”- Uma instância do n8n acessível pela internet via HTTPS em um endereço web normal — o n8n Cloud (como
https://your-name.app.n8n.cloud) ou o seu próprio servidor. Endereços de rede privada, endereços IP puros elocalhostsão recusados. - A API do n8n. Ela não está disponível durante o teste gratuito do n8n Cloud; faça o upgrade antes. Em uma instância auto-hospedada, a API pública não pode estar desativada.
- Você é o proprietário do projeto no MonstarX. Só o proprietário pode conectar ou desconectar uma ferramenta.
Pegue sua chave
Seção intitulada “Pegue sua chave”-
Entre no n8n e vá em Settings > n8n API.
-
Selecione Create an API key, escolha um Label (como
MonstarX) e uma Expiration. -
No plano Enterprise, você também escolhe os Scopes: dê a ela
workflow:list,workflow:read,execution:listeexecution:read. Nos outros planos, a chave tem acesso total. -
Copie a My API Key.
Guia do próprio n8n: Authentication.
Conecte no MonstarX
Seção intitulada “Conecte no MonstarX”-
Abra seu projeto e clique em Backend na barra superior e depois em Nuvem.
-
Role até Conectores, encontre o n8n e clique em Conectar.
-
Digite o endereço da sua instância em URL da instância n8n (só o endereço, como
https://your-name.app.n8n.cloud), cole a chave no campo Chave de API e clique em Conectar. -
O MonstarX testa os dois listando um workflow. Se der certo, a linha mostra Conectado a e o endereço da sua instância. Se o endereço ou a chave forem recusados, você vê o erro e nada é salvo.
Peça ao MonstarX para usar
Seção intitulada “Peça ao MonstarX para usar”| Você digita | O que acontece |
|---|---|
| “Leia meu workflow do n8n ‘Novo agendamento’ e faça o formulário de agendamento enviar para o webhook dele.” | O MonstarX lê o workflow, descobre o que o webhook espera e, no modo Criar, liga o formulário a ele. |
| “Por que meu workflow ‘Relatório diário’ falhou ontem à noite?” | Ele lista as execuções desse workflow, lê a que falhou e explica. |
| “Quais dos meus workflows do n8n estão ativos?” | Ele lista seus workflows e o estado de cada um. |
Segurança e privacidade
Seção intitulada “Segurança e privacidade”- Fica com o MonstarX. A chave fica guardada com criptografia nos servidores do MonstarX. Ela nunca é escrita no código do seu app nem entregue a ele.
- Só leitura. O MonstarX só lê. No Enterprise, dê à chave apenas escopos de leitura.
- Lido como informação. Os dados dos workflows e os resultados das execuções podem conter dados do seu negócio; o MonstarX os trata como informação, nunca como instrução.
- Desconecte quando quiser. Clique em Desconectar ao lado do n8n em BackendNuvem e confirme Desconectar o n8n deste projeto?. O MonstarX apaga o endereço e a chave. Se não precisar mais da chave, exclua-a também em Settings > n8n API.
Bom saber
Seção intitulada “Bom saber”- Cada solicitação à sua instância precisa ter resposta em até 15 segundos. Uma instância muito lenta ou adormecida pode estourar o tempo; tente de novo.
- Quando a chave expira no n8n, as solicitações falham. Crie uma chave nova e conecte de novo.
- Para o seu app disparar um workflow, peça ao MonstarX para chamar o webhook do workflow a partir do app — o endereço do webhook faz parte do workflow, não desta conexão.
Perguntas frequentes
Seção intitulada “Perguntas frequentes”O MonstarX pode executar meus workflows do n8n?
Não por esta conexão — ela só lê workflows e execuções. Seu app ainda pode iniciar um workflow chamando o webhook dele; peça ao MonstarX para criar isso.
Funciona com n8n auto-hospedado?
Sim, se a sua instância for acessível pela internet em um endereço HTTPS e a API pública estiver ativada. Instâncias em rede privada ou em localhost não podem ser acessadas.
Por que minha chave foi recusada?
Confira se o endereço começa com https:// e não tem uma parte com ?, se o seu plano inclui a API do n8n (o teste gratuito do Cloud não inclui) e se a chave não expirou.