Servidor MCP para códigos QR: usar Same-QR en Claude, ChatGPT, Cursor y Codex

Qué es un servidor MCP

MCP significa Model Context Protocol, un estándar abierto para la conexión entre asistentes de IA y otros servicios. Un servidor MCP describe las herramientas de un servicio, por ejemplo «crear código QR» o «leer estadísticas». El asistente ve esas herramientas y las llama cuando una tarea las necesita.

Qué ofrece el servidor MCP de Same-QR

El servidor está en https://sameqr.com/api/mcp y ofrece exactamente las herramientas de la API REST, con los mismos nombres, comprobaciones y límites del plan:

• Consultar la cuenta y el plan, para que el asistente sepa qué es posible.
• Listar, leer, crear, modificar y eliminar códigos QR, y consultar sus estadísticas.
• Crear, leer, modificar, publicar, desactivar y eliminar páginas de invitados, además de la lista de diseños.
• Importar cartas de restaurante y listas de precios a partir de fotos o PDF.
• Gestionar etiquetas y proyectos de clientes y leer las solicitudes de los formularios de contacto.

Las herramientas de lectura están marcadas como tales y las de eliminación como definitivas. Quien quiera cambiar destinos, desactivar una página o eliminarla tiene que preguntar al usuario y enviar el estado leído previamente. Mediante API y MCP se permiten como máximo 10 por hora.

Dos formas de iniciar sesión

ChatGPT y Claude.ai añaden el servidor como conector. El inicio de sesión funciona con OAuth: te identificas en Same-QR desde el navegador y, con una casilla, decides si la app solo puede leer, también crear y modificar textos, o además cambiar destinos y eliminar.

Claude Code, Cursor y Codex se conectan con una clave de API. La creas en el panel, en Cuenta, «Acceso para CLI, scripts y agentes», eliges «solo lectura», «lectura + escritura» (crear, modificar nombres y textos) o «completo» (además cambiar destinos, desactivar, eliminar) y la guardas como variable de entorno SAMEQR_API_KEY. Una clave de «solo lectura» tiene un buen efecto secundario: el asistente ni siquiera ve las herramientas de escritura.

La configuración de un vistazo

Para Claude Code basta un comando en el terminal:

claude mcp add --transport http sameqr https://sameqr.com/api/mcp --header "Authorization: Bearer $SAMEQR_API_KEY"

Para Cursor, una entrada en ~/.cursor/mcp.json:

{ "mcpServers": { "sameqr": { "url": "https://sameqr.com/api/mcp", "headers": { "Authorization": "Bearer ${env:SAMEQR_API_KEY}" } } } }

Para Codex, una sección en ~/.codex/config.toml:

[mcp_servers.sameqr]
url = "https://sameqr.com/api/mcp"
bearer_token_env_var = "SAMEQR_API_KEY"

Quien tenga instalada la línea de comandos sameqr puede ver estos datos en cualquier momento con «sameqr mcp». Prueba cada conexión primero con una pregunta de lectura, por ejemplo «¿Qué códigos QR tengo?».

Seguridad y permisos

• Para asistentes que solo deben analizar, usa una clave de «solo lectura».
• Nunca escribas la clave en archivos del proyecto, ponla como variable de entorno.
• Antes de cambiar códigos QR ya impresos, pide que te muestren el plan.
• Revoca en el panel las claves que ya no necesites. Dejan de ser válidas al instante.

Conclusión: por qué Same-QR

Same-QR ofrece un servidor MCP completo en lugar de un puñado de funciones de juguete: códigos QR, estadísticas, cartas de restaurante, páginas de invitados, etiquetas y proyectos, tanto para asistentes de chat como para agentes de programación. Está incluido en todos los planes, con permisos claros y las mismas comprobaciones que en el panel.

Empieza ya: regístrate gratis en sameqr.com, 20 códigos QR dinámicos son gratis para siempre. API, CLI y servidor MCP están en todos los planes, y la documentación está en sameqr.com/entwickler.

Preguntas frecuentes