El servidor TRYB Loyalty MCP permite que su asistente de IA se comunique directamente con su cuenta de TRYB Loyalty.
Una vez conectado, puede gestionar clientes, tarjetas de lealtad, plantillas de tarjetas, saldos y flujos de trabajo de automatización simplemente pidiendo — en Claude, Cursor, VS Code o cualquier otro cliente compatible con MCP.
Utiliza el Protocolo de Contexto de Modelo sobre HTTP Transmisible y se autentica ya sea iniciando sesión con su cuenta de TRYB Loyalty (OAuth) — la forma recomendada — o con una clave API personal.
Lo que puede hacer una vez conectado
Clientes y segmentos — crear, buscar, actualizar y eliminar clientes; listar segmentos.
Plantillas — crear plantillas de tarjetas y gestionar niveles de recompensa, niveles de membresía y enlaces de comentarios.
Tarjetas — emitir tarjetas, buscarlas, actualizar campos y establecer vencimiento y nivel de membresía.
Saldos — añadir o restar sellos, puntos, puntuaciones, visitas, importes, compras y recompensas; canjear cupones.
Ubicaciones — crear y gestionar ubicaciones de tiendas.
Enlaces UTM — crear y gestionar enlaces de seguimiento UTM y leer sus estadísticas de recompensa e inscripción.
Flujos de trabajo — crear, activar, pausar, ejecutar e inspeccionar flujos de trabajo de automatización y sus registros.
Servicios externos — conectar y gestionar integraciones de terceros.
Etiqueta blanca — gestionar dominios personalizados, marca y menús de subcuentas para configuraciones de etiqueta blanca.
Agencias — buscar subcuentas y actuar en su nombre en planes de Agencia.
Propiedad
Valor
URL del servidor
https://api.trybloyalty.com/mcp
Transporte
HTTP transmisible
Autenticación
OAuth 2.1 (recomendado) o Authorization: Bearer <YOUR_API_KEY>
Método
POST
¿Utiliza un dominio personalizado o de etiqueta blanca? Reemplace api.trybloyalty.com con su propio host de API en todas partes a continuación (por ejemplo https://api.your-brand.com/mcp). El inicio de sesión funciona igual en cualquier dominio — cada host es su propio emisor.
Una cuenta TRYB Loyalty Business Plan que incluye acceso a API.
Un cliente compatible con MCP como Claude Desktop, Claude Code, Cursor o VS Code.
Node.js solo es necesario para la configuración de clave API en Claude Desktop (el proxy mcp-remote). La configuración de OAuth no necesita nada adicional.
Hay dos formas de autenticarse. Elija una:
Inicie sesión con OAuth (recomendado) — sin clave que copiar. Apunte su cliente a la URL del servidor, luego inicie sesión con su inicio de sesión normal de TRYB Loyalty en el navegador y apruebe el acceso. Su cliente se registra automáticamente y actualiza su acceso por usted.
Clave API — envíe un token Bearer personal con cada solicitud. Mejor para clientes sin soporte OAuth, scripts y automatización.
Solo proporciona a su cliente la URL del servidor. En el primer uso, abre un navegador, inicia sesión en TRYB Loyalty y aprueba el acceso, y el asistente se conecta — sin necesidad de copiar o almacenar una clave API.
Claude Code
Claude Desktop / Claude.ai
Cursor
VS Code (Copilot)
Otros clientes
Ejecute este comando en su terminal:
Copiar
claude mcp add --transport http tryb https://api.trybloyalty.com/mcpLuego ejecute /mcp, seleccione tryb → Authenticate, y se abrirá una ventana del navegador para que inicie sesión y apruebe. Verifique con claude mcp list.
Permisos. Cuando aprueba el acceso, al asistente se le otorgan dos ámbitos: mcp:read para herramientas de solo lectura, y mcp:write para herramientas que crean, actualizan o eliminan datos.
Utilice esto para clientes que no admiten OAuth, o para scripts y automatización.
Inicie sesión en su panel de control de TRYB Loyalty.
Abra Configuración → API.
Copie su clave API personal.
Su clave API otorga acceso completo a su cuenta.
Trátela como una contraseña. Nunca la comparta. Nunca la confirme en un repositorio público. Rótela inmediatamente si se filtra.
Seleccione su cliente a continuación y agregue la configuración.
Reemplaza <YOUR_API_KEY> con la clave del paso anterior.
Claude Code
Claude Desktop
Cursor
VS Code (Copilot)
Otros clientes
Ejecuta este comando en tu terminal:
Copiar
claude mcp add --transport http tryb https://api.trybloyalty.com/mcp \
--header "Authorization: Bearer <YOUR_API_KEY>"Verifica con claude mcp list.
Después de conectar, pregunta a tu asistente:
Utilice la herramienta whoami e indíqueme a qué cuenta está conectado.
Si la conexión funciona, devuelve el nombre de su empresa, tarifa, moneda e idioma.
También puede pedirle que enumere sus plantillas de tarjetas o enumere sus clientes para confirmar que las herramientas funcionan de extremo a extremo.
Si su cuenta está en una tarifa Agency o Agency Partner, también obtiene herramientas para trabajar en subcuentas:
search_companies y get_company — buscar e inspeccionar subcuentas y referencias.
impersonate_company — cambiar la sesión para actuar en nombre de una subcuenta.
stop_impersonation — volver a su propio contexto de agencia.
La suplantación tiene alcance de sesión y caduca automáticamente después de 1 hora.
Prefiera OAuth — no se almacena ningún secreto de larga duración en los archivos de configuración de su cliente.
Si utiliza una clave API, guárdela en una variable de entorno o en el almacén de secretos de su cliente.
Utilice una clave dedicada para asistentes de IA para poder rotarla de forma independiente.
Rote la clave inmediatamente si sospecha que ha sido expuesta.
Síntoma
Causa probable y solución
El inicio de sesión del navegador no se completa
Asegúrese de que ha iniciado sesión en la cuenta correcta de TRYB Loyalty en ese navegador y vuelva a intentarlo. Elimine y vuelva a añadir el servidor para reiniciar el flujo.
401 Unauthorized
Con OAuth, vuelva a ejecutar el inicio de sesión. Con una clave API, la clave falta, está mal escrita o su plan no incluye acceso a API — cópiela nuevamente desde Configuración → API y confirme su tarifa.
Las herramientas no aparecen
El cliente no se reinició completamente. Ciérrelo y vuelva a abrirlo. Para Claude Desktop, cierre la aplicación por completo.
npx o errores de mcp-remote
Node.js no está instalado o no está en su PATH. Instale Node.js e intente de nuevo. (Solo la configuración de Claude Desktop con clave API lo necesita.)
La conexión funciona pero las acciones fallan
Es posible que la acción no esté disponible en su tarifa, o que falte un campo obligatorio. Compruebe el mensaje de error devuelto para ver la respuesta del servidor.