Claude Code en QR-codes: Same-QR instellen via MCP, stap voor stap

Wat Claude Code is

Claude Code is een coding agent van Anthropic. Hij draait in de terminal of in de ontwikkelomgeving, leest en bewerkt bestanden en voert commando's uit. Via MCP, het Model Context Protocol, gebruikt hij daarnaast hulpmiddelen van andere diensten. Gekoppeld aan Same-QR kan hij QR-codes, gastpagina's, menukaarten, labels en klantprojecten in je account bewerken.

Stap 1: API-sleutel aanmaken

Open in het Same-QR-dashboard Account en het onderdeel „Toegang voor CLI, scripts en agents“. Maak een sleutel aan. Moet Claude Code alleen analyseren, kies dan „alleen lezen“, dan ziet de agent de schrijvende hulpmiddelen helemaal niet. Kies voor het aanmaken „lezen + schrijven“, en „volledig“ als hij ook de bestemmingen van bestaande QR-codes mag wijzigen. De sleutel begint met sqr_live_ en wordt maar één keer getoond.

Stap 2: sleutel instellen als omgevingsvariabele

Bewaar de sleutel in je wachtwoordmanager en maak hem beschikbaar als omgevingsvariabele SAMEQR_API_KEY, bijvoorbeeld bij het starten van de shell. In projectbestanden hoort hij niet thuis.

Stap 3: MCP-server toevoegen

Eén commando in de terminal volstaat:

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

Heb je de opdrachtregeltool sameqr geïnstalleerd, dan krijg je deze regel ook te zien met „sameqr mcp“.

Stap 4: verbinding testen

Start Claude Code en vraag eerst iets wat niets verandert: „Welk tarief heb ik bij Same-QR en welke QR-codes zijn er?“ De server raadt de agent aan met deze accountvraag te beginnen, zodat hij de grenzen van jouw tarief kent.

Stap 5: QR-codes voor een campagnepagina

Een typische taak wanneer er in het project een nieuwe landingspagina ontstaat:

„Maak voor de nieuwe pagina /herfst drie dynamische QR-codes aan in Same-QR: poster, flyer en tafelstandaard. Voeg aan de bestemming telkens utm_source=qr en utm_medium met het medium toe, geef ze allemaal het label Herfstactie en laat me eerst de lijst zien.“

Na jouw bevestiging maakt Claude Code de QR-codes aan. Omdat elk reclamemiddel een eigen QR-code heeft, zie je later in Same-QR en in de webanalyse welk medium hoe vaak is gebruikt. De drukbestanden als SVG of PDF haal je uit het dashboard.

Rechten en controle

• Vraag bij wijzigingen aan gedrukte QR-codes altijd eerst om een lijst.
• Bestemmingen wijzigen en verwijderen vragen om een bevestiging met de gelezen stand, maximaal 10 per uur. Bevestig alleen bewust.
• Moet de taak een herhaalbare workflow worden, laat Claude Code dan een script schrijven met de sameqr-CLI.
• Trek de sleutel in zodra het project is afgerond.

Conclusie: waarom Same-QR

Same-QR past bij Claude Code als een ingebouwd hulpmiddel: één commando om in te stellen, alle functies van het dashboard als MCP-hulpmiddelen, leessleutels die schrijvende hulpmiddelen verbergen en documentatie die een agent begrijpt. In elk tarief, ook het gratis tarief.

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 tarief, de documentatie staat op sameqr.com/entwickler.

Veelgestelde vragen