MCP-Server

Der qr3.app MCP-Server stellt die aktuellen QR- und DPP-Tools für Claude, Cursor und andere MCP-fähige Clients bereit. Der Server läuft über HTTP mit Bearer-Authentifizierung.

Sichere Verbindung

Endpoint: https://mcp.qr3.app/mcp

Der aktuelle Remote-Server verwendet HTTP-Bearer-Authentifizierung:

Authorization: Bearer <API_KEY>

Verwende nur einen MCP-Client, der einen benutzerdefinierten HTTP-Header Authorization aus einem sicheren Credential Store senden kann. API-Keys dürfen niemals in einer Projekt-Konfigurationsdatei oder einem Repository landen.

Claude Remote Connectors verwenden OAuth. qr3 bietet derzeit ausschließlich Bearer-Key-Authentifizierung und ist daher bis zur OAuth-Unterstützung nicht direkt mit diesem Connector-Flow kompatibel.

Discovery ohne API-Key

Ein Client muss nicht erst nach Zugangsdaten fragen, um herauszufinden, was dieser Server anbietet. Die folgenden Methoden beantwortet https://mcp.qr3.app/mcp ohne Authorization-Header:

Methode	Liefert
`initialize`	Protokollversion, Capabilities, Servername
`tools/list`	alle Werkzeuge samt Eingabeschema
`resources/list`	den Katalog der statischen Ressourcen
`resources/read`	den Inhalt einer einzelnen Ressource
`prompts/list`	die Prompt-Liste
`ping`	Erreichbarkeit

Jede Methode, die einen Workspace berührt, läuft über tools/call — und die verlangt den Bearer-Key weiterhin. Ohne ihn antwortet der Server mit HTTP 401, application/problem+json und WWW-Authenticate: Bearer realm="qr3.app".

curl -s https://mcp.qr3.app/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"resources/list","params":{}}'

Für Clients, die kein MCP sprechen, liegt derselbe Katalog als einfaches JSON unter https://mcp.qr3.app/resources, eine einzelne Ressource unter https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Verfügbare Tools

Kern-Tools

Tool	Beschreibung
`create_qr`	QR-Code für eine URL erstellen
`update_qr`	Ziel-URL, Status, Tags, Notizen oder Ablauf eines QR-Codes ändern
`list_qrs`	QR-Codes mit Statusfilter und Cursor-Paginierung auflisten
`get_qr_stats`	Aggregierte Scan-Statistiken für einen QR-Code abrufen
`create_batch`	QR-Codes aus einer URL-Liste erstellen (max. 50)
`create_dpp_qr`	DPP-QR-Code für eine Batterie, ein Textil oder ein allgemeines Produkt erstellen
`create_vcard_qr`	Statischen vCard-QR-Code erstellen
`create_wifi_qr`	Statischen WiFi-QR-Code erstellen
`validate_dpp`	DPP-Daten prüfen, ohne sie anzulegen
`get_image`	Eine von der API bereitgestellte PNG-, SVG-, PDF- oder EPS-URL abrufen
`shorten_url`	Dynamischen URL-QR-Code erstellen und seine Kurz-URL zurückgeben

DPP-Ressourcen

Der Server stellt außerdem statische Resources für den DPP-Contract bereit:

URI	Inhalt
`qr3://qr-types`	Die sechs Typen der Codes API: URL, vCard, WiFi, E-Mail, SMS und Standort
`qr3://error-codes`	Fehlertypen und Lösungshinweise
`qr3://rate-limits`	Planbasierte Rate-Limits
`qr3://quickstart`	Schnellstart-Guide
`qr3://dpp-schema`	Batterie-zentrierter DPP-Contract
`qr3://gs1-test-vectors`	GS1-Resolver-Beispiele
`qr3://dpp-content-negotiation-examples`	Antwortbeispiele des Resolvers

Beispiel-Prompts

Erstelle einen QR-Code für https://example.com

Zeige mir die Scan-Statistiken für qr_abc123

Erstelle einen Batterie-DPP mit GTIN 04012345678901 und den Pflichtfeldern