n8n n8n@2.29.0

n8n n8n@2.29.0

Resumo

O n8n 2.29.0 é um release extenso, com novidades para roles globais, credenciais privadas, Instance AI, MCP, armazenamento de arquivos binários, Browser Use e autenticação por Service Principal em integrações Microsoft. A lista de correções também é grande e passa por execução, OAuth2, SSO, task runner, community packages, editor, nodes de integração e comportamento de workflows em produção.

Novidades

• n8n n8n@2.29.0 — Bloqueio de hostnames: administradores passam a configurar hostnames bloqueados para requisições outbound, criando uma camada de controle para chamadas externas feitas por workflows.
• n8n n8n@2.29.0 — Credencial Microsoft Entra: o release adiciona credencial de Service Principal do Microsoft Entra, ampliando opções de autenticação para automações corporativas.
• n8n n8n@2.29.0 — Roles globais pela API: a API passa a listar membros de uma role global de instância, o que ajuda auditoria e integração administrativa.
• n8n n8n@2.29.0 — Armazenamento Azure: o core adiciona modo de armazenamento Azure para arquivos binários, alternativa importante para instalações que já usam serviços gerenciados da Microsoft.
• n8n n8n@2.29.0 — Escopo de credenciais privadas: o escopo credential:connect entra para credenciais privadas, deixando permissões de conexão mais granulares.
• n8n n8n@2.29.0 — Métricas de pool do banco: o core passa a expor métricas do pool de conexões do banco, o que facilita observar saturação ou vazamento de conexão em instâncias com carga alta.
• n8n n8n@2.29.0 — Histórico de workflows via MCP: ferramentas MCP foram adicionadas para acessar e restaurar histórico de workflows, aproximando agentes e automações de uma trilha de recuperação mais explícita.
• n8n n8n@2.29.0 — OAuth MCP: as respostas de autorização OAuth do MCP passam a incluir o parâmetro iss definido pela RFC 9207, reduzindo ambiguidade de emissor em integrações.
• n8n n8n@2.29.0 — Configurações via MCP: ferramentas MCP podem definir configurações de workflow, o que exige atenção quando agentes ou integrações ganham permissão de alteração.
• n8n n8n@2.29.0 — Grupos no canvas: a visualização de execução passa a exibir grupos do canvas, ajudando a leitura de workflows maiores durante depuração.
• n8n n8n@2.29.0 — Execuções de avaliação: a variável global $evaluation.runId fica disponível em execuções de avaliação, melhorando rastreabilidade de testes.
• n8n n8n@2.29.0 — Instance AI: a versão adiciona aviso de IA no chat, setup de credenciais guiado pela documentação, suporte a skill references e allowed tools, além da remoção de informações da Instance AI quando o usuário é excluído.
• n8n n8n@2.29.0 — Roles no editor: telas de criação, edição e visualização de roles de instância entram atrás de flag de ambiente, com agrupamento de permissões, seletor e aba de atribuições de usuários.
• n8n n8n@2.29.0 — Browser Use: o Browser Use pode ser ativado separadamente do Computer Use e a extensão do navegador passa a conectar diretamente na instância n8n.
• n8n n8n@2.29.0 — Integrações Microsoft: os nodes Microsoft OneDrive e Outlook recebem autenticação por Service Principal app-only.
• n8n n8n@2.29.0 — Slack e GitHub: o Slack Node adiciona agendamento de mensagens e busca de usuário por e-mail, enquanto o GitHub Node recebe credencial para GitHub App API.
• n8n n8n@2.29.0 — Snowflake e xAI: o Snowflake Node adiciona hostname de origem opcional, e o modelo xAI Grok recebe opções de reasoning effort e priority.

Melhorias

• n8n n8n@2.29.0 — Community nodes: novas regras de lint evitam parâmetros duplicados, exigem licença MIT e reforçam convenções de trigger nodes em community nodes.
• n8n n8n@2.29.0 — Tipos para nodes customizados: o MCP passa a sintetizar definições de tipos para nodes customizados e community nodes, melhorando a experiência de ferramentas que constroem workflows.
• n8n n8n@2.29.0 — Insights sem informação suficiente: o core mostra alerta quando o intervalo de tempo selecionado para insights não possui informação suficiente, evitando leitura errada de métricas.
• n8n n8n@2.29.0 — Chat Hub: o Chat Hub fica desligado por padrão em instâncias que não usam o recurso, reduzindo superfície ativa desnecessária.
• n8n n8n@2.29.0 — Blob storage: a versão introduz uma camada reutilizável de blob storage, preparando o caminho para armazenamento mais consistente de arquivos.
• n8n n8n@2.29.0 — Disclaimers da IA: o editor passa a exibir aviso de IA só depois da resposta do AI Assistant, e a copy de disclaimer de entrada também foi atualizada.
• n8n n8n@2.29.0 — Telemetria de mutação: linhas de ledger de mutation-health passam a emitir churn e fix_density, além de popular esses campos a partir do setup.

Correções

• n8n n8n@2.29.0 — Prioridade de variáveis: variáveis de projeto agora sobrescrevem corretamente variáveis globais com a mesma chave.
• n8n n8n@2.29.0 — SSO e roles customizadas: o core bloqueia a exclusão de uma role customizada quando ela ainda é referenciada por regra de mapeamento SSO.
• n8n n8n@2.29.0 — OAuth2: respostas de token com content type fora do padrão passam a ser interpretadas, e refresh de credencial OAuth2 fica serializado para evitar invalidação de refresh token em rotação concorrente.
• n8n n8n@2.29.0 — Task runner: o task runner continua servindo durante graceful shutdown para finalizar execuções em andamento, e o timeout de shutdown passa a ser propagado ao runner interno.
• n8n n8n@2.29.0 — Execução parcial: a execução parcial deixa de quebrar quando o start node está desabilitado, e o retry de execução protege acesso a runData ausente.
• n8n n8n@2.29.0 — Community packages: a inicialização fica protegida contra community packages parcialmente instalados, e alterações em community nodes com symlink podem recarregar sem restart.
• n8n n8n@2.29.0 — Arquivos binários: metadados de arquivos binários são preservados em cópia e renomeação no S3.
• n8n n8n@2.29.0 — Health check: a conexão de ping do banco é liberada quando o health check expira, reduzindo chance de retenção indevida no pool.
• n8n n8n@2.29.0 — Webhooks: espaços em branco no path do webhook são removidos no registro, evitando rotas inválidas por erro de digitação.
• n8n n8n@2.29.0 — AWS STS: endpoints regionais de AWS STS passam a ser usados para China e GovCloud.
• n8n n8n@2.29.0 — Instance AI: a configuração e verificação de workflows da Instance AI ficam repetíveis, respostas do assistente e entradas do usuário são preservadas quando a interação suspende, e falhas em background são reportadas ao Sentry.
• n8n n8n@2.29.0 — Credenciais de LLM: headers customizados de OpenAI e Anthropic deixam de causar comportamentos inconsistentes, e o raciocínio Anthropic do AI Assistant é preservado através do proxy.
• n8n n8n@2.29.0 — Workflow builder MCP: validadores por tipo de node passam a rodar nas ferramentas MCP de construção de workflow, reduzindo erro de montagem antes da execução.
• n8n n8n@2.29.0 — Split in batches: cadeias de Split in Batches passam a ser roteadas pela saída de loop, corrigindo fluxo em workflows com iteração.
• n8n n8n@2.29.0 — Editor: o editor corrige tooltip de recursos referenciados, criação de data table em instâncias read-only, abreviação de números grandes, responsividade do InputTriple, navegação da Instance AI, redirecionamento após arquivar ou excluir workflow, ordenação de projetos e menu do painel de logs.
• n8n n8n@2.29.0 — Data tables e usuários: ao excluir um usuário, o editor passa a transferir propriedade ou excluir data tables, evitando registros presos a usuário removido.
• n8n n8n@2.29.0 — Email IMAP: o Email Read IMAP Node usa 7BIT como padrão quando uma parte da mensagem não informa encoding.
• n8n n8n@2.29.0 — ExecuteCommand: o ExecuteCommand Node passa a respeitar o abort signal, reduzindo execução que continua depois de cancelamento.
• n8n n8n@2.29.0 — Facebook Graph API: respostas de erro e itens com falha passam a seguir para a saída de erro apropriada.
• n8n n8n@2.29.0 — Google Vertex: o Google Vertex Chat Model Node passa a aceitar modelos Gemini mais recentes e configurações de residência em EU ou US.
• n8n n8n@2.29.0 — MCP nodes: o MCP Client Tool Node reutiliza a sessão MCP durante uma execução, e o MCP Server Trigger Node propaga erros de ferramenta com isError.
• n8n n8n@2.29.0 — Microsoft Teams: o escopo OAuth2 do Microsoft Teams Node foi reduzido de Group.ReadWrite.All para Group.Read.All.
• n8n n8n@2.29.0 — Bancos e integrações: MySQL passa a rotear erros de validação de parâmetro de query para saída de erro, Postgres deixa de reter execution context, Notion Trigger lida com polling sem resultado, Salesforce usa busca server-side para owner selectors e WooCommerce valida resource ID isolando query params por item.
• n8n n8n@2.29.0 — OpenAI Node: stream binário é convertido para buffer antes de anexar ao FormData, e mensagens de assistente em Message a Model passam a usar output_text.
• n8n n8n@2.29.0 — Schedule Node: schedules que paravam permanentemente voltam a disparar conforme esperado.
• n8n n8n@2.29.0 — Sticky notes: o espaçamento de parágrafos em sticky notes é restaurado sem quebrar blocos de código.

Breaking changes

Nenhuma breaking change explícita foi publicada. Ainda assim, roles globais, escopos de credencial, Service Principal, MCP com acesso a histórico e bloqueio de hostnames alteram superfícies administrativas que merecem teste antes de atualizar instâncias com permissão granular.

Ponto de Atenção

• Teste sugerido: em uma instância com SSO, tente remover uma role customizada ainda referenciada por mapeamento e confirme se o bloqueio aparece antes da exclusão.
• Teste sugerido: rode workflows com task runner durante graceful shutdown e confirme se execuções em andamento concluem antes de a instância encerrar.
• Teste sugerido: valide uma credencial OAuth2 com refresh concorrente e confirme se a rotação não invalida o refresh token.
• Teste sugerido: crie ou restaure workflows via MCP apenas em ambiente controlado e confirme permissões, histórico restaurado e configurações alteradas antes de liberar em produção.
• Teste sugerido: revise integrações Microsoft com Service Principal e confirme escopos, tenant e permissões antes de trocar credenciais em workflows existentes.
• Teste sugerido: use Browser Use e a extensão conectando diretamente à instância n8n, validando autenticação e superfície de navegação autorizada.
• Teste sugerido: execute nodes de Facebook Graph API, MySQL, Postgres, OpenAI, Schedule, Slack, Snowflake e WooCommerce em workflows de teste para confirmar saídas de erro, autenticação e payloads.

Notas da versão

O volume do release indica atualização relevante para instâncias com IA, MCP, Browser Use, roles e integrações corporativas. A recomendação técnica é validar permissões administrativas, credenciais e workflows críticos em ambiente separado antes de promover o update.