> ## 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

> Collega l'automazione dei workflow n8n a Myrmex con una API key: crea la chiave e aggiungi l'integrazione.

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

Collega **n8n** in modo che Myrmex possa lavorare con i tuoi workflow di automazione. Myrmex opera l'API REST di n8n in tempo reale usando una API key, leggendo e agendo su richiesta, senza che nulla venga memorizzato dalla parte di Myrmex. Per un'istanza n8n self-hosted sulla tua rete privata, raggiungila attraverso un [Collector](/it/documentation/agent-endpoint-security/collector-mode).

## Cosa può fare Myrmex

<CardGroup cols={2}>
  <Card title="Ispezionare i workflow" icon="diagram-project">
    Elenca i workflow e rivedi la loro configurazione su richiesta.
  </Card>

  <Card title="Verificare le esecuzioni" icon="list-check">
    Consulta la cronologia e lo stato delle esecuzioni quando lo richiedi.
  </Card>

  <Card title="Attivare l'automazione" icon="play">
    Esegui i workflow come parte di una risposta automatizzata, con approvazione, tramite [Hydra](/it/documentation/multi-agent-system/integration-specialist-agent).
  </Card>

  <Card title="Orchestrare" icon="link">
    Collega le automazioni n8n alle tue altre integrazioni.
  </Card>
</CardGroup>

## Prima di iniziare

* L'**URL di base** di n8n (ad esempio `n8n.your-domain.com`).
* Un account n8n in grado di creare una **API key**.
* Un **Collector** se l'istanza n8n è sulla tua rete privata.

## Passaggio 1 — Crea l'API key in n8n

n8n si autentica con una API key che Myrmex invia nell'header `X-N8N-API-KEY`.

<Steps>
  <Step title="Accedi a n8n">
    Accedi con un account in grado di gestire le API key.
  </Step>

  <Step title="Apri le impostazioni API">
    Vai su **Settings → n8n API**.
  </Step>

  <Step title="Crea e copia la chiave">
    Crea una API key, assegnale un'etichetta (ad esempio `Myrmex`) e copiala: conservala in un luogo sicuro.
  </Step>
</Steps>

<Tip>
  Puoi revocare o ruotare la chiave dalla stessa schermata in qualsiasi momento.
</Tip>

## Passaggio 2 — Aggiungi l'integrazione in Myrmex

Dalla **Directory**, scegli **Add Integration → n8n**, quindi compila:

| Field           | Description                                                                                               |
| --------------- | --------------------------------------------------------------------------------------------------------- |
| **Name**        | Un nome univoco per questa istanza n8n.                                                                   |
| **Description** | Nota facoltativa per identificarla.                                                                       |
| **API Token**   | L'API key dal Passaggio 1.                                                                                |
| **Protocol**    | `https` (predefinito).                                                                                    |
| **URL**         | L'host di n8n (ad esempio `n8n.your-domain.com`).                                                         |
| **Port**        | Porta dell'API (predefinita `443`).                                                                       |
| **Collector**   | [Collector](/it/documentation/agent-endpoint-security/collector-mode) facoltativo per un'istanza privata. |

<Note>
  Il tipo di autenticazione (`api-key`) e il nome dell'header (`X-N8N-API-KEY`) sono preimpostati per questo connettore: devi fornire solo la chiave stessa.
</Note>

## Connessione

Fai clic su **Connect** per convalidare la connessione e completare. n8n comparirà quindi in **Environment → Integrations**. È la tua prima integrazione? Consulta la [panoramica sulle integrazioni](/it/documentation/integrations/overview).