REPOSITÓRIO / WORKFLOWS, IA E CONTROLE / CDD-CONTENT-000150 / 2026-08-21
n8n
Plataforma source-available para construir e operar workflows que combinam integrações, lógica visual, código e recursos de IA.
18 MIN · INTERMEDIÁRIO[01] POR QUE ENTROU NA BIBLIOTECA
O n8n entrou porque permite observar, no mesmo ambiente, o que deve ser workflow determinístico, o que realmente pede decisão por IA e onde código ou MCP ampliam a integração.
[02] O QUE É E PARA QUEM É
n8n combina construção visual, integrações, lógica de workflow e código quando necessário. Esta página se concentra no repositório e no caminho self-hosted, não em comparação de planos comerciais.
JavaScript e Python podem ser usados no Code node, mas não são equivalentes perfeitos: Python nativo usa task runners e o acesso a bibliotecas depende do ambiente.
[03] TRÊS MECANISMOS QUE NÃO SÃO EQUIVALENTES
NODE DETERMINÍSTICO
O fluxo decide pela ordem e pelas condições. Use quando ação e momento são previsíveis.TOOL DE AGENTE
O agente decide quando chamar uma ação estreita já configurada. Limite parâmetros, permissões e fallback.MCP SERVER
O agente escolhe entre capacidades mais amplas. Use somente quando a amplitude é necessária e pode ser governada.[04] LICENÇA
n8n usa o modelo fair-code/source-available; não deve ser descrito como open source no sentido OSI.
A Sustainable Use License permite uso e modificação internos, pessoais ou não comerciais, mas limita redistribuição e exploração comercial. Para SaaS, OEM, redistribuição ou uso de credenciais de usuários finais, a página é apenas orientação editorial: revise a licença no caso concreto.
[05] QUANDO NÃO USAR
- Quando processo, regra, saída ou responsável ainda não estão claros.
- Quando uma integração direta resolve com menos infraestrutura.
- Quando a equipe não quer assumir atualização, backup, monitoramento e resposta a falhas.
- Quando um agente pede acesso amplo sem uma razão operacional verificável.
[06] QUICK START LOCAL
docker volume create n8n_data docker run -it --rm \ --name n8n \ -p 5678:5678 \ -e GENERIC_TIMEZONE="<YOUR_TIMEZONE>" \ -e TZ="<YOUR_TIMEZONE>" \ -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \ -v n8n_data:/home/node/.n8n \ docker.n8n.io/n8nio/n8n
[07] PRIMEIRO EXPERIMENTO
Crie um fluxo local com Manual Trigger, três registros fictícios e uma condição explícita. A saída deve permanecer interna à execução.
- Adicionar Manual Trigger.
- Criar três registros fictícios com dados não sensíveis.
- Separar os itens por uma regra objetiva, como tipo = renovação.
- Executar manualmente e inspecionar entrada e saída de cada etapa.
- Não enviar mensagens, escrever em banco externo nem conectar credenciais.
[08] CUIDADOS DE USO
- 01Use credenciais com o menor escopo e não cole tokens em campos de texto quando houver mecanismo próprio.
- 02Mantenha volume persistente, chave de criptografia, backups e teste de restauração no mesmo plano de operação.
- 03Limite tools e permissões antes de expor um agente ou MCP; ações irreversíveis pedem revisão humana.
- 04Fixe versão, leia release notes e teste upgrades fora de produção.
FONTES E CONTINUIDADE