MCP-Server für QR-Codes: Same-QR in Claude, ChatGPT, Cursor und Codex nutzen

Was ein MCP-Server ist

MCP steht für Model Context Protocol, einen offenen Standard für die Verbindung zwischen KI-Assistenten und anderen Diensten. Ein MCP-Server beschreibt die Werkzeuge eines Dienstes, etwa „Code anlegen“ oder „Statistik lesen“. Der Assistent sieht diese Werkzeuge und ruft sie auf, wenn eine Aufgabe sie braucht.

Was der Same-QR-MCP-Server bereitstellt

Der Server liegt unter https://sameqr.com/api/mcp und bietet genau die Werkzeuge der REST-API, mit denselben Namen, Prüfungen und Tarifgrenzen:

• Konto und Tarif abfragen, damit der Assistent weiß, was möglich ist.
• QR-Codes auflisten, lesen, anlegen, ändern, löschen und ihre Statistik abrufen.
• Gastseiten anlegen, lesen, ändern, veröffentlichen, offline nehmen und löschen, dazu die Liste der Designs.
• Speisekarten und Preislisten aus Fotos oder PDF einlesen.
• Labels und Kundenprojekte verwalten und Anfragen aus Kontaktformularen lesen.

Lesende Werkzeuge sind als solche gekennzeichnet, Löschwerkzeuge als endgültig. Wer Ziele ändern, eine Seite offline nehmen oder löschen will, muss den Nutzer fragen und den zuvor gelesenen Stand mitschicken. Über API und MCP gehen davon höchstens 10 je Stunde.

Zwei Arten der Anmeldung

ChatGPT und Claude.ai fügen den Server als Connector hinzu. Die Anmeldung läuft über OAuth: Du meldest dich im Browser bei Same-QR an und legst per Haken fest, ob die App nur lesen, auch anlegen und Texte ändern oder zusätzlich Ziele ändern und löschen darf.

Claude Code, Cursor und Codex verbinden sich mit einem API-Schlüssel. Du legst ihn im Dashboard unter Konto, „Zugang für CLI, Skripte und Agenten“, an, wählst „nur lesen“, „lesen + schreiben“ (anlegen, Namen und Texte ändern) oder „voll“ (zusätzlich Ziele ändern, offline nehmen, löschen) und hinterlegst ihn als Umgebungsvariable SAMEQR_API_KEY. Ein Schlüssel mit „nur lesen“ hat einen schönen Nebeneffekt: Der Assistent sieht die schreibenden Werkzeuge dann gar nicht erst.

Einrichtung im Überblick

Für Claude Code genügt ein Befehl im Terminal:

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

Für Cursor ein Eintrag in ~/.cursor/mcp.json:

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

Für Codex ein Abschnitt in ~/.codex/config.toml:

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

Wer die Kommandozeile sameqr installiert hat, bekommt diese Angaben jederzeit mit „sameqr mcp“ angezeigt. Teste jede Verbindung zuerst mit einer lesenden Frage, etwa „Welche QR-Codes habe ich?“.

Sicherheit und Rechte

• Für Assistenten, die nur auswerten sollen, einen Schlüssel mit „nur lesen“ verwenden.
• Schlüssel nie in Projektdateien schreiben, sondern als Umgebungsvariable setzen.
• Vor Änderungen an gedruckten Codes den Plan zeigen lassen.
• Nicht mehr benötigte Schlüssel im Dashboard widerrufen. Sie sind dann sofort ungültig.

Fazit: Warum Same-QR

Same-QR liefert einen vollständigen MCP-Server statt einer Handvoll Spielzeugfunktionen: Codes, Statistik, Speisekarten, Gastseiten, Labels und Projekte, für Chat-Assistenten und Coding-Agents gleichermaßen. Er ist in jedem Tarif enthalten, mit klaren Rechten und denselben Prüfungen wie im Dashboard.

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