Conectar tu asistente de IA (Claude)
Conecta Claude a tu cuenta de Xtarly Rewards para configurar tu programa de lealtad y tus premios conversando.
Puedes conectar tu asistente de IA a tu cuenta de Xtarly Rewards y configurar tu programa de lealtad conversando: le pides «quiero 8 sellos y un café gratis al completar» y el asistente lo prepara, te muestra qué va a cambiar y, cuando se lo confirmas, lo aplica.
Hoy funciona con Claude (claude.ai en web, escritorio y móvil). Más adelante podrá conectarse cualquier asistente compatible con MCP que use OAuth.
URL del conector: https://api.xtarly.com/api/mcp
Requisitos
- Ser owner o admin del negocio en Xtarly. Otros roles no pueden reconfigurar el programa.
- Tener una cuenta de Claude (claude.ai). El plan Free permite 1 conector personalizado.
- Que tu cuenta de Xtarly esté al corriente: una cuenta morosa o cancelada no puede reconfigurar el programa.
Cómo conectarlo
Agrega el conector en Claude
Planes Free, Pro y Max:
- En Claude, ve a Personalizar → Conectores (en inglés: Customize → Connectors).
- Elige Agregar conector personalizado (Add custom connector).
- Pega la URL
https://api.xtarly.com/api/mcp. - Pulsa Add.
Planes Team y Enterprise: un Owner de la organización agrega el conector en Organization settings → Connectors con la misma URL. Después, cada miembro pulsa Connect para vincular su propia cuenta de Xtarly.
Inicia sesión en Xtarly
Al conectar, Claude abre el inicio de sesión de Xtarly. Entra con la cuenta con la que administras tu negocio.
Revisa y concede los permisos
Xtarly te muestra una pantalla de permisos que explica qué podrá hacer el asistente. Pulsa Permitir para terminar, o Rechazar si no quieres conectarlo.
Empieza a conversar
De vuelta en Claude, pídele lo que necesitas. Según cómo lo tengas configurado en Claude, te pedirá aprobación en cada acción.
Cuando Xtarly agregue funciones nuevas al asistente, tendrás que desconectar y volver a conectar el conector para verlas (ve «Solución de problemas» más abajo).
Qué puede hacer el asistente
| Acción | Detalle |
|---|---|
| Ver tus negocios | Lista los negocios a los que tienes acceso. |
| Ver tu programa | Tipo (puntos, sellos o niveles), puntos por peso, sellos requeridos, vencimientos y topes antifraude; también tus niveles y premios. |
| Ver tu menú y tus sucursales | Para premios por producto o por sucursal: el asistente toma de ahí los productos y sucursales a los que aplica el premio. Solo los consulta, no los cambia. |
| Ver cómo va tu negocio | Totales por periodo (7 días, 30 días, 90 días o 12 meses): clientes nuevos y activos, transacciones y monto, puntos o sellos emitidos y canjes por premio, también por sucursal. Nunca muestra clientes uno por uno. |
| Previsualizar un cambio | Te dice qué cambia y a cuántos clientes con saldo afecta, sin aplicar nada. |
| Configurar el programa | Pide confirmación. Cambiar el tipo de programa exige doble confirmación. |
| Configurar niveles | Crea o ajusta los niveles de tu programa. |
| Crear premios | Nacen desactivados y se publican con un paso aparte que el asistente debe pedirte, porque publicar un premio avisa a tus clientes con notificaciones activadas y, si tienes encendidas las novedades automáticas, también por WhatsApp y correo. |
| Editar, activar y eliminar premios | Eliminar pide confirmación. |
Para saber cómo funciona cada ajuste, consulta Programa de lealtad y Recompensas.
Qué NO puede hacer
El asistente trabaja con la configuración del programa y los premios, y consulta —sin cambiarlos— tu menú, tus sucursales y las métricas generales de tu negocio. No puede ver ni tocar:
- datos de tus clientes finales (nombres, teléfonos, correos, saldos individuales);
- transacciones o canjes uno por uno (solo ve totales por periodo);
- cupones (solo ve cuántos se canjearon);
- campañas;
- cambios a tu menú o a tus sucursales (solo los consulta);
- pagos ni facturación.
Consejo: antes de confirmar cualquier cambio, pide «muéstrame primero qué va a cambiar». El asistente te enseña el efecto (incluido a cuántos clientes con saldo afecta) y tú decides.
Ejemplos de peticiones
- «Configura mi programa con 8 sellos y un café gratis al completar.»
- «Quiero puntos: 1 punto por cada $10 y que venzan a los 12 meses.»
- «Crea tres premios: postre gratis a 5 sellos, bebida a 8 y 20 % de descuento a 10, pero no los publiques todavía.»
- «¿Cómo tengo configurado el programa hoy?»
Cómo revocar el acceso
El acceso dura hasta que tú lo revoques. Tienes dos caminos:
- Desde Xtarly: ve a Ajustes de cuenta → Seguridad → Asistentes de IA conectados y pulsa Revocar.
- Desde Claude: quita el conector en tus ajustes de conectores.
Seguridad y privacidad
- Actúa con tu cuenta y tus permisos. El asistente no puede hacer nada que tú no puedas hacer; solo owners y admins del negocio pueden reconfigurar, y una cuenta morosa o cancelada no puede.
- Todo queda registrado. Cada cambio aparece en el registro de actividad del negocio (Ajustes → Actividad) con la marca del asistente, para que sepas qué se hizo desde la conversación.
- Revisa antes de aprobar. Las herramientas de cambios delicados (cambiar el tipo de programa, publicar o eliminar premios) exigen que el asistente confirme expresamente y están pensadas para que te pregunte antes. Según cómo lo tengas configurado en Claude, también te pedirá aprobación en cada acción. Si algo no salió como querías, lo ves en Actividad.
- Qué datos viajan al proveedor del asistente: tu nombre, correo y foto de perfil, y la información de tu negocio que consulte: la configuración del programa (niveles y premios), tu menú, tus sucursales con su dirección y métricas generales por periodo (cuántos clientes, transacciones y canjes, con montos totales y promedio). No los datos personales de tus clientes.
Solución de problemas
| Mensaje o síntoma | Qué significa | Qué hacer |
|---|---|---|
| «No pudimos confirmar a qué sitio te regresaremos» | Xtarly no pudo verificar a dónde regresa la conexión. | Continúa solo si tú iniciaste la conexión desde Claude. Si no, cierra la ventana. |
| «La solicitud caducó» | La solicitud de conexión dura 10 minutos y pasó ese tiempo. | Vuelve a conectar desde Claude. |
| «insufficient scope» | La conexión no tiene los permisos que pide la acción. | Reconecta el conector desde Claude y concede los permisos. |
| El asistente no tiene una herramienta nueva que anunciamos | Claude guarda la lista de herramientas al conectar y no la actualiza sola. | Desconecta y vuelve a conectar el conector en Personalizar → Conectores (Xtarly Rewards → Desconectar → Conectar); te pedirá permiso de nuevo. Abrir un chat nuevo a veces basta. |
Límites de esta primera versión
- Solo funciona con Claude.ai (web, escritorio y móvil). Claude Code con puerto local todavía no está soportado.
- El premio tipo «producto gratis» puede vincularse a productos del menú solo si esos productos ya existen.