Datos y eventos

Agentes de IA (MCP)

YAVE expone un servidor Model Context Protocol para que un asistente de IA consulte y opere el CRM en lenguaje natural: "hazme el reporte ejecutivo del mes", "¿qué leads de la Torre 2 no se han contactado?", "agenda una visita con Laura el jueves". El agente trabaja con los permisos del usuario que lo conecta, ni más ni menos.

Servidor#

POSThttps://api.yavehome.com/mcpOAuth 2.1 o Bearer

Propiedad	Valor
Transporte	Streamable HTTP (sin estado)
Autenticación	OAuth 2.1 con registro dinámico de clientes, o token personal Bearer
Alcance	Las organizaciones y el rol del usuario que conecta

Conectar un asistente#

La forma recomendada es OAuth: pegas la URL, el asistente abre YAVE para que inicies sesión y apruebes la conexión, y no hay tokens que guardar. Las instrucciones paso a paso para cada asistente están en el CRM, en Configuración → Conectar IA.

Claude (web y escritorio)

En Claude, abre la configuración de Conectores y agrega un conector personalizado.
Pega https://api.yavehome.com/mcp y confirma. Claude te lleva a YAVE para aprobar el acceso.

ChatGPT

En Ajustes → Conectores → Ajustes avanzados, activa el Modo desarrollador (planes Plus o Pro).
En Conectores → Crear, pega la URL y elige OAuth como autenticación.

Clientes con archivo de configuración

mcp.json

{
  "mcpServers": {
    "yave": {
      "type": "http",
      "url": "https://api.yavehome.com/mcp"
    }
  }
}

Autenticación#

OAuth 2.1

El servidor publica sus metadatos en las rutas estándar, así que un cliente MCP compatible descubre todo solo:

https://api.yavehome.com/.well-known/oauth-protected-resource
https://api.yavehome.com/.well-known/oauth-authorization-server

Soporta registro dinámico de clientes (/oauth/register), autorización con PKCE S256 (/oauth/authorize), y los grants authorization_code y refresh_token (/oauth/token).

Token personal

Para clientes sin OAuth (scripts, algunos editores), un usuario genera un token en Configuración → Conectar IA → Tokens MCP (avanzado). Empieza por yave_mcp_, se muestra una sola vez, vence (90 días por defecto) y se puede revocar desde la misma pantalla.

Encabezado

Authorization: Bearer yave_mcp_…

Permisos#

Scope	Qué permite
`mcp`	Conectarse y leer (lo que pide el flujo OAuth por defecto).
`informes`	Leer reportes y datos del CRM.
`acciones`	Ejecutar acciones: mover leads de etapa, agendar citas, enviar mensajes, registrar pagos.

El scope es una propiedad de la conexión, no del usuario: un gerente puede conectar un asistente de solo lectura. Además, el agente nunca supera el rol del usuario: ve y hace solo lo que ese usuario puede ver y hacer en el CRM.

Las acciones se confirman

Las herramientas que escriben funcionan en dos pasos: el agente propone la acción y solo la ejecuta cuando el usuario la confirma en el chat. Todo queda registrado a nombre del usuario.

Qué puede hacer el agente#

El servidor ofrece cientos de herramientas, la mayoría de solo lectura, agrupadas por módulo:

Módulo	Ejemplos
Dashboard e informes	KPIs, embudo, origen de leads, atribución, desempeño del equipo, tiempos de respuesta
Leads	Buscar, ver ficha e historial, leads sin atender, mover de etapa, asignar
Conversaciones	Leer chats de WhatsApp, Instagram y Messenger; enviar mensajes
Citas	Agenda del equipo, disponibilidad, agendar y reprogramar visitas
Catálogo	Proyectos, unidades, disponibilidad y precios
Marketing	Campañas de Meta, Google y TikTok; tráfico del sitio (GA4)
Cartera	Acuerdos de pago, cuotas vencidas, recaudo, estados de cuenta
IA y voz	Métricas del agente de IA, preguntas sin respuesta, llamadas del agente de voz

También incluye comandos listos (prompts), como el reporte semanal, y recursos con el perfil del usuario y de la organización.

Buenas prácticas#

Empieza con una conexión de solo lectura y habilita acciones cuando el equipo esté cómodo.
Un token por dispositivo o script, con nombre claro, para poder revocarlo sin afectar a los demás.
Si el asistente no ve una herramienta nueva, desconecta y vuelve a conectar: los clientes guardan la lista de herramientas de la primera conexión.

AnteriorCatálogo público Siguiente Errores y límites