Server MCP per codici QR: utilizzare Same-QR in Claude, ChatGPT, Cursor e Codex

Cos'è un server MCP

MCP sta per Model Context Protocol, uno standard aperto per la connessione tra assistenti IA e altri servizi. Un server MCP descrive gli strumenti di un servizio, ad esempio "creare codice" o "leggere statistiche". L'assistente vede questi strumenti e li invoca quando un compito li richiede.

Ciò che il server MCP Same-QR mette a disposizione

Il server si trova sotto https://sameqr.com/api/mcp e offre esattamente gli strumenti dell'API REST, con gli stessi nomi, verifiche e limiti tariffari:

• Interrogare l'account e il piano, affinché l'assistente sappia cosa è possibile.
• Elencare, leggere, creare, modificare, eliminare i codici QR e recuperare le relative statistiche.
• Creare, leggere, modificare, pubblicare, mettere offline ed eliminare pagine ospitate, oltre alla lista dei design.
• Leggere menù e listini prezzi da foto o PDF.
• Gestire etichette e progetti cliente e leggere richieste dai moduli di contatto.

Gli strumenti di lettura sono contrassegnati come tali, gli strumenti di cancellazione come definitivi. Chi desidera modificare gli obiettivi, disattivare o eliminare una pagina deve chiedere all'utente e inviare lo stato precedentemente letto. Tramite API e MCP, da ciò sono interessati al massimo 10 all'ora.

Due tipi di registrazione

ChatGPT e Claude.ai aggiungono il server come connettore. L'accesso avviene tramite OAuth: tu ti colleghi al browser a Same-QR e stabilisci con una spunta se l'app può solo leggere, anche creare e modificare testi o inoltre modificare e eliminare gli obiettivi.

Claude Code, Cursor e Codex si connettono con una chiave API. Tu la crei nella dashboard sotto Account, "Accesso per CLI, script e agenti", selezioni "solo lettura", "lettura + scrittura" (creare, modificare nomi e testi) o "completo" (oltre modificare obiettivi, disattivare, eliminare) e la registri come variabile d'ambiente SAMEQR_API_KEY. Una chiave con "solo lettura" ha un interessante effetto collaterale: L'assistente non vede gli strumenti di scrittura affatto.

Panoramica della configurazione

Per Claude Code è sufficiente un comando nel terminale:

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

Per Cursor una voce in ~/.cursor/mcp.json:

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

Per Codex una sezione in ~/.codex/config.toml:

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

Chi ha installato la riga di comando sameqr riceve queste informazioni in qualsiasi momento con "sameqr mcp". Testi ogni connessione prima con una domanda di lettura, ad esempio "Quali codici QR ho?".

Sicurezza e permessi

• Per gli assistenti che devono solo valutare, utilizzare una chiave con "solo lettura".
• Non scrivere mai le chiavi nei file del progetto, ma impostarle come variabile d'ambiente.
• Prima di modificare i codici stampati, fai visualizzare il piano.
• Revoca le chiavi non più necessarie nella dashboard. Sono immediatamente non valide.

Conclusione: perché Same-QR

Same-QR offre un server MCP completo invece di un manipolo di funzioni dimostrative: codici, statistiche, menù, pagine ospitate, etichette e progetti, ugualmente validi per assistenti di chat e agenti di coding. È incluso in ogni tariffa, con diritti chiari e le stesse verifiche presenti nella dashboard.

Inizi subito: ti registri 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