📅 Configuración Servidor MCP - Calendly

No. Las herramientas MCP Calendly disponibles permiten solo LEER datos (disponibilidad, eventos, invitados) y CANCELAR eventos. La reserva propiamente dicha debe ocurrir mediante el enlace público Calendly u otros sistemas. El asistente puede verificar disponibilidad y proporcionar el enlace correcto al cliente.

Accede a tu cuenta Calendly, ve a Configuración > Integraciones > API & Webhooks. Genera un nuevo Personal Access Token y cópialo. Este token se ingresa en el campo "Token de Autenticación" en la configuración AI4CALL. El token siempre empieza con "eyJ".

El asistente puede: verificar disponibilidad de horarios (calendly_get_available_times), consultar eventos programados (calendly_get_scheduled_events), leer detalles de invitados (calendly_get_event_invitees y calendly_get_invitee), recuperar tipos de evento disponibles (calendly_get_event_types), y cancelar eventos (calendly_cancel_event). No puede crear nuevas citas.

calendly_get_event_invitees devuelve TODOS los invitados de un evento específico (lista completa). calendly_get_invitee devuelve los detalles de UN SOLO invitado específico mediante su UUID. Usa el primero para ver quién participa en un evento, el segundo para recuperar datos detallados de una persona específica.

Sí, la operación es IRREVERSIBLE. Una vez cancelado el evento mediante el servidor MCP, no puede ser restaurado. Por esto es fundamental instruir al asistente a pedir SIEMPRE confirmación explícita al cliente antes de ejecutar la cancelación.

Primero debe invocar calendly_get_event_types para recuperar todos los tipos de evento configurados en tu Calendly (ej. "Consulta 30min", "Videollamada 1h"). Luego usa el UUID del tipo de evento correcto para llamar a calendly_get_available_times. En el prompt puedes especificar nombres exactos o dejar que el asistente identifique el tipo correcto a partir de la solicitud.

No a nivel de herramienta MCP - si activas calendly_cancel_event, funciona en todos los eventos. La limitación debe gestionarse a nivel de prompt: instruye al asistente a cancelar solo eventos que coincidan con criterios específicos (ej. solo eventos futuros, solo para determinados clientes, solo con confirmación explícita).

El asistente usa calendly_get_event_invitees o calendly_get_invitee para recuperar la URL de confirmación del evento. Luego, si tienes configurada la herramienta WhatsApp Business o Email SMTP, puede invocar send_whatsapp_message o send_email para enviar automáticamente el enlace al cliente durante la llamada.

Sí. calendly_get_event_invitees devuelve TODOS los invitados de un evento, por lo tanto funciona también para eventos de grupo. Puedes ver cuántas personas han confirmado, sus datos, y el estado de cada invitado (activo, cancelado, pendiente).

Todas las herramientas MCP dejarán de funcionar inmediatamente. El asistente recibirá errores de autenticación cuando intente invocar cualquier herramienta Calendly. Deberás generar un nuevo token desde la configuración de Calendly y actualizarlo en la configuración AI4CALL.

No. Puedes configurar solo un Bearer Token a la vez en el servidor MCP. Si tienes más cuentas Calendly, debes elegir qué cuenta vincular. Para gestionar múltiples cuentas, deberías configurar asistentes AI4CALL separados, cada uno con su propio token.

Primero debe invocar calendly_get_scheduled_events para recuperar todos los eventos programados, luego identificar el correcto comparando fecha/hora o detalles proporcionados por el cliente. Una vez encontrado el UUID del evento correcto, puede invocar calendly_cancel_event para cancelarlo.

Muestra SOLO las franjas efectivamente disponibles para la reserva, basándose en los calendarios vinculados a tu Calendly. No se muestran horarios ya ocupados, franjas fuera del horario laboral, o fechas bloqueadas. Es la misma disponibilidad que vería un cliente en el enlace público Calendly.

No. La API Calendly a través de MCP no soporta la modificación (reprogramación) directa de eventos. Solo puedes cancelar el evento existente y hacer que el cliente reserve una nueva franja. El asistente puede guiar al cliente en este proceso secuencialmente.

Recupera información de la cuenta Calendly autenticada mediante el token: nombre, email, zona horaria, URL del perfil, y el organization UUID. Es útil para verificar que la conexión funcione y para recuperar datos necesarios para otras herramientas (algunas requieren el user URI).

Sí. En el prompt instruye al asistente a invocar calendly_get_available_times con start_time establecido en la fecha/hora actual. La herramienta devolverá las franjas disponibles en orden cronológico, y el asistente puede proponer las primeras 3-5 franjas al cliente.

Por cada invitado: nombre completo, email, estado (active/canceled), zona horaria, fecha creación invitación, URL de confirmación, eventuales preguntas/respuestas personalizadas, y el UUID único del invitado. Todos los datos necesarios para contactar al cliente o verificar el estado de la reserva.

Sí, pero los límites dependen de tu plan Calendly. Si el asistente hace demasiadas solicitudes en poco tiempo, la API Calendly puede bloquear temporalmente las llamadas. Para eventos de alto tráfico, optimiza el prompt para reducir llamadas no necesarias (ej. caché de la disponibilidad por algunos minutos).

Sí. El asistente puede usar múltiples herramientas MCP simultáneamente. Ejemplo de flujo: usa Calendly para verificar disponibilidad, luego usa la herramienta WhatsApp para enviar confirmación, o usa Google Calendar MCP para sincronizar el evento. Las herramientas MCP son componibles y el LLM las orquesta autónomamente.

Calendly gestiona automáticamente los husos horarios. calendly_get_available_times acepta el parámetro start_time en formato ISO 8601 con timezone. Los eventos e invitados devueltos incluyen siempre el huso horario específico. El asistente puede convertir automáticamente si es necesario, usando el huso horario del cliente.