Cómo conectar Boleani con Claude o ChatGPT (MCP)

MCP (Model Context Protocol) permite que tu asistente de IA se conecte a Boleani y trabaje con tu negocio real: consultar el resumen del día, ver pedidos y citas, o incluso crear un pedido, agendar una cita o radicar un ticket, todo en lenguaje natural. Así lo conectas en minutos.

1. 1

   Copia la URL de tu servidor MCP

   En el panel de Boleani entra a "Ajustes del negocio" y abre la tarjeta "Conexión MCP". Despliega "Servidor MCP" y copia la URL. Es la misma para todos los clientes de IA.

   https://www.boleani.com/api/v1/mcp

   Con OAuth NO necesitas pegar ninguna clave: el cliente te pedirá permiso y tú autorizas tu negocio desde Boleani.

2. 2

   Agrégalo como conector en tu IA

   En Claude.ai: Configuración → Conectores → "Agregar conector personalizado" y pega la URL. En ChatGPT (con conectores) o Cursor: agrega un servidor MCP remoto con esa misma URL. El cliente descubre solo el método de autenticación.

   Cliente	Ruta
   Claude.ai	Configuración → Conectores → Agregar conector personalizado
   ChatGPT	Configuración → Conectores → Agregar servidor MCP
   Cursor	Settings → MCP → Add remote server

3. 3

   Autoriza el acceso (OAuth)

   Se abrirá la pantalla de Boleani "Autorizar acceso". Inicia sesión si hace falta, elige el negocio que quieres autorizar y pulsa "Autorizar". Listo: el cliente queda conectado sin que pegues ninguna clave.

   La app solo podrá acceder al negocio que elijas. Nunca ve tu contraseña ni otros negocios. Puedes revocar el acceso cuando quieras.

4. 4

   Alternativa: conectar con API key (clientes sin OAuth)

   Si tu cliente no soporta OAuth, usa tu API key (en la misma tarjeta "Conexión MCP"). Lo ideal es ponerla como header "Authorization: Bearer"; y como último recurso, la URL con la clave incluida.

   Header (recomendado):
   Authorization: Bearer bol_live_tu_clave
   
   URL con clave (método simple):
   https://www.boleani.com/api/v1/mcp?key=bol_live_tu_clave

   Cualquiera con tu API key o con la URL-con-clave puede acceder a tus datos. Mantenla privada; puedes regenerarla desde la misma pantalla si se filtra.

5. 5

   Úsalo: pregúntale a tu IA sobre tu negocio

   Ya conectado, tu asistente puede consultar y actuar sobre Boleani con lenguaje natural. Estas son las herramientas disponibles.

   Herramienta	Qué hace	Tipo
   get_summary	Resumen del día: pedidos, ventas, citas y tickets	Lectura
   get_catalog	Catálogo de productos o servicios	Lectura
   list_orders	Pedidos recientes (filtrable por estado)	Lectura
   list_appointments	Próximas citas	Lectura
   list_tickets	Tickets / PQR	Lectura
   create_order	Crea un pedido	Escritura
   book_appointment	Agenda una cita (valida disponibilidad)	Escritura
   create_ticket	Radica una solicitud/PQR	Escritura

   Ejemplos: "resumen de hoy en Boleani", "¿qué citas próximas tengo?", "crea un pedido de 2 hamburguesas para Juan al 3001234567".