Saltar al contenido principal

Servidor MCP de CalendarPA

CalendarPA tiene un servidor MCP, para que un asistente de IA como Claude o ChatGPT pueda trabajar con tu cuenta de CalendarPA. Una vez conectado, el asistente puede ver tus tipos de reserva y tus reservas, encontrar horarios libres y reservar, reprogramar o cancelar reuniones por ti. Inicia sesión con tu cuenta de CalendarPA, así que no hay ninguna clave de API que copiar. Todos los planes pueden conectarse, incluido el plan gratuito.

URL del servidor

https://calendarpa.com/api/mcp

Pega esta dirección tal como aparece, incluido /api/mcp.

Conectar desde Claude

  1. En Claude, abre Customize y luego Connectors.
  2. Haz clic en + Add y luego en Add custom connector.
  3. Ponle el nombre CalendarPA, pega la URL del servidor y haz clic en Continue.
  4. Haz clic en Continue para pasar los ajustes de inicio de sesión que detecta Claude.
  5. En OAuth client, elige Register automatically y luego haz clic en Add.
  6. Inicia sesión en CalendarPA cuando se te pida y aprueba los permisos.
  7. En un chat, haz clic en +, luego en Connectors, y activa CalendarPA.

En un plan Team o Enterprise de Claude, un propietario añade el conector en Organization settings y luego Connectors, y después cada miembro lo conecta desde Customize y luego Connectors.

Estos pasos siguen el artículo de ayuda de Claude sobre conectores personalizados. Claude puede cambiar el nombre de sus menús.

Conectar desde ChatGPT

  1. En ChatGPT, abre Plugins.
  2. Selecciona el botón de más y luego Add custom MCP server.
  3. Ponle el nombre CalendarPA y, en Connection, pega la URL del servidor.
  4. Elige OAuth como autenticación, revisa el aviso y selecciona I understand and want to continue.
  5. Selecciona Create as a plugin, luego inicia sesión en CalendarPA y aprueba los permisos.
  6. En un chat nuevo, escribe @ y elige CalendarPA.

Si tu cuenta de ChatGPT puede añadir un servidor MCP personalizado lo deciden las políticas de cuenta y de espacio de trabajo de ChatGPT.

Estos pasos siguen la guía de OpenAI para conectar un servidor MCP. ChatGPT puede cambiar el nombre de sus menús.

Los tres permisos

Al iniciar sesión, CalendarPA te pide que apruebes tres permisos. Cada uno cubre solo las herramientas que aparecen a su lado.

  • Ver tus tipos de reserva: listar tus tipos de reserva y encontrar sus horarios libres.
  • Ver tus reservas y sus detalles: listar tus reservas y leer una reserva.
  • Crear y cancelar reservas en tu nombre: reservar, reprogramar y cancelar.

Ningún permiso que se da a un asistente le permite reembolsar un pago.

Qué puede hacer el asistente

HerramientaQué haceTipo
whoamiLa cuenta a la que está conectado: nombre, correo, nombre de usuario, plan y zona horaria.Lectura
list_booking_typesTus tipos de reserva activos, con título, duración, opciones de ubicación y precio.Lectura
find_available_timesHorarios libres de un tipo de reserva, tal como los ofrece tu página de reservas. Hasta 60 días por llamada.Lectura
list_bookingsLas reservas que organizas, más las reservas round robin que se te asignan. Puede filtrar por estado, fecha de creación o correo del invitado.Lectura
get_bookingLa hora, el estado, el invitado, la ubicación y el enlace de reunión de una reserva.Lectura
create_bookingReserva un horario que ofreció find_available_times. El invitado recibe la confirmación habitual y la reunión entra en tu calendario.Escritura
reschedule_bookingMueve a otra hora una reserva que organizas.Escritura
cancel_bookingCancela una reserva que organizas y avisa al invitado. Si la reserva se pagó con tarjeta, el pago se conserva; los créditos usados para pagar se devuelven.Escritura, destructiva

Lo que no puede hacer

  • Reservar un tipo de reserva de pago.
  • Mover o cancelar una plaza en una sesión de grupo.
  • Listar las reservas que coorganizas.
  • Reembolsar un pago.

Planes

El servidor MCP funciona en todos los planes, incluido el plan gratuito. Si una acción usa una función que tu plan no incluye, como las reservas recurrentes, se le dice al asistente qué plan la tiene.

Límites

  • Hasta 300 llamadas a herramientas por minuto por conexión, dentro de 1,000 por minuto por cuenta.
  • Buscar horarios libres lee tus calendarios en directo, así que está limitado a 30 llamadas por minuto por cuenta.
  • Si se pasa de un límite, se le dice al asistente cuántos segundos esperar antes de volver a intentarlo.
  • Un resultado de más de 100 KB se rechaza en lugar de recortarse, así que el asistente acota su petición.
  • El acceso dura 1 hora cada vez y se puede renovar durante hasta 90 días sin uso. Si la conexión deja de funcionar, vuelve a conectarla.

Desconectar

En CalendarPA, ve a Ajustes y luego Integraciones, busca la app en Aplicaciones conectadas y haz clic en Desconectar. El acceso se corta al instante: la siguiente petición del asistente se rechaza.

Privacidad

El asistente solo puede llegar a tu propia cuenta, y solo a lo que permiten los permisos que aprobaste. Lo que Claude o ChatGPT hagan con lo que leen se rige por sus propias condiciones de privacidad; las nuestras están en la Política de privacidad.

Para desarrolladores

El servidor habla MCP sobre Streamable HTTP e inicia sesión con OAuth, con PKCE y registro dinámico de clientes. Sus metadatos de recurso protegido están en /.well-known/oauth-protected-resource/api/mcp. La API REST está documentada en la documentación de la API.