Same-QR para desarrolladores: API, servidor MCP y CLI de un vistazo

Tres accesos, una cuenta

Same-QR para desarrolladores significa que todo lo que hace el panel también existe como API REST, como servidor MCP para asistentes de IA y como línea de comandos. Los tres llaman a las mismas funciones, con los mismos límites de plan y las mismas comprobaciones, y los tres están incluidos en todos los planes.

El acceso

Las claves las creas en el panel, en Cuenta, «Acceso para CLI, scripts y agentes»: «solo lectura», «lectura + escritura» (crear, cambiar nombres y textos) o «completo» (además cambiar destinos, desconectar y eliminar), con una validez de 30, 90, 180 o 365 días o, a propósito, sin límite, hasta 10 por cuenta. La clave empieza por sqr_live_, se muestra una sola vez y va en la variable de entorno SAMEQR_API_KEY.

La API REST

curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/konto
curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr

Códigos QR, estadísticas, páginas de invitados, cartas a partir de fotos, etiquetas, proyectos de clientes y solicitudes. Los errores llegan siempre como un objeto error con status, code y message. La descripción completa está en /api/v1/openapi.json. Límites: 120 solicitudes por minuto por clave y, por hora, 60, 300, 1.000 o 5.000 según el plan.

El servidor MCP

Dirección: https://sameqr.com/api/mcp. ChatGPT y Claude.ai lo añaden como conector e inician sesión mediante OAuth. Para Claude Code:

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

Para Cursor y Codex, «sameqr mcp» muestra las entradas para ~/.cursor/mcp.json y ~/.codex/config.toml. Con una clave de lectura, un agente solo ve las herramientas de lectura.

La CLI

npm install -g sameqr
sameqr login
sameqr qr create --name "Speisekarte" --url https://example.com/karte
sameqr seite create --vorlage speisekarte --name "Gasthof zum Löwen"
sameqr karte import karte.jpg --seite menu/gasthof-zum-loewen
sameqr seite publish menu/gasthof-zum-loewen

Sin dependencias, desde Node.js 18, con --json para scripts y valores de retorno inequívocos para los errores. «sameqr --help» muestra todos los comandos.

Por dónde empezar

• Regístrate gratis y confirma tu correo electrónico.
• Crea una clave de «solo lectura» y prueba «sameqr whoami».
• Lee las guías en sameqr.com/entwickler.
• Después elige el camino que mejor encaje con tu proyecto.

Conclusión: por qué Same-QR

Same-QR pone todo el servicio en manos de los desarrolladores, no solo una parte: API, servidor MCP y CLI con las mismas funciones que el panel, un manejo cuidadoso de las claves y límites documentados abiertamente. 20 códigos QR dinámicos son gratis de forma permanente, y para probar es suficiente.

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

Preguntas frecuentes