Instale um community Node no n8n

A instalação de um community Node exige o perfil Owner ou Admin. Para um componente verificado, você pode iniciar pelo próprio canvas. Para um pacote npm não verificado, use as configurações de uma instância self-hosted que permita esse tipo de instalação.

Instalação de um Node verificado

Abra o painel de Nodes pelo botão + no canvas. Pesquise o componente e procure a seção More from the community. Selecione o resultado para ver as ações disponíveis e use install.

O componente fica instalado na instância. Depois disso, você pode adicioná-lo ao workflow. Os demais membros também conseguem usar o Node, mesmo sem permissão para instalar pacotes.

Instalação pelo nome no npm

Abra Settings > Community Nodes e selecione Install. A opção Browse abre a pesquisa de pacotes npm com a palavra-chave n8n-community-node-package.

Confira a documentação do pacote encontrado. No campo Enter npm package name, informe o nome exato. Você pode acrescentar uma versão com @VERSAO, substituindo o marcador pela versão publicada que pretende usar.

Leia o aviso sobre a execução de código não verificado, marque a confirmação correspondente e selecione Install. O n8n retorna à lista de pacotes instalados. A confirmação exige atenção porque esse código pode acessar o servidor e o conteúdo dos workflows.

Versão instalada e atualizações

A documentação permite usar uma dist-tag publicada pelo autor do pacote. Essa tag é resolvida no momento da instalação. Atualizações posteriores comparam versões semver com a versão instalada, sem acompanhar automaticamente a tag escolhida.

Para atualizar pela interface, use Update quando disponível. Para instalar outra versão específica ou voltar a uma anterior, a orientação oficial é desinstalar o pacote e reinstalá-lo com a versão desejada. Confira os workflows dependentes antes dessa alteração.

Confira o componente no workflow

Pesquise o Node no painel, adicione-o a um workflow de teste e configure uma ação pequena conforme a documentação do pacote. Compare a saída com o resultado esperado antes de publicar a automação.

Se a interface estiver somente para leitura, confira se a instância usa N8N_COMMUNITY_PACKAGES_MANAGED_BY_ENV=true. Nesse modo, a lista de pacotes é gerenciada por variáveis de ambiente, portanto a instalação pela interface fica indisponível.