Collega n8n a Spoki con un’API key. Il nodo AI Agent di n8n può usare i tool Spoki tramite MCP Client Tool: contatti, liste, tag, automazioni, campagne, template, ticket (se abilitati) e altro.
URL del server:
https://mcp.spoki.com/v2/mcp
Ti serve una chiave? Autenticazione e URL. ← Inizia con Spoki MCP
Passaggi #
1. Ottieni la tua API key
- In Spoki, vai su app.spoki.it → Integrazioni → Spoki MCP → Request Api Key.
- Copia la chiave e tienila privata.
2. Avvia un workflow e aggiungi un AI Agent
- Crea un nuovo workflow in n8n, oppure aprine uno esistente.
- Aggiungi il nodo AI Agent (icona +, cerca “AI Agent” sotto AI Nodes).
3. Aggiungi MCP Client Tool
- Nei parametri dell’AI Agent, clicca + accanto a Tool.
- Cerca e seleziona MCP Client Tool.
4. Configura MCP Client Tool
- Apri i parametri di MCP Client Tool.
- Imposta Endpoint su
https://mcp.spoki.com/v2/mcp. - Imposta Server Transport su HTTP Streamable.
- Imposta Authentication su Header Auth. In Credential for Header Auth scegli Create New. Name =
X-Spoki-Api-Key, Value = la tua API key Spoki. Salva, poi seleziona quella credential. - In Tools to Include scegli All o Selected (ad esempio get_contacts, create_list, trigger_automation). L’elenco riflette i tool disponibili sul tuo account.
5. Test
- Esegui il workflow (o chatta con l’agent) e chiedi qualcosa di semplice, ad esempio: “Che tag ho in Spoki?”
Hai finito quando… #
- MCP Client Tool è collegato con Header Auth e la credential Spoki selezionata.
- L’agent può elencare o usare i tool Spoki (ad esempio tag o contatti).
Problemi comuni #
- invalid_api_key / auth fallisce: Crea una nuova chiave in Spoki Integrazioni → Spoki MCP e incollala nel Value di Header Auth senza spazi. Il Name dell’header deve essere esattamente
X-Spoki-Api-Key. - Transport o URL sbagliati: Usa HTTP Streamable e esattamente
https://mcp.spoki.com/v2/mcp(non host di staging né i vecchi path/mcp). - Elenco tool vuoto: Salva la credential, imposta Tools to Include su All (o seleziona i tool), poi riapri MCP Client Tool così aggiorna il catalogo.
Serve aiuto? support@spoki.com.
