Centro de ayuda

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:leer

    Ver servicios, disponibilidad y citas

  • agenda:escribir

    Crear y cancelar citas

  • clientes:leer

    Buscar clientes (nombre, teléfono y correo)

  • reportes:leer

    Ver el resumen de ventas

2 · Conectalo en ChatGPT

  1. En ChatGPT, abrí Configuración › Seguridad e inicio de sesión y activá el modo desarrollador.
  2. 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.
  3. 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.
  4. 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

HerramientaPermisoQué hace
capacidades_usuarioautenticaciónScopes, herramientas y límites efectivos, sin datos personales.
listar_serviciosagenda:leerServicios activos con duración y precio.
disponibilidadagenda:leerHorarios libres de un servicio en una fecha, por profesional.
listar_citasagenda:leerCitas entre dos fechas (hasta 31 días).
crear_citaagenda:escribirReserva una cita para un cliente en un horario libre.
cancelar_citaagenda:escribirCancela una cita aplicando tu política de cancelación.
buscar_clienteclientes:leerBusca por nombre, teléfono o correo (solo datos de contacto).
resumen_ventasreportes:leerVentas 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:escribir y 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.

Portal de reservas · Reservá, reprogramá o cancelá tus turnos online, sin crear cuenta.