Claude Code y códigos QR: configura Same-QR con MCP paso a paso

Qué es Claude Code

Claude Code es un agente de programación de Anthropic. Se ejecuta en el terminal o en el entorno de desarrollo, lee y edita archivos y ejecuta comandos. A través de MCP, el Model Context Protocol, utiliza además herramientas de otros servicios. Conectado con Same-QR, puede editar códigos QR, páginas para invitados, cartas, etiquetas y proyectos de clientes en tu cuenta.

Paso 1: crea una clave de API

En el panel de Same-QR, abre Cuenta y la sección “Acceso para CLI, scripts y agentes”. Crea una clave. Si Claude Code solo debe analizar datos, elige “solo lectura”: así el agente ni siquiera ve las herramientas de escritura. Para crear elementos, elige “lectura + escritura”; si además debe cambiar los destinos de códigos QR existentes, “completo”. La clave empieza por sqr_live_ y solo se muestra una vez.

Paso 2: define la clave como variable de entorno

Guarda la clave en tu gestor de contraseñas y ponla a disposición como variable de entorno SAMEQR_API_KEY, por ejemplo al iniciar la shell. No debe estar en los archivos del proyecto.

Paso 3: añade el servidor MCP

Basta un comando en el terminal:

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

Si tienes instalada la línea de comandos sameqr, también verás esta línea con “sameqr mcp”.

Paso 4: prueba la conexión

Inicia Claude Code y pregunta primero algo que no cambie nada: “¿Qué plan tengo en Same-QR y qué códigos QR hay?” El servidor recomienda al agente empezar con esta consulta de la cuenta, para que conozca los límites de tu plan.

Paso 5: códigos QR para una página de campaña

Una tarea típica cuando en el proyecto nace una nueva landing page:

“Crea en Same-QR tres códigos QR dinámicos para la nueva página /herbst: cartel, folleto y expositor de mesa. Añade al destino de cada uno utm_source=qr y utm_medium con el soporte correspondiente, ponles a todos la etiqueta Campaña de otoño y enséñame antes la lista.”

Tras tu confirmación, Claude Code crea los códigos QR. Como cada soporte publicitario tiene su propio código QR, luego podrás ver en Same-QR y en la analítica web qué soporte se ha usado y cuántas veces. Los archivos de impresión en SVG o PDF los descargas desde el panel.

Permisos y control

• Antes de cambiar códigos QR ya impresos, pide siempre primero una lista.
• Cambiar destinos y eliminar exigen una confirmación con el estado leído, como máximo 10 por hora. Confirma solo de forma consciente.
• Si quieres que la tarea se convierta en un flujo repetible, pide a Claude Code que escriba un script con la CLI sameqr.
• Revoca la clave cuando el proyecto haya terminado.

Conclusión: por qué Same-QR

Same-QR encaja con Claude Code como una herramienta integrada: un comando para configurarlo, todas las funciones del panel como herramientas MCP, claves de lectura que ocultan las herramientas de escritura y una documentación que un agente entiende. En todos los planes, también en el gratuito.

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

Preguntas frecuentes