Claude Code e codici QR: configurare Same-QR per MCP, passo dopo passo

Cos'è Claude Code

Claude Code è un agente di codifica di Anthropic. Esegue nel terminale o nell'ambiente di sviluppo, legge e modifica i file ed esegue comandi. Attraverso MCP, il Model Context Protocol, utilizza inoltre strumenti di altri servizi. Collegato a Same-QR, può modificare codici, pagine ospitate, menù, etichette e progetti clienti nel tuo account.

Passo 1: Creare la chiave API

Apri nella dashboard di Same-QR Account e la sezione «Accesso per CLI, script e agenti». Crea una chiave. Se Claude Code deve solo analizzare, scegli «solo lettura»: l’agente non vedrà nemmeno gli strumenti di scrittura. Per creare scegli «lettura + scrittura», se deve anche cambiare le destinazioni di codici esistenti, «completo». La chiave inizia con sqr_live_ e viene mostrata una sola volta.

Passo 2: Impostare la chiave come variabile d'ambiente

Conserva la chiave nel tuo gestore di password e rendila disponibile come variabile d'ambiente SAMEQR_API_KEY, ad esempio all'avvio della shell. Non deve trovarsi nei file del progetto.

Passo 3: Aggiungere il server MCP

Un comando nel terminale è sufficiente:

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

Chi ha installato la riga di comando sameqr riceve anche questa riga con "sameqr mcp".

Passo 4: Testare la connessione

Avvia Claude Code e chiedi prima qualcosa che non modifica nulla: "Quale tariffa ho presso Same-QR e quali codici QR ci sono?" Il server consiglia all'agente di iniziare con questa verifica dell'account, in modo che conosca i limiti della tua tariffa.

Passo 5: Codici per una pagina di campagna

Un compito tipico quando nel progetto nasce una nuova landing page:

„Crea tre codici QR dinamici in Same-QR per la nuova pagina /herbst: poster, volantino e espositore da tavolo. Collega al target utm_source=qr e utm_medium con il mezzo, assegna a tutti l'etichetta Herbstaktion e mostrami prima l'elenco.“

Dopo la tua conferma, Claude Code crea i codici. Poiché ogni mezzo pubblicitario ha un codice proprio, in seguito in Same-QR e nell'analisi web vedrai quale mezzo è stato utilizzato quante volte. I file di stampa come SVG o PDF li ottieni dalla dashboard.

Diritti e controllo

• In caso di modifiche ai codici stampati, richiedi sempre prima un elenco.
• La modifica e l'eliminazione degli obiettivi richiedono una conferma con lo stato letto, massimo 10 all'ora. Conferma solo in modo consapevole.
• Se il compito deve diventare un processo ripetibile, lascia che Claude Code scriva uno script con la sameqr-CLI.
• Revoca la chiave quando il progetto è completato.

Conclusione: perché Same-QR

Same-QR si adatta a Claude Code come uno strumento integrato: un comando per la configurazione, tutte le funzioni della dashboard come strumenti MCP, chiavi di lettura che nascondono gli strumenti di scrittura e una documentazione che un agente comprende. In ogni tariffa, anche in quella gratuita.

Inizia 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