Conecta tu asistente de IA (MCP)

QR Top expone un servidor MCP (Model Context Protocol), el estándar abierto que usan Claude, ChatGPT y la mayoría de asistentes para operar herramientas externas. Conectado, tu asistente puede crear QRs, cambiar destinos, configurar smart routing y consultar estadísticas — con tu permiso y sobre tu organización. Disponible en todos los planes.

La URL del conector

https://qr-top.com/api/mcp

Es un servidor remoto (transporte Streamable HTTP): no hay nada que instalar. La forma recomendada de autenticarse es el login interactivo (OAuth) — el asistente abre el navegador, inicias sesión con tu cuenta de QR Top y listo, sin copiar claves.

Claude Code

Terminal

claude mcp add --transport http qr-top https://qr-top.com/api/mcp

Dentro de la sesión, ejecuta /mcp, selecciona qr-top y pulsa Authenticate: se abre el navegador con el login de QR Top (puedes crear la cuenta ahí mismo si no la tienes).

claude.ai y Claude Desktop

Ajustes → Conectores → Añadir conector personalizado, con la URL de arriba. Al conectar, se abre el login de QR Top en una pestaña.

Cursor, Windsurf y similares (con API key)

Para clientes que se configuran por fichero, usa una API key (se crea en Ajustes → API de tu cuenta) en la cabecera Authorization:

mcp.json

{
  "mcpServers": {
    "qr-top": {
      "url": "https://qr-top.com/api/mcp",
      "headers": { "Authorization": "Bearer qr_live_TU_KEY" }
    }
  }
}

Clientes solo-stdio

Vía mcp-remote, que gestiona el flujo OAuth por ti:

Configuración del cliente

{
  "mcpServers": {
    "qr-top": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://qr-top.com/api/mcp"]
    }
  }
}

Qué puede hacer tu asistente

Herramienta	Qué hace
list_links	Lista tus enlaces con escaneos, URL corta y estado
create_link	Crea un QR dinámico — con smart routing, expiración y UTMs si tu plan lo incluye
update_link	Cambia destino, título, estado o reglas — efecto inmediato en QRs impresos
delete_link	Elimina un enlace y su historial (te pedirá confirmación)
get_link_stats	Analytics: totales, dispositivos y serie diaria de 30 días
get_account	Tu plan, uso frente a límites y features disponibles

Ejemplos de lo que puedes pedir

“Crea un QR para cada una de las 20 mesas, todos a la carta con ?mesa=N”
“Crea un QR que de 8 a 12, hora de Madrid, muestre la carta de desayunos y el resto del día la general”
“¿Cuál de mis QRs de julio tiene más escaneos? Compáramelos”
“Pausa todos los enlaces sin escaneos en los últimos 30 días”

Seguridad y límites

El asistente solo ve y modifica los enlaces de tu organización, con los mismos límites de plan y de peticiones que la API REST.
El acceso OAuth va ligado a tu sesión; las API keys se revocan en Ajustes → API.
Borrar enlaces está marcado como acción destructiva: los clientes MCP piden confirmación antes de ejecutarla.
Funciones de pago (smart routing, slugs personalizados) devuelven un mensaje claro si tu plan no las incluye — el asistente te lo dirá.