Zyntia AIDocumentation

La Doble Cara de MCP en Zyntia

Descubre cómo Zyntia aprovecha el Model Context Protocol (MCP) en dos frentes: como Servidor (para gestionar tu cuenta) y como Cliente (para darle herramientas a tus bots).

El Ecosistema MCP en Zyntia

El Model Context Protocol (MCP) es un estándar abierto desarrollado por Anthropic para conectar de forma segura modelos de lenguaje con herramientas y datos externos.

En Zyntia, hemos implementado MCP de forma bidireccional. Es vital entender la diferencia entre estas dos capacidades, ya que sirven propósitos completamente distintos:

  1. Zyntia como Servidor MCP (Para ti, el desarrollador/operador).
  2. Los Bots de Zyntia como Clientes MCP (Para dotar a tus agentes de "Skills").

A continuación explicamos detalladamente cada uno.


1. Zyntia como Servidor MCP (Control y Gestión)

Propósito: Permitir que agentes de IA externos (como Claude Desktop, Cursor, o tu propio script) se conecten a tu cuenta de Zyntia para construir y administrar flujos de trabajo (workflows) usando lenguaje natural.

En lugar de usar la interfaz gráfica (arrastrar y soltar nodos), le hablas a tu IA de escritorio y ella configura Zyntia por ti.

¿Cómo configurarlo?

Tu cliente MCP externo (ej. Claude Desktop) necesita conectarse al servidor nativo de Zyntia usando SSE (Server-Sent Events).

  • URL del Servidor: https://api.tudominio.com/api/mcp/v1/mcp/sse (reemplaza con la URL base de tu instalación)
  • Autenticación: Requiere un Token MCP (generado en el Dashboard de Zyntia).

Ejemplo en claude_desktop_config.json:

{
  "mcpServers": {
    "zyntia-admin": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/inspector"],
      "url": "https://api.zyntia.com/api/mcp/v1/mcp/sse",
      "headers": {
        "Authorization": "Bearer sk_mcp_tu_token_secreto_aqui"
      }
    }
  }
}

¿Qué puedes pedirle a tu IA externa?

Una vez conectada, puedes decirle:

  • "Muéstrame todos los flujos de mi bot."
  • "Crea un nuevo workflow llamado 'Onboarding' que empiece pidiendo el email, evalúe si el dominio es válido, y termine enviando un webhook."

⚠️ Restricción de Seguridad: El Servidor MCP de Zyntia está diseñado exclusivamente para administración. Por seguridad, está bloqueado a nivel de sistema que un Bot de Zyntia se conecte a este servidor. Un bot no debe tener la capacidad de auto-modificar la estructura de su propia cuenta.


2. Tus Bots como Clientes MCP (Tools & Skills)

Propósito: Darle "superpoderes" o Skills a los bots que creas en Zyntia, para que durante una conversación con un usuario final, el bot pueda consultar bases de datos, APIs de terceros o buscar en internet.

En este escenario, tu Bot de Zyntia es el Cliente que se conecta a Servidores MCP externos (creados por ti o por la comunidad).

¿Cómo darle herramientas a tu Bot?

  1. Ve al Dashboard de Zyntia > Selecciona tu Bot > Pestaña Herramientas (Tools).
  2. Aquí puedes añadir las conexiones a servidores MCP externos que desees que tu bot utilice.
  3. El motor de IA de Zyntia evaluará en tiempo real el contexto de la conversación del usuario y decidirá cuándo usar estas herramientas.

Casos de Uso Comunes (Skills)

  • Servidor MCP de Base de Datos Local: Conectas un servidor MCP que apunta a tu base PostgreSQL. Tu bot ahora responde preguntas precisas cruzando datos con tu inventario real.
  • Servidor MCP de HubSpot / CRM: El bot, en medio de una charla de ventas, invoca herramientas y marca a un lead como "Calificado" directamente en tu CRM.
  • Búsqueda Web en Vivo: El bot consulta las últimas noticias navegando por internet antes de dar una respuesta.

Diferencias Clave Resumidas

Característica1. Zyntia como Servidor MCP2. Bots como Clientes MCP
Quién lo usaTú (a través de Claude Desktop, Cursor, etc).El Bot (durante una sesión de chat con un usuario final).
ObjetivoOperaciones de backend (Crear flujos, editar nodos, gestionar datos).Acciones de usuario final (Buscar vuelos, agendar citas, consultar inventario).
Punto de ConexiónEl cliente externo se conecta a https://api.zyntia.com/api/mcp/v1/mcp/sse.Zyntia se conecta a URLs externas (ej. el servidor MCP de tu empresa).