Asistentes
Conectar un asistente de IA a tu agenda
Con el conector MCP, un asistente como ChatGPT o Claude consulta tu agenda, reserva y cancela citas en tu nombre. Vos decidís qué puede hacer: aprobás los permisos en una pantalla de Agendese (OAuth) o creás un token, y lo revocás cuando quieras.
1 · Copiá la dirección del servidor
Entrá a Configuración › Conexiones y buscá «Conector para asistentes de IA». La dirección es https://TU-DOMINIO/api/mcp (la ves completa, lista para copiar). Con ella el asistente descubre solo cómo pedirte autorización.
Los permisos que vas a poder aprobar:
agenda:leerVer servicios, disponibilidad y citas
agenda:escribirCrear y cancelar citas
clientes:leerBuscar clientes (nombre, teléfono y correo)
reportes:leerVer el resumen de ventas
2 · Conectalo en ChatGPT
- En ChatGPT, abrí Configuración › Seguridad e inicio de sesión y activá el modo desarrollador.
- Agregá un conector (el botón «+» de la sección de conectores o plugins), pegá la dirección del servidor, poné un nombre y elegí OAuth como autenticación.
- ChatGPT se registra solo en Agendese y te abre una pantalla nuestra: ingresá con tu usuario del panel, elegí el negocio (si tenés más de uno), dejá marcados los permisos que quieras dar y tocá Permitir acceso.
- Volvés a ChatGPT con el conector listo. Para usarlo, activalo desde el menú «+» de un chat nuevo.
Los nombres de los menús de ChatGPT cambian seguido y los conectores personalizados dependen de tu plan y de la configuración de tu organización en OpenAI. Solo quien administra la configuración del negocio puede aprobar la conexión, y la demo no se conecta.
3 · Conectalo en Claude u otro cliente
- Claude (web y escritorio): en Configuración › Conectores, elegí «Agregar conector personalizado» y pegá la dirección. Claude abre la misma pantalla de autorización de Agendese.
- Claude Code: usa un token a mano (ver abajo), porque su autorización vuelve a una dirección local y por seguridad solo aceptamos direcciones de retorno https:
claude mcp add --transport http agendese https://TU-DOMINIO/api/mcp --header "Authorization: Bearer agd_…" - Otros clientes MCP: cualquiera que hable MCP por HTTP (versiones 2025-03-26 a 2026-07-28) y soporte OAuth 2.1 con PKCE, registro dinámico de clientes y una dirección de retorno https. Si no, usá el token.
Alternativa: un token a mano
Si tu asistente no soporta OAuth pero sí permite enviar un encabezado, en la misma pantalla podés crear un token con nombre y permisos. Se muestra una sola vez y después solo queda su huella (hash). Se usa con el encabezado Authorization: Bearer agd_… (con la palabra Bearer y un espacio).
Herramientas disponibles
| Herramienta | Permiso | Qué hace |
|---|---|---|
| capacidades_usuario | autenticación | Scopes, herramientas y límites efectivos, sin datos personales. |
| listar_servicios | agenda:leer | Servicios activos con duración y precio. |
| disponibilidad | agenda:leer | Horarios libres de un servicio en una fecha, por profesional. |
| listar_citas | agenda:leer | Citas entre dos fechas (hasta 31 días). |
| crear_cita | agenda:escribir | Reserva una cita para un cliente en un horario libre. |
| cancelar_cita | agenda:escribir | Cancela una cita aplicando tu política de cancelación. |
| buscar_cliente | clientes:leer | Busca por nombre, teléfono o correo (solo datos de contacto). |
| resumen_ventas | reportes:leer | Ventas y cobros de un período (requiere el módulo Reportes). |
Seguridad y límites
- Cada autorización y cada token son de una sola empresa: nunca ven datos de otra.
- Los accesos por OAuth duran una hora y se renuevan solos; si un código de renovación se reutiliza, Agendese revoca la conexión entera.
- Crear y cancelar citas exige
agenda:escribiry queda en la actividad de la cita con el nombre del token o de la app. - Los horarios respetan tu horario de atención, tus bloqueos (también los semanales) y las citas existentes, en la hora de tu negocio.
- Hay un límite de pedidos por minuto por token o por app; si se supera, el asistente recibe un aviso y reintenta.
- Si sospechás de una filtración, revocá la app o el token en Configuración › Conexiones: deja de funcionar al instante.
- Al crear una cita, si el cliente tiene correo recibe la confirmación habitual del negocio (con la invitación al calendario), salvo que haya revocado los avisos por correo; la demo no envía nada.