Ir al contenido
EntrarQuiero ser parte

API de OLA Vital Center

Lo que un asistente puede consultar y hacer en OLA, siempre con el permiso de la persona.

Documentación

Servidores MCP

Transporte Streamable HTTP, JSON-RPC 2.0.

  • Público, sin credenciales: https://app.olavital.com/api/mcp/publico. Herramientas: ola_sucursales, ola_iniciar_alta.
  • Clientas, con OAuth: https://app.olavital.com/api/mcp. La clienta autoriza en la app. Herramientas: ola_opciones_reserva, ola_horarios_disponibles, ola_reservar_cita, ola_cancelar_cita, ola_mi_membresia, ola_mi_perfil, ola_pagar.
  • Dueñas, con OAuth y segundo factor: https://app.olavital.com/api/mcp/admin. Solo para quien administra el salón.

Credenciales

OAuth 2.1 con PKCE (S256) y registro dinámico de cliente: el agente se registra solo, sin llaves ni formularios. La persona entra a la app de OLA, ve qué pide el agente y lo aprueba. Puede desconectarlo cuando quiera desde Mi cuenta › Asistentes de IA. Ningún agente ve ni guarda datos de tarjeta.

Metadatos del servidor de autorización: https://app.olavital.com/.well-known/oauth-authorization-server.

Alcances

Pide solo los que necesitas. Los marcados «aparte» nunca se dan por omisión.

AlcanceParaQué permite
ola.membresiaClientasLeer la membresía de la clienta, los servicios que le quedan en el mes, su perfil mínimo y sus referidas.
ola.citasClientasVer servicios, estilistas y horarios libres; reservar y cancelar citas de la clienta.
ola.pagos · aparteClientasPagar un adeudo con la tarjeta que la clienta ya guardó. Nunca va por omisión: hay que pedirlo aparte y ella confirma cada pago.
ola.adminDueñasSolo dueñas: leer el panel del salón (agenda, ventas, membresías) sin datos de salud ni fiscales, y dejar borradores de promociones.
ola.admin.acciones · aparteDueñasSolo dueñas: acciones de alto riesgo (mover agenda, cobrar, dar de baja, publicar). Cada acción muestra una vista previa y pide confirmar.

Pruebas (sandbox)

Para probar sin tocar datos reales, usa staging: https://ola-vital-staging.web.app. Es la misma API con datos ficticios. No cobra ni manda mensajes.

  • Servidor MCP público: https://ola-vital-staging.web.app/api/mcp/publico.
  • API pública: las mismas rutas de OpenAPI, con esa dirección.
  • Metadatos OAuth: https://ola-vital-staging.web.app/.well-known/oauth-authorization-server. El registro de cliente funciona. Para autorizar hace falta una cuenta de prueba de staging, que no se crea desde el sitio.

Puede reiniciarse sin aviso y tiene un límite de uso. No guardes ahí nada que necesites.