Saltearse al contenido

Configuración de n8n

Conecte n8n a graph8 Studio para automatizar flujos de trabajo con sus campañas, cuentas y datos de inteligencia.

¿Qué es n8n?

n8n es una herramienta de automatización de flujos de trabajo de código abierto. Con la integración MCP, puede:

  • Activar flujos de trabajo cuando se crean o actualizan campañas
  • Sincronizar datos de cuentas con su CRM
  • Crear automatizaciones personalizadas con datos de graph8 Studio

Requisitos previos

  • Instancia de n8n (autohospedada o en la nube)
  • Una cuenta de graph8 Studio
  • Soporte MCP de n8n habilitado (requiere n8n 1.x o superior)

Pasos de configuración

  1. Conéctese en graph8 Studio

    Vaya a Perfil y haga clic en “Connect” en la tarjeta MCP. Complete el flujo de inicio de sesión.

  2. Copie la configuración de n8n

    Una vez conectado, expanda “Setup Instructions” y seleccione la pestaña n8n. Copie la configuración de HTTP Request.

  3. Agregue un nodo HTTP Request en n8n

    En su flujo de trabajo de n8n, agregue un nodo HTTP Request.

  4. Configure la conexión

    Pegue la configuración desde su página de Perfil o utilice este formato:

    https://mcp-production-c2f3.up.railway.app/mcp?session_id=YOUR_SESSION_ID

  5. Pruebe la conexión

    Utilice el botón “Test” en n8n para verificar que la conexión funcione correctamente.

Acciones disponibles

Una vez conectado, puede utilizar estas herramientas MCP en sus flujos de trabajo de n8n:

Campañas

  • list_campaigns — Obtiene todas las campañas con filtro de estado opcional
  • get_campaign — Obtiene los detalles de una campaña específica
  • search_campaigns — Busca campañas por palabra clave

Empresas

  • list_accounts — Obtiene todas las empresas
  • get_account — Obtiene los detalles de una empresa por ID o nombre
  • search_accounts — Busca empresas por industria, nombre, etc.

Oportunidades

  • list_deals — Obtiene las oportunidades del pipeline
  • get_deal — Obtiene los detalles de una oportunidad

Inteligencia

  • get_intelligence — Obtiene la inteligencia de una cuenta
  • search — Busca en todos los datos de graph8 Studio

Ejemplos de flujos de trabajo

Sincronizar nuevas campañas con Slack

  1. Activador: programado (cada hora) o webhook
  2. Nodo MCP: list_campaigns con status=“active”
  3. Nodo de filtro: solo campañas nuevas desde la última ejecución
  4. Nodo Slack: publicar en el canal #marketing

Enriquecer el CRM con inteligencia de empresa

  1. Activador: webhook desde el CRM (nueva oportunidad creada)
  2. Nodo MCP: get_account por nombre de empresa
  3. Nodo MCP: get_intelligence para la empresa
  4. Nodo HTTP: actualizar el registro del CRM con datos de inteligencia

Reporte diario del pipeline

  1. Activador: programado (9 a. m. diariamente)
  2. Nodo MCP: list_deals
  3. Nodo de código: resumir el pipeline por etapa
  4. Nodo de correo: enviar el reporte al equipo comercial

Configuración HTTP manual

Si su versión de n8n no tiene soporte nativo de MCP, utilice el nodo HTTP Request:

{
  "method": "POST",
  "url": "https://mcp-production-c2f3.up.railway.app/mcp",
  "headers": {
    "Content-Type": "application/json"
  },
  "body": {
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "list_campaigns",
      "arguments": {
        "status": "active"
      }
    },
    "id": 1
  },
  "qs": {
    "session_id": "YOUR_SESSION_ID"
  }
}

Solución de problemas

Aquí encontrará los detalles específicos de n8n. Los problemas genéricos de MCP (autenticación, permisos, nombres de herramientas, tiempos de espera) se responden en el FAQ de MCP.

Errores de ejecución de flujos de trabajo

  • Utilice Execute Workflow de n8n en modo paso a paso para identificar qué nodo falla
  • Inspeccione el cuerpo de la respuesta del nodo HTTP Request para ver el error real del servidor
  • En n8n autohospedado, revise los registros del contenedor para detectar errores a nivel de conexión

Otros problemas

  • Autenticación fallida -> FAQ
  • Herramienta no encontrada -> FAQ
  • Límite de tasa (5 rps) -> FAQ
  • Tiempos de espera en herramientas de larga duración -> FAQ

Gestión de sesiones

Las sesiones MCP expiran tras 24 horas de inactividad. Para automatizaciones de larga duración:

  1. Verifique la validez de la sesión al inicio de los flujos de trabajo críticos
  2. Configure alertas para fallos de autenticación
  3. Renueve las sesiones de forma proactiva desde la página de Perfil

Preguntas frecuentes

¿Puedo usar n8n Cloud o necesito una instancia autohospedada?

Ambas opciones funcionan. Las instancias de n8n Cloud y las autohospedadas pueden conectarse a graph8 Studio a través de MCP. El método del nodo HTTP Request funciona de forma universal.

¿Cómo gestiono la expiración de sesiones en flujos de trabajo automatizados?

Guarde su ID de sesión en las credenciales de n8n para facilitar su actualización. Configure el manejo de errores para capturar fallos de autenticación y considere añadir alertas cuando las sesiones expiren.

¿Existen límites de tasa en las llamadas MCP desde n8n?

Sí, graph8 Studio aplica límites de tasa. Añada pausas entre solicitudes en flujos de trabajo de alto volumen. Si alcanza los límites, recibirá una respuesta de error por límite de tasa.

¿Puedo activar flujos de trabajo de n8n desde graph8 Studio?

Utilice webhooks para ello. Configure un webhook saliente en graph8 Studio que llame a la URL de activación del webhook de n8n cuando ocurran eventos (campaña creada, inteligencia completada, etc.).

¿Cómo pruebo las llamadas MCP antes de construir flujos de trabajo completos?

Utilice el nodo HTTP Request de n8n con el botón “Test”. Puede verificar las respuestas antes de conectarlas a otros nodos. Comience con llamadas sencillas como list_campaigns.

Recursos relacionados