---
title: "Configura Fidelip con tu asistente de IA"
description: "Conecta Claude u otro asistente compatible con MCP a tu cuenta y pídele en español que cree tarjetas, cambie colores o te dé métricas."
updated: "2026-08-16"
url: "https://fidelip.com/docs#asistente-ia"
section: "Recursos"
anchors:
  - "#asistente-conectar"
  - "#asistente-configuracion"
  - "#asistente-claude-code"
  - "#asistente-claude-desktop"
  - "#asistente-otros"
  - "#asistente-probar"
  - "#asistente-que-puede"
  - "#asistente-problemas"
  - "#asistente-seguridad"
  - "#asistente-consejos"
---

# Configura Fidelip con tu asistente de IA

Conecta Claude u otro asistente compatible con MCP a tu cuenta y pídele en español que cree tarjetas, cambie colores o te dé métricas.

Puedes conectar Fidelip a un asistente de IA y pedirle las cosas en español: *«créame una tarjeta de 8 sellos para un café gratis»*, *«cambia el color de mi tarjeta a verde bosque»*, *«¿cuántos clientes nuevos tuve este mes?»*. El asistente hace los cambios en tu cuenta y te dice qué hizo.

Funciona con cualquier asistente compatible con **MCP** (Model Context Protocol), el estándar que usan Claude y otros para conectarse a herramientas externas. No necesitas saber programar: es copiar una llave y pegar un bloque de texto.

### Conectarlo en 3 pasos

1. **Crea tu llave** Entra a [app.fidelip.com/dashboard/agente](https://app.fidelip.com/dashboard/agente) (o en el panel: tu menú de perfil, abajo a la izquierda → **Conecta tu asistente**). Ponle nombre, decide si puede hacer cambios o solo leer, y pulsa **Crear llave**. Solo el dueño y los administradores pueden crearlas.
2. **Copia la llave** Se ve así: `fmcp_a1b2c3…`. Aparece **una sola vez** — si la pierdes, revócala desde esa misma pantalla y crea otra. Trátala como una contraseña.
3. **Pega la configuración en tu asistente** Abajo está el bloque exacto para cada cliente. La misma pantalla del panel te lo muestra ya con tu llave puesta, listo para copiar. Después reinicia el asistente.

### La configuración, por cliente

Sustituye `TU_LLAVE` por la llave que copiaste. El servidor siempre es el mismo: `https://api.fidelip.com/mcp`.

#### Claude Code

Un solo comando en la terminal:

**Terminal**

```bash
claude mcp add --transport http fidelip https://api.fidelip.com/mcp \
  --header "Authorization: Bearer TU_LLAVE"
```

#### Claude Desktop

Ajustes → Desarrollador → **Editar configuración**. Se abre un archivo `claude_desktop_config.json`; pega esto dentro (si ya tienes otros servidores, agrega solo la parte de `"fidelip"` dentro de `"mcpServers"`):

**claude_desktop_config.json**

```json
{
  "mcpServers": {
    "fidelip": {
      "type": "http",
      "url": "https://api.fidelip.com/mcp",
      "headers": {
        "Authorization": "Bearer TU_LLAVE"
      }
    }
  }
}
```

#### Otros clientes

Cualquier cliente que hable MCP sobre HTTP sirve. Estos son los tres datos que te va a pedir:

**Datos de conexión**

```text
URL:            https://api.fidelip.com/mcp
Transporte:     HTTP (streamable)
Autenticación:  Authorization: Bearer TU_LLAVE
```

### Comprobar que quedó

Reinicia el asistente y pídele algo de solo lectura, por ejemplo *«¿qué tarjetas de lealtad tengo en Fidelip?»*. Si te contesta con los nombres reales de tus tarjetas, ya está conectado. Si te dice que no tiene acceso o no encuentra la herramienta, revisa [Si no conecta](https://fidelip.com/docs/asistente-ia#asistente-problemas).

> [!TIP] Tip
> Empieza con una llave **sin** permiso de cambios. Puedes preguntarle lo que quieras y no hay forma de que modifique nada; cuando te sientas cómodo, creas otra con permisos.

### Qué puede y qué no puede hacer

La lista de lo que **no** puede hacer es corta a propósito y no es configurable: esas acciones simplemente no existen del lado del asistente, así que ningún error ni ninguna instrucción rara puede provocarlas.

| Puede | No puede |
| --- | --- |
| Ver tus tarjetas, premios, reglas, niveles y sucursales | Borrar o desactivar una tarjeta |
| Crear una tarjeta nueva (máximo 2 al día) | Cambiar el tipo de una tarjeta existente |
| Cambiar nombre, número de sellos y meta de puntos | Ver, exportar o modificar datos de tus clientes |
| Cambiar los colores de la tarjeta | Acumular o canjear puntos y sellos |
| Crear y editar premios | Enviar notificaciones ni cupones |
| Definir cómo se acumula (por visita, producto o monto) | Tocar tu facturación o tu plan |
| Consultar métricas del negocio | Crear, editar o borrar cuentas de tu equipo |

El logo, el banner y los íconos de sello se suben desde el panel, no por el asistente — son archivos, y conviene que veas la vista previa antes de publicarlos.

### Si no conecta

| Lo que ves | Qué revisar |
| --- | --- |
| **«No tengo acceso a Fidelip» o no aparece la herramienta** | El asistente no recargó la configuración. Ciérralo por completo y vuelve a abrirlo (en Claude Desktop no basta con cerrar la ventana). |
| `invalid_token` | La llave está mal copiada, tiene espacios, o fue revocada. Crea una nueva desde el panel y pégala completa, incluyendo el prefijo fmcp_. |
| `missing_token` | Falta el encabezado de autorización, o quedó escrito sin la palabra «Bearer » antes de la llave. |
| **«Esta llave no tiene el permiso cards:write»** | La llave se creó de solo lectura. Crea otra marcando «Permitir cambios». |
| **Contesta con datos de otro negocio** | No puede pasar: el negocio se deduce de la llave. Si ves esto, escríbenos. |

Para confirmar que el servidor está arriba puedes abrir [https://api.fidelip.com/mcp/health](https://api.fidelip.com/mcp/health) en el navegador: debe responder `{"ok":true,…}`. Esa dirección no pide llave.

### Seguridad

| Protección | Cómo funciona |
| --- | --- |
| **La llave es tuya, no del negocio** | Actúa con tus permisos y todo lo que hace queda registrado a tu nombre. Solo el dueño y los administradores pueden crear llaves. |
| **Nunca elige el negocio** | El negocio se deduce de la llave. No hay forma de que el asistente toque la cuenta de alguien más, ni por error ni a propósito. |
| **Confirmación en cambios delicados** | Reducir los sellos de una tarjeta que ya tiene clientes obliga al asistente a mostrarte primero a cuánta gente afecta y pedirte tu OK. |
| **Límites de velocidad** | Máximo 2 tarjetas nuevas al día y un tope de cambios por hora, para que un asistente en bucle no pueda hacer un desastre. |
| **Bitácora visible** | La pantalla «Conecta tu asistente» lista todo lo que han hecho tus asistentes, con fecha y detalle. |
| **Revocación inmediata** | Borra la llave desde el panel y el acceso se corta al instante, sin esperar a que expire. |

> [!WARNING] Advertencia
> Trata la llave como una contraseña: no la pegues en un chat de grupo, en un documento compartido ni en una captura de pantalla. Si crees que se filtró, revócala desde el panel — es un clic y toma efecto de inmediato.

### Cómo pedirle las cosas

Los asistentes trabajan mejor con contexto de negocio que con instrucciones técnicas. En vez de «pon stamp_card_size en 8», dile *«vendo café y quiero que el octavo salga gratis»* y déjalo traducir. Dos cosas que ayudan:

- Pídele primero que **te lea** tu configuración actual antes de cambiar nada. Es la forma más rápida de confirmar que está conectado a la cuenta correcta.
- Cuando te muestre advertencias (por ejemplo «12 clientes van a medias»), **léelas**. Están ahí porque el cambio afecta a personas reales que ya traen tu tarjeta en el teléfono.

> [!NOTE] Nota
> Disponible en todos los planes con programa de lealtad. Si algo no te funciona al conectarlo, escríbenos a [hola@fidelip.com](mailto:hola@fidelip.com) con el nombre del asistente que estás usando.