Arquitectura técnica

Un CRM que también habla el protocolo de tu IA.

ZAPLIA no es un chatbot con un prompt largo. Es un harness de agentes con herramientas tipadas, aprobación humana persistida y un servidor MCP real — para que conectes tu propia IA a tus datos, no solo la nuestra.

En español simple

Además de la IA que atiende tus canales conectados, ZAPLIA te deja conectar tu propia herramienta de inteligencia artificial — como Claude — directo a los datos de tu negocio: tus contactos, tu catálogo, tus citas. Así puedes pedirle a tu IA que consulte o actualice cosas por ti, a tu manera, sin pasar por soporte. Si esto no te dice nada, tranquilo: el resto de ZAPLIA funciona igual de bien sin tocar nada de esto. Esta página es para quien programa o ya usa herramientas de IA.

MCP de cliente

Conecta Claude, Cursor o cualquier cliente MCP a tu cuenta.

MCP (Model Context Protocol) es el estándar abierto para que un cliente de IA use herramientas de un servidor externo. ZAPLIA expone uno real, en producción, sobre transporte HTTP estándar — compatible con Claude Desktop, Claude Code, Cursor o cualquier cliente MCP genérico.

  1. 1

    Genera tu API key

    En Configuración → API, crea un key con el scope mcp (o *).

  2. 2

    Conecta tu cliente

    Apunta tu cliente MCP a la URL del servidor con tu key como Bearer token.

  3. 3

    Lee y escribe en tu cuenta

    Tu IA ya puede consultar y operar contactos, productos, citas y más — con los mismos datos que ves en tu dashboard.

Datos de conexión
URL https://zaplia.app/api/mcp
Header Authorization: Bearer zpk_live_<tu_key>

Cada cliente MCP (Claude Desktop, Claude Code, Cursor…) tiene su propia forma de agregar un servidor remoto — usa esta URL y este header donde te pida la conexión.

Prueba rápida con curl

curl -X POST https://zaplia.app/api/mcp \
  -H "Authorization: Bearer zpk_live_<tu_key>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tu key MCP da acceso completo de propietario a tu cuenta (lectura y escritura) — no hay permisos granulares por miembro del equipo todavía dentro del MCP. Guárdalo con el mismo cuidado que una contraseña.

21 herramientas, un solo motor

Las mismas herramientas que usa el runtime comercial de ZAPLIA.

Nada de lógica de negocio duplicada: cada tool del MCP llama al mismo motor de ejecución que conecta la IA con tus datos y canales soportados.

Lectura

  • get_contact_context

    Historial, notas y estado comercial completo de un contacto

  • get_contact_by_id

    Consulta un contacto por su ID

  • get_contact_by_channel

    Busca un contacto por su canal (WhatsApp, email, etc.)

  • get_recent_messages

    Últimos mensajes de una conversación

  • get_knowledge_answer

    Responde con RAG semántico sobre tu Business Brain

  • get_business_context

    Perfil, catálogo y políticas de tu negocio

  • list_metrics

    Métricas de ventas y actividad de tu cuenta

  • get_open_tickets

    Tickets de soporte abiertos

  • check_agenda_availability

    Disponibilidad de horarios en tu agenda

Escritura

  • create_contact

    Registra un nuevo contacto

  • update_contact

    Actualiza los datos de un contacto

  • create_product

    Da de alta un producto o servicio en tu catálogo

  • set_contact_communication

    Pausa o bloquea la comunicación con un contacto

  • add_contact_with_welcome

    Registra un contacto y dispara su mensaje de bienvenida

  • create_follow_up

    Programa un recordatorio de seguimiento

  • create_ticket

    Abre un ticket de soporte

  • update_ticket_status

    Actualiza el estado de un ticket

  • create_order

    Genera una orden de venta

  • create_appointment

    Agenda una cita con tu cliente

  • book_agenda_slot

    Reserva un horario específico de tu agenda

  • send_whatsapp_message

    Envía un mensaje de WhatsApp a un contacto

Por qué es un harness, no un prompt con esteroides

Cuatro decisiones de arquitectura que sostienen esa frase.

Planificación como DAG

Cada tarea se compila en un grafo de dependencias con hash inmutable del plan. Nada se ejecuta a ciegas, y una aprobación no se reutiliza si el plan cambió después de emitirla.

Aprobación humana persistida

Las acciones autónomas del agente pasan por una máquina de estados real (pendiente → aprobada / rechazada / expirada), no un "confía en mí". Expira sola a las 24 horas si nadie decide.

Reglas deterministas de seguridad

Si un borrador de respuesta menciona un precio, un porcentaje o una cotización, siempre va a revisión humana — sin importar qué tan segura esté la IA. La red de seguridad no depende de que el modelo se porte bien.

RAG vectorial real

Tus hechos verificados (Business Brain) se indexan con embeddings semánticos, no solo texto plano — la IA busca por significado, no por coincidencia exacta de palabras.

Límites, sin letra chica

Lo que sí y lo que todavía no.

  • Tu API key MCP da acceso de propietario completo a tu cuenta — no hay permisos granulares por miembro del equipo dentro del MCP todavía.

  • Las acciones que ejecutas tú mismo vía MCP no pasan por el flujo de aprobación humana — ese flujo protege lo que el agente autónomo decide por su cuenta. Si tú llamas la herramienta desde tu propio cliente, ya te estás autorizando.

  • Cada cuenta está aislada a nivel de base de datos (Row-Level Security por tenant) — tu key nunca puede ver datos de otra cuenta, sin importar qué le pidas.

Genera tu key y conecta tu IA en minutos.

El plan gratis ya incluye acceso al MCP de cliente.