Same-QR für Entwickler: API, MCP-Server und CLI auf einen Blick

Drei Zugänge, ein Konto

Same-QR für Entwickler heißt: Alles, was das Dashboard kann, gibt es auch als REST-API, als MCP-Server für KI-Assistenten und als Kommandozeile. Alle drei rufen dieselben Funktionen auf, mit denselben Tarifgrenzen und Prüfungen, und alle drei sind in jedem Tarif enthalten.

Der Zugang

Schlüssel legst du im Dashboard unter Konto, „Zugang für CLI, Skripte und Agenten“, an: „nur lesen“, „lesen + schreiben“ (anlegen, Namen und Texte ändern) oder „voll“ (zusätzlich Ziele ändern, offline nehmen, löschen), Laufzeit 30, 90, 180 oder 365 Tage oder bewusst unbegrenzt, bis zu 10 je Konto. Der Schlüssel beginnt mit sqr_live_, wird einmal angezeigt und gehört in die Umgebungsvariable SAMEQR_API_KEY.

Die REST-API

curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/konto
curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr

Codes, Statistik, Gastseiten, Speisekarten aus Fotos, Labels, Kundenprojekte und Anfragen. Fehler kommen einheitlich als Objekt error mit status, code und message. Die vollständige Beschreibung liegt unter /api/v1/openapi.json. Grenzen: 120 Anfragen pro Minute je Schlüssel, je Stunde 60, 300, 1.000 oder 5.000 je nach Tarif.

Der MCP-Server

Adresse https://sameqr.com/api/mcp. ChatGPT und Claude.ai fügen ihn als Connector hinzu und melden sich per OAuth an. Für Claude Code:

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

Für Cursor und Codex zeigt „sameqr mcp“ die Einträge für ~/.cursor/mcp.json und ~/.codex/config.toml. Mit einem Leseschlüssel sieht ein Agent nur die lesenden Werkzeuge.

Die CLI

npm install -g sameqr
sameqr login
sameqr qr create --name "Speisekarte" --url https://example.com/karte
sameqr seite create --vorlage speisekarte --name "Gasthof zum Löwen"
sameqr karte import karte.jpg --seite menu/gasthof-zum-loewen
sameqr seite publish menu/gasthof-zum-loewen

Ohne Abhängigkeiten, ab Node.js 18, mit --json für Skripte und eindeutigen Rückgabewerten für Fehler. „sameqr --help“ zeigt alle Befehle.

Wo du anfängst

• Kostenlos registrieren und die Mailadresse bestätigen.
• Einen Schlüssel „nur lesen“ anlegen und „sameqr whoami“ ausprobieren.
• Die Anleitungen auf sameqr.com/entwickler lesen.
• Dann den Weg wählen, der zu deinem Projekt passt.

Fazit: Warum Same-QR

Same-QR gibt Entwicklern den ganzen Dienst in die Hand, nicht nur einen Ausschnitt: API, MCP-Server und CLI mit denselben Funktionen wie das Dashboard, sorgfältigem Umgang mit Schlüsseln und offen dokumentierten Grenzen. Zwei dynamische Codes sind dauerhaft gratis, zum Ausprobieren genügt das.

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