> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrmex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

> Conecte a automação de workflows n8n ao Myrmex com uma chave de API — crie a chave e adicione a integração.

import { Note, Steps, Step, CardGroup, Card, Tip } from '@mintlify/components';

Conecte o **n8n** para que o Myrmex possa trabalhar com seus workflows de automação. O Myrmex opera a API REST do n8n ao vivo usando uma chave de API — lendo e atuando sob demanda, sem armazenar nada do lado do Myrmex. Para um n8n self-hosted na sua rede privada, alcance-o através de um [Collector](/pt/documentation/agent-endpoint-security/collector-mode).

## O Que o Myrmex Pode Fazer

<CardGroup cols={2}>
  <Card title="Inspecionar workflows" icon="diagram-project">
    Liste workflows e revise sua configuração sob demanda.
  </Card>

  <Card title="Verificar execuções" icon="list-check">
    Consulte o histórico de execuções e o status quando você pedir.
  </Card>

  <Card title="Disparar automação" icon="play">
    Execute workflows como parte de uma resposta automatizada — com aprovação, via [Hydra](/pt/documentation/multi-agent-system/integration-specialist-agent).
  </Card>

  <Card title="Orquestrar" icon="link">
    Conecte automações do n8n às suas outras integrações.
  </Card>
</CardGroup>

## Antes de Começar

* A **URL base** do seu n8n (por exemplo `n8n.your-domain.com`).
* Uma conta n8n que possa criar uma **chave de API**.
* Um **Collector** se a instância do n8n estiver na sua rede privada.

## Passo 1 — Crie a Chave de API no n8n

O n8n autentica com uma chave de API que o Myrmex envia no cabeçalho `X-N8N-API-KEY`.

<Steps>
  <Step title="Faça login no n8n">
    Entre com uma conta que possa gerenciar chaves de API.
  </Step>

  <Step title="Abra as configurações da API">
    Vá em **Settings → n8n API**.
  </Step>

  <Step title="Crie e copie a chave">
    Crie uma chave de API, dê um rótulo (por exemplo `Myrmex`) e copie-a — guarde em um lugar seguro.
  </Step>
</Steps>

<Tip>
  Você pode revogar ou rotacionar a chave na mesma tela a qualquer momento.
</Tip>

## Passo 2 — Adicione a Integração no Myrmex

No **Directory**, escolha **Add Integration → n8n** e preencha:

| Field           | Descrição                                                                                                  |
| --------------- | ---------------------------------------------------------------------------------------------------------- |
| **Name**        | Um nome único para esta instância do n8n.                                                                  |
| **Description** | Nota opcional para identificá-la.                                                                          |
| **API Token**   | A chave de API do Passo 1.                                                                                 |
| **Protocol**    | `https` (padrão).                                                                                          |
| **URL**         | O host do n8n (por exemplo `n8n.your-domain.com`).                                                         |
| **Port**        | Porta da API (padrão `443`).                                                                               |
| **Collector**   | [Collector](/pt/documentation/agent-endpoint-security/collector-mode) opcional para uma instância privada. |

<Note>
  O tipo de autenticação (`api-key`) e o nome do cabeçalho (`X-N8N-API-KEY`) já vêm predefinidos para este conector — você fornece apenas a chave em si.
</Note>

## Conectar

Clique em **Connect** para validar a conexão e concluir. O n8n então aparece em **Environment → Integrations**. Novo em integrações? Veja a [visão geral de Integrações](/pt/documentation/integrations/overview).
