Cómo conectar Mindbody a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Mindbody, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Mindbody + Gemini

Mindbody para estudios, gimnasios y centros de bienestar: sedes, programas, clases y horarios, listas de asistentes y de espera, citas y huecos libres, inscripciones, clientes con bonos, membresías, contratos y visitas, ventas, opciones de precio, productos y personal. Reserva clases, citas e inscripciones, gestiona clientes y registra su llegada. Inicia sesión con un usuario del personal; cancelar una clase entera viene desactivado al instalar.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

MINDBODY_API_KEY, MINDBODY_SITE_ID, MINDBODY_USERNAME, MINDBODY_PASSWORD

Paso 1 — Obtener credenciales

La configuración lleva unos 10 minutos. Necesitas una cuenta de desarrollador de Mindbody, el id del sitio del negocio y un usuario del personal de ese sitio.

1. Crea una cuenta de desarrollador en https://developers.mindbodyonline.com y copia la API key de tu source desde la página de credenciales de la API. Hasta que Mindbody apruebe la cuenta para sitios reales, funciona con el sitio sandbox público (id de sitio -99).
2. El propietario del sitio activa tu source para el sitio: obtén el enlace de activación para el id del sitio en el portal de desarrolladores (o con /site/activationcode de la API) y el propietario lo abre con su sesión de Mindbody iniciada.
3. Pega la clave en MINDBODY_API_KEY y el id del sitio en MINDBODY_SITE_ID. El id del sitio es un número que aparece en la URL de Mindbody y en los ajustes del negocio.
4. Introduce el nombre de usuario (a menudo el email) y la contraseña de un miembro del personal de ese sitio en MINDBODY_USERNAME y MINDBODY_PASSWORD. Usa un usuario dedicado con solo los permisos que necesita la IA.
5. Instala el conector y ejecuta mindbody_get_locations para comprobar la conexión.

Cómo funciona el acceso: no hay inicio de sesión en el navegador. El conector envía la clave API y el id del sitio en las cabeceras Api-Key y SiteId, cambia el usuario y la contraseña del personal por un staff user token en /usertoken/issue y lo renueva solo. Cada llamada se hace con los permisos de esa persona, así que lo que el usuario no pueda hacer en Mindbody responde 403.

Qué lee:

• Configuración del sitio: datos del sitio, sedes, programas, session types, recursos (salas, equipos), personal y los session types que ofrece cada uno.
• Clases: clases programadas en un periodo (hoy por defecto), descripciones de clase (los tipos de clase), horarios recurrentes, la lista de asistentes de una clase y las listas de espera.
• Citas: citas reservadas, huecos libres (mindbody_get_bookable_items), días reservables (mindbody_get_available_dates) y elementos de agenda del personal para una vista de calendario.
• Inscripciones: talleres, cursos y series que se reservan completos.
• Clientes: búsqueda por nombre, email o id, el perfil completo, visitas, reservas, opciones de precio compradas con las visitas restantes, membresías activas, contratos (pago automático), compras, saldos de cuenta y registros de contacto.
• Ventas y catálogo: ventas, transacciones con tarjeta y pagos, opciones de precio, contratos, paquetes y productos.

Qué escribe:

• Clases: mindbody_add_client_to_class reserva a un cliente (con waitlist pasa a la lista de espera si la clase está llena), mindbody_remove_client_from_class cancela una reserva (con late_cancel como cancelación tardía, que según las reglas del sitio puede gastar una visita o cobrar una penalización) y mindbody_remove_from_waitlist quita una entrada de la lista de espera.
• Citas: mindbody_add_appointment tras encontrar un hueco libre; mindbody_update_appointment cambia hora, profesional, session type o notas, o confirma, marca la llegada, cancela, cancela tarde o completa la cita.
• Inscripciones: mindbody_add_client_to_enrollment.
• Clientes: la IA consulta mindbody_get_client_duplicates y mindbody_get_required_client_fields antes de mindbody_add_client; mindbody_update_client envía solo los campos que cambian; mindbody_add_arrival registra la llegada de un cliente a una sede; mindbody_add_contact_log anota una llamada, un email o una visita.

Las reservas y cancelaciones afectan a clientes reales, así que la IA te muestra el cliente y la clase o el hueco y espera tu sí. La mayoría de las escrituras aceptan test: true, que valida la petición y devuelve el resultado sin guardar nada.

Desactivadas al instalar: mindbody_cancel_single_class cancela una sesión concreta de una clase para todos los inscritos, opcionalmente con email a clientes y personal, y las reservas no se pueden recuperar mediante la API. Un admin la activa cuando el equipo la necesite.

Formatos de datos: las respuestas envuelven las filas en una lista con nombre (Classes, Clients, Appointments, Sales, ...) junto a PaginationResponse; los nombres de campo van en PascalCase. Los ids de cliente (ClientId) son cadenas que asigna el negocio, a menudo un número en forma de texto; UniqueId es el id numérico de Mindbody. Los ids de clases, citas, personal, sedes y programas son enteros. Fechas y horas van en la zona horaria del sitio, sin desfase (2026-11-20T18:00:00). Los importes van en la moneda del sitio, en unidades enteras. Una clase es una sesión concreta; su ClassDescription es el tipo de clase y su ClassScheduleId el horario recurrente.

Paginación: limit (100 por defecto, como máximo 200) y offset. La IA pide la página siguiente con offset más limit hasta que offset alcanza TotalResults.

Límites: Mindbody cuenta las llamadas a la API por sitio y las cobra por encima de un cupo gratuito (consulta los precios en el portal de desarrolladores). Por eso la IA filtra por fecha, sede o ids en lugar de leerlo todo.

Errores frecuentes: 401 significa una clave API incorrecta, una source no activada para el sitio o un usuario del personal rechazado (DeniedAccess, InvalidSiteId). 403 significa que a esa persona le falta un permiso. 400 es una regla de negocio con el motivo en Error.Message, por ejemplo ninguna opción de precio válida, una clase llena o una hora fuera de la ventana de reserva.

El conector no vende opciones de precio ni productos, no cobra pagos, no crea ni modifica clases, horarios, personal u opciones de precio y no elimina clientes.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Mindbody.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué clases hay mañana en nuestra sede del centro y cuántas plazas quedan libres en cada una?"
• "Reserva a Anna Keller en la clase de Vinyasa Yoga de esta tarde a las 18:00. Comprueba antes que tiene un bono que la cubra."
• "Búscame un hueco libre el sábado por la mañana para un masaje de 60 minutos, con cualquier terapeuta."
• "Muéstrame las visitas de los últimos 3 meses, las membresías activas y el saldo de la clienta [email protected]."
• "¿Cuánto vendimos la semana pasada, desglosado por sede?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot