Claude Code und QR-Codes: Same-QR per MCP einrichten, Schritt für Schritt

Was Claude Code ist

Claude Code ist ein Coding-Agent von Anthropic. Er läuft im Terminal oder in der Entwicklungsumgebung, liest und bearbeitet Dateien und führt Befehle aus. Über MCP, das Model Context Protocol, nutzt er zusätzlich Werkzeuge anderer Dienste. Mit Same-QR verbunden, kann er Codes, Gastseiten, Speisekarten, Labels und Kundenprojekte in deinem Konto bearbeiten.

Schritt 1: API-Schlüssel anlegen

Öffne im Same-QR-Dashboard Konto und den Abschnitt „Zugang für CLI, Skripte und Agenten“. Leg einen Schlüssel an. Soll Claude Code nur auswerten, wähle „nur lesen“, dann sieht der Agent die schreibenden Werkzeuge gar nicht. Zum Anlegen wähle „lesen + schreiben“, soll er auch Ziele bestehender Codes ändern, „voll“. Der Schlüssel beginnt mit sqr_live_ und wird nur einmal angezeigt.

Schritt 2: Schlüssel als Umgebungsvariable setzen

Leg den Schlüssel in deinem Passwortmanager ab und stelle ihn als Umgebungsvariable SAMEQR_API_KEY bereit, etwa beim Start der Shell. In Projektdateien hat er nichts zu suchen.

Schritt 3: MCP-Server hinzufügen

Ein Befehl im Terminal genügt:

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

Wer die Kommandozeile sameqr installiert hat, bekommt diese Zeile auch mit „sameqr mcp“ angezeigt.

Schritt 4: Verbindung testen

Starte Claude Code und frag zuerst etwas, das nichts verändert: „Welchen Tarif habe ich bei Same-QR, und welche QR-Codes gibt es?“ Der Server empfiehlt dem Agenten, mit dieser Kontoabfrage zu beginnen, damit er die Grenzen deines Tarifs kennt.

Schritt 5: Codes für eine Kampagnenseite

Eine typische Aufgabe, wenn im Projekt eine neue Landingpage entsteht:

„Leg für die neue Seite /herbst drei dynamische QR-Codes in Same-QR an: Plakat, Flyer und Tischaufsteller. Häng an das Ziel jeweils utm_source=qr und utm_medium mit dem Medium an, gib allen das Label Herbstaktion und zeig mir vorher die Liste.“

Nach deiner Bestätigung legt Claude Code die Codes an. Weil jedes Werbemittel einen eigenen Code hat, siehst du später in Same-QR und in der Webanalyse, welches Medium wie oft genutzt wurde. Die Druckdateien als SVG oder PDF holst du aus dem Dashboard.

Rechte und Kontrolle

• Bei Änderungen an gedruckten Codes immer zuerst eine Liste anfordern.
• Ziele ändern und Löschen verlangen eine Bestätigung mit dem gelesenen Stand, höchstens 10 je Stunde. Bestätige nur bewusst.
• Soll aus der Aufgabe ein wiederholbarer Ablauf werden, lass Claude Code ein Skript mit der sameqr-CLI schreiben.
• Den Schlüssel widerrufen, wenn das Projekt abgeschlossen ist.

Fazit: Warum Same-QR

Same-QR passt zu Claude Code wie ein eingebautes Werkzeug: ein Befehl zum Einrichten, alle Funktionen des Dashboards als MCP-Werkzeuge, Leseschlüssel, die schreibende Werkzeuge ausblenden, und eine Dokumentation, die ein Agent versteht. In jedem Tarif, auch im kostenlosen.

Leg gleich los: Registriere dich kostenlos auf sameqr.com, zwei dynamische QR-Codes sind dauerhaft gratis. API, CLI und MCP-Server gibt es in jedem Tarif, die Dokumentation steht auf sameqr.com/entwickler.

Häufig gestellte Fragen