---
title: "MCP"
description: "Conecte el servidor MCP de TRYB Loyalty a Claude, Cursor, VS Code y otros asistentes de IA, y gestione su programa de lealtad en lenguaje natural."
url: https://help.tryb.business/es/articles/86-mcp
collection: "API"
updated: 2026-08-18
language: es
alternates: [en, fr]
---

# MCP

Conecte el servidor MCP de TRYB Loyalty a Claude, Cursor, VS Code y otros asistentes de IA, y gestione su programa de lealtad en lenguaje natural.

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](https://modelcontextprotocol.io/) 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.
    

#### **Detalles de conexión**

**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.

#### **Antes de comenzar**

-   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](https://nodejs.org/) 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.
    

#### **Elija cómo conectarse**

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.
    

### **Opción 1 — Iniciar sesión con OAuth (recomendado)**

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

```javascript
claude mcp add --transport http tryb https://api.trybloyalty.com/mcp
```

Luego 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.

### **Opción 2 — Conectar con una clave API**

Utilice esto para clientes que no admiten OAuth, o para scripts y automatización.

### **Obtenga su clave API**

1.  Inicie sesión en su **panel de control de TRYB Loyalty**.
    
2.  Abra **Configuración → API**.
    
3.  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.

### **Agregue el servidor a su asistente de IA**

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

```javascript
claude mcp add --transport http tryb https://api.trybloyalty.com/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"
```

Verifica con `claude mcp list`.

### **Verifica la conexión**

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.

#### **Cuentas de agencia**

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.

#### **Mejores prácticas de seguridad**

-   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.
    

#### **Solución de problemas**

**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](https://nodejs.org/) 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.
