Same-QR per sviluppatori: API, server MCP e CLI a colpo d'occhio

Tre accessi, un account

Same-QR per sviluppatori significa: tutto ciò che il dashboard può fare è disponibile anche come REST API, come server MCP per assistenti IA e come riga di comando. Tutti e tre chiamano le stesse funzioni, con gli stessi limiti tariffari e verifiche, e tutti e tre sono inclusi in ogni piano tariffario.

L'accesso

La chiave viene creata nella dashboard sotto Conto, "Accesso per CLI, script e agenti", come "solo lettura", "lettura + scrittura" (creare, modificare nomi e testi) o "completo" (inoltre modificare destinazioni, mettere offline, eliminare), con durata di 30, 90, 180 o 365 giorni o intenzionalmente illimitata, fino a 10 per account. La chiave inizia con sqr_live_, viene visualizzata una sola volta e deve essere inserita nella variabile d'ambiente SAMEQR_API_KEY.

La REST API

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

Codici, statistiche, pagine ospitate, menù da foto, etichette, progetti clienti e richieste. Gli errori vengono restituiti uniformemente come oggetto error con status, code e message. La descrizione completa si trova sotto /api/v1/openapi.json. Limiti: 120 richieste al minuto per chiave, 60, 300, 1.000 o 5.000 all'ora a seconda del piano tariffario.

Il server MCP

Indirizzo https://sameqr.com/api/mcp. ChatGPT e Claude.ai lo aggiungono come connettore e si autenticano tramite OAuth. Per Claude Code:

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

Per Cursor e Codex, "sameqr mcp" mostra le voci per ~/.cursor/mcp.json e ~/.codex/config.toml. Con una chiave di sola lettura, un agente vede solo gli strumenti di lettura.

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

Senza dipendenze, a partire da Node.js 18, con --json per script e valori di ritorno univoci per gli errori. "sameqr --help" mostra tutti i comandi.

Dove iniziare

• Registrati gratuitamente e conferma l'indirizzo email.
• Crea una chiave "solo lettura" e prova "sameqr whoami".
• Leggi le istruzioni su sameqr.com/entwickler.
• Poi scegli la strada che si adatta al tuo progetto.

Conclusione: perché Same-QR

Same-QR offre agli sviluppatori il servizio completo nelle mani, non solo una parte: API, server MCP e CLI con le stesse funzionalità della dashboard, una gestione accurata delle chiavi e limiti documentati in modo aperto. Due codici dinamici sono gratuiti per sempre, sufficienti per provare.

Inizi subito: registrati gratuitamente su sameqr.com, due codici QR dinamici sono gratuiti per sempre. API, CLI e server MCP sono inclusi in ogni piano, la documentazione è su sameqr.com/entwickler.

Domande frequenti