Conecta n8n a Spoki mediante una clave API. Tu agente de IA de n8n puede acceder a las herramientas de Spoki a través de la herramienta cliente MCP: contactos, listas, etiquetas, automatizaciones, campañas, plantillas, tickets (si están habilitados) y mucho más.
Servidor URL:
https://mcp.spoki.com/v2/mcp
¿Necesitas una clave? Autenticación y URL. ← Empezar a utilizarlo con Spoki MCP
Pasos #
1. Consigue tu API clave
- En Spoki, ve a app.spoki.it → Integraciones → Spoki MCP → Solicitar clave API.
- Copia la clave y manténla en secreto.
2. Iniciar un flujo de trabajo y añadir un agente de IA
- Crea un nuevo flujo de trabajo en n8n o abre uno ya existente.
- Añadir el IA Agente nodo (+ icono, búsqueda «IA Agente» en la sección Nodos de IA).


3. Añadir la MCP Client Tool
- En los parámetros del agente de IA, haz clic en + junto a Herramienta.
- Buscar por y seleccionar MCP Client Tool.

4. Configurar la MCP Client Tool
- Abre los parámetros de la herramienta MCP Client.
- Establece Punto final en
https://mcp.spoki.com/v2/mcp. - Configure Servidor Transporte en HTTP Streamable.
- Establece Autenticación en Encabezado Auth. En Credencial para Encabezado Auth, selecciona Crear Nuevo. Nombre =
X-Spoki-Api-Key, Valor = tu Spoki API clave. Guarda, luego selecciona esa credencial. - En Herramientas que se van a incluir, selecciona Todas o Seleccionadas (por ejemplo, get_contacts, create_list, trigger_automation). La lista muestra las herramientas disponibles en tu cuenta.


5. Prueba
- Ejecuta el flujo de trabajo (o chatea con el agente) y pregunta algo sencillo, por ejemplo: «¿Qué etiquetas tengo en Spoki?»
Ya has terminado cuando… #
- La MCP herramienta para clientes está conectada con encabezado de autenticación y tu Spoki credencial seleccionada.
- El agente puede publicar anuncios o utilizar las herramientas de Spoki (por ejemplo, etiquetas o contactos).
Problemas habituales #
- clave_api_no_válida / error de autenticación: Crea una nueva clave en Spoki Integrations → Spoki MCP y pégala en el campo «Valor de autenticación del encabezado» sin espacios. El nombre del encabezado debe ser exactamente
X-Spoki-Api-Key. - Protocolo o URL incorrectos: Utiliza HTTP Streamable y exactamente
https://mcp.spoki.com/v2/mcp(no utilices hosts de prueba ni rutas anteriores a/mcp). - Vacío herramientas lista: Finaliza el guardado de la credencial, configura Herramientas en Incluir Todas (o selecciona las herramientas), a continuación vuelve a abrir la herramienta MCP Client para que esta actualice el catálogo.
¿Necesitas ayuda? support@spoki.com.
