Configura Fidelip con tu asistente de IA

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 llaveEntra a 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 llaveSe 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 asistenteAbajo 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:

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"):

{
  "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:

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.

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.

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

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

Seguridad

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.