MoveMentors expone un servidor Model Context Protocol (MCP). Si usas Claude, ChatGPT (con integraciones de Claude API), Cursor o cualquier otro asistente IA compatible con MCP, puedes conectarlo a tu cuenta para preguntar cosas como:
- "¿Cuáles son mis reservas la próxima semana?"
- "Cancela mi clase del sábado y envía email a todos los reservados."
- "Agrega una clase de yoga el martes por la mañana al mismo precio que la del jueves."
- "Envía nota de agradecimiento a los clientes que asistieron en los últimos 30 días."
El servidor MCP está disponible en cuentas Pro y Premium.
Qué es MCP
Model Context Protocol es un estándar abierto que permite a asistentes IA hablar con herramientas externas. Originalmente construido por Anthropic (gente de Claude); ahora adoptado por ChatGPT, Cursor y otros.
Para MoveMentors, MCP significa que tu asistente IA puede:
- Ver tus reservas, clases, clientes (lectura).
- Crear reservas, modificar clases, enviar mensajes (escritura).
- Todo gateado por permisos OAuth que tú otorgas.
Cómo funciona
- Vas a los ajustes de tu asistente IA (Claude Desktop, ChatGPT, etc) y agregas MoveMentors como servidor MCP.
- El asistente abre un flow OAuth en tu browser.
- Te logueas en MoveMentors y otorgas permisos específicos (read bookings, write classes, etc).
- El asistente recibe un token que incluye en cada request.
- Ya puedes pedirle al asistente cosas sobre tu cuenta.
Sin API keys, sin credenciales en texto plano. OAuth maneja la auth.
Conectar Claude Desktop
Abre Claude Desktop
La app de escritorio.
Ve a Settings → Developer
Busca la sección "MCP servers".
Agrega un servidor MCP
Click "Add server" y elige "Connect via OAuth".
Ingresa la URL MCP
https://movementors.com/api/mcpAutoriza
Claude abre browser. Logueas en MoveMentors y ves pantalla de consent con los permisos solicitados.
Elige qué permisos otorgar
Puedes negar scopes específicos si quieres limitar. Por ejemplo, otorgar "read bookings" pero negar "write classes" si quieres que solo consulte.
Click 'Approve'
Vuelves a Claude. El servidor conectado.
Empieza a usar
Habla con Claude normal. Ahora tiene herramientas para tu cuenta MoveMentors.
Conectar ChatGPT
ChatGPT soporta MCP vía Anthropic API con Claude como modelo. La UI es diferente pero el OAuth flow es el mismo.
Si tu asistente soporta MCP, tendrá opción análoga "Add MCP server". La URL siempre es https://movementors.com/api/mcp.
Herramientas disponibles
El servidor MCP expone unas 20 herramientas. Algunas:
whoami: quién es el usuario actual.search_mentors,search_studios,search_classes: query del directorio público.get_mentor: perfil completo de un mentor.list_my_bookings: tus reservas (como estudiante o anfitrión).book_class: crear reserva.cancel_booking: cancelar reserva.list_my_classes: tus clases.update_class,delete_class: modificar clases.add_class_schedule: agregar sesión a clase existente.list_class_bookings: quién reservó una sesión.financials_summary: resumen de ingresos.list_expenses,create_expense,update_expense,delete_expense: gastos.send_mentor_inquiry: enviar mensaje directo.list_received_mentor_inquiries: mensajes entrantes.
El asistente elige la herramienta. No necesitas saber nombres.
Permisos y scopes
Permisos granulares. Otorgas o niegas cada scope individualmente. Ver scopes OAuth para la lista completa.
Bundles comunes:
- Read-only: ver todo, cambiar nada. Útil para testear.
- Bookings management: ver y modificar reservas, pero no clases.
- Full control: todo.
Puedes revocar en cualquier momento en /settings/connected-apps.
Casos de uso
"Muéstrame mi próxima semana"
Usa list_my_bookings y list_my_classes para una semana de eventos por día. Sigues con "¿cuáles están pendientes de pago?".
"Cancela el sábado y reembolsa a todos"
Usa list_class_bookings para las reservas afectadas, luego cancel_booking en cada una. Reembolsos Stripe procesan auto.
"Agrega una clase similar a la del martes pero el jueves"
Usa get_class para detalles, luego create_class con los mismos campos pero diferente agenda.
"¿Cuál fue mi mejor mes en ingresos?"
Usa financials_summary para totales mes por mes y reporta.
"Envía agradecimiento a todos los que asistieron el fin de semana pasado"
Usa list_my_bookings filtrado a último fin de semana con estado COMPLETED, luego send_mentor_inquiry o similar para notas personalizadas.
Seguridad
A saber:
Los scopes OAuth son el límite
El asistente no puede hacer nada fuera de los scopes otorgados. Si solo diste read, los writes devuelven permission errors.
Cada request es loggeado
Loggeamos cada request MCP: qué herramienta, qué argumentos, resultado. Visible en /settings/audit-log. Útil para saber qué hizo el asistente.
Los tokens se pueden revocar
/settings/connected-apps muestra cada cliente OAuth conectado. Revoca cuando quieras; el asistente pierde acceso inmediato.
Rate limits
Rate-limit por token. Un asistente conversacional normal se queda muy debajo. Uno tratando de traer todo tu historial de reservas de golpe puede tocar límites; reintenta con backoff.
Sandboxing
La mayoría de clientes MCP (Claude Desktop, etc) corren como procesos separados. No leen tus otros archivos ni secuestran tu browser. La conexión es HTTPS con token auth.
Límites
Algunas herramientas son gateadas:
book_class: requiere tier Pro. Free expone solo read.update_class,delete_class,add_class_schedule: Pro.financials_summaryy herramientas de gastos: Pro.
Si estás en free e intentas usar una herramienta gateada, recibes error claro del asistente.
Preguntas frecuentes
¿El asistente comparte mi data con otros? El asistente corre local (Claude Desktop) o en el entorno de tu provider (Claude.ai web). La data que lee de MoveMentors queda en tu conversación; no se comparte con otros users.
La privacy policy de Anthropic aplica a lo que hagan con tu data de conversación. Eso no lo controlamos.
¿El asistente ve mi password? No. OAuth significa que el asistente nunca ve tu password. Tiene un token revocable.
¿El asistente puede hacer cosas a mis espaldas? El asistente solo actúa cuando le dices (en conversación). No corre en background salvo que configures automatización. Cada acción loggeada.
¿Y si el asistente comete un error? Puedes revisar el audit log y deshacer la mayoría:
- Reservas canceladas pueden re-reservarse (si quedan asientos).
- Clases borradas pueden re-crearse (el asistente tiene la data).
- Mensajes enviados no se desenvían.
Trátalo como un empleado junior con acceso. Confía pero verifica.
¿MCP soportará más con el tiempo? Sí. Agregamos herramientas conforme MCP evoluciona. Suscríbete al newsletter o revisa el changelog.
Próximos pasos
- Scopes OAuth: el modelo de permisos.
- Pruébalo: conecta Claude Desktop y pregunta "muéstrame mi próxima semana".