MCP-server voor QR-codes: Same-QR gebruiken in Claude, ChatGPT, Cursor en Codex

Wat een MCP-server is

MCP staat voor Model Context Protocol, een open standaard voor de verbinding tussen AI-assistenten en andere diensten. Een MCP-server beschrijft de tools van een dienst, zoals „QR-code aanmaken“ of „Statistieken lezen“. De assistent ziet die tools en roept ze aan wanneer een taak ze nodig heeft.

Wat de Same-QR-MCP-server biedt

De server staat op https://sameqr.com/api/mcp en biedt precies de tools van de REST-API, met dezelfde namen, controles en abonnementsgrenzen:

• Account en abonnement opvragen, zodat de assistent weet wat mogelijk is.
• QR-codes weergeven, lezen, aanmaken, wijzigen, verwijderen en hun statistieken ophalen.
• Gastpagina's aanmaken, lezen, wijzigen, publiceren, offline halen en verwijderen, plus de lijst met ontwerpen.
• Menukaarten en prijslijsten inlezen uit foto's of PDF.
• Labels en klantprojecten beheren en aanvragen uit contactformulieren lezen.

Tools die alleen lezen zijn als zodanig gemarkeerd, verwijdertools als definitief. Wie bestemmingen wil wijzigen, een pagina offline wil halen of wil verwijderen, moet de gebruiker om bevestiging vragen en de eerder gelezen stand meesturen. Via API en MCP zijn dat hoogstens 10 per uur.

Twee manieren om in te loggen

ChatGPT en Claude.ai voegen de server toe als connector. Het inloggen verloopt via OAuth: je meldt je in de browser aan bij Same-QR en bepaalt met een vinkje of de app alleen mag lezen, ook mag aanmaken en teksten mag wijzigen, of daarnaast ook bestemmingen mag wijzigen en verwijderen.

Claude Code, Cursor en Codex verbinden met een API-sleutel. Die maak je in het dashboard onder Account, „Toegang voor CLI, scripts en agents“, aan. Je kiest „alleen lezen“, „lezen + schrijven“ (aanmaken, namen en teksten wijzigen) of „volledig“ (daarnaast bestemmingen wijzigen, offline halen, verwijderen) en slaat hem op als omgevingsvariabele SAMEQR_API_KEY. Een sleutel met „alleen lezen“ heeft een mooi neveneffect: de assistent ziet de schrijvende tools dan helemaal niet.

Instellen in het kort

Voor Claude Code volstaat één opdracht in de terminal:

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

Voor Cursor een vermelding in ~/.cursor/mcp.json:

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

Voor Codex een sectie in ~/.codex/config.toml:

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

Wie de opdrachtregel sameqr heeft geïnstalleerd, krijgt deze gegevens op elk moment te zien met „sameqr mcp“. Test elke verbinding eerst met een vraag die alleen leest, bijvoorbeeld „Welke QR-codes heb ik?“.

Veiligheid en rechten

• Gebruik voor assistenten die alleen mogen analyseren een sleutel met „alleen lezen“.
• Schrijf sleutels nooit in projectbestanden, maar stel ze in als omgevingsvariabele.
• Laat vóór wijzigingen aan gedrukte QR-codes eerst het plan zien.
• Trek sleutels die je niet meer nodig hebt in via het dashboard. Ze zijn dan meteen ongeldig.

Conclusie: waarom Same-QR

Same-QR levert een complete MCP-server in plaats van een handjevol speelgoedfuncties: QR-codes, statistieken, menukaarten, gastpagina's, labels en projecten, voor chatassistenten en coding-agents even goed. Hij zit in elk abonnement, met duidelijke rechten en dezelfde controles als in het dashboard.

Ga meteen aan de slag: registreer je gratis op sameqr.com, 20 dynamische QR-codes zijn blijvend gratis. API, CLI en MCP-server zijn er in elk abonnement, de documentatie staat op sameqr.com/entwickler.

Veelgestelde vragen