QR Suisse MCP-Server (Dokumentation)
Mit dem QR Suisse MCP-Server kann ein KI-Assistent, der das Model Context Protocol (MCP) unterstützt, die öffentliche Dokumentation von QR Suisse durchsuchen und lesen. Er ist ohne Konto und ohne API-Schlüssel zugänglich. Er gibt keinen Zugriff auf ein Konto und verändert keinen QR-Code: Er dient nur zum Nachschlagen in der Dokumentation.
Adresse des Servers
https://www.qrsuisse.ch/mcp/docs
Transport: Streamable HTTP, zustandslos (jede Anfrage ist ein eigenständiger POST, ohne Sitzung). Keine Authentifizierung.
Tools
qr_suisse_search_docs: durchsucht die öffentliche Dokumentation von QR Suisse nach Stichwörtern (Übersicht llms.txt, Hinweise für KI-Agenten, Authentifizierungsanleitung der API, Preise und eine Seite pro Operation der REST-API v1) und gibt bis zu 5 Seiten zurück, die passendste zuerst, jeweils mit Kennung, Titel, Adresse und Auszug. Parameter:query(Text, erforderlich, höchstens 200 Zeichen), Stichwörter auf Englisch.qr_suisse_get_page: gibt den vollständigen Text einer Seite dieser Dokumentation im Markdown-Format zurück, angegeben durch ihre Kennung. Parameter:page(erforderlich), eine vonqr_suisse_search_docszurückgegebene Kennung, zum Beispielauth-mdoderapi/gefolgt von der operationId einer Operation.
Ihren Client einrichten
In Claude Code:
claude mcp add --transport http qr-suisse-docs https://www.qrsuisse.ch/mcp/docsIn Visual Studio Code, Datei .vscode/mcp.json:
{
"servers": {
"qr-suisse-docs": {
"type": "http",
"url": "https://www.qrsuisse.ch/mcp/docs"
}
}
}In einem anderen MCP-fähigen Client fügen Sie einen Remote-Server vom Typ HTTP mit der obigen Adresse hinzu. Ein Schlüssel ist nicht nötig.
Grenzen
- Nur öffentliche Dokumentation, nur lesend. Der Server erstellt, ändert, liest oder löscht keine QR-Codes, keine Statistiken und kein Konto. Um Ihre QR-Codes aus Ihren eigenen Tools zu verwalten, nutzen Sie die QR Suisse API, eine REST-API für die Pläne Pro und Entreprise, mit einem API-Schlüssel. Handelt ein Agent für Sie, gelten die Hinweise für KI-Agenten (auf Englisch).
- Inhalt der öffentlichen Dokumentation. Der Server gibt eine Kopie der auf qrsuisse.ch veröffentlichten Dokumente zurück (llms.txt, agents.md, auth.md, pricing.md) sowie eine Seite pro Operation aus der OpenAPI-Spezifikation. Diese Kopie enthält keine Preise und kann einzelne Pläne auslassen: Aktuelle Preise und Pläne finden Sie unter Preise. Bei Abweichungen gelten die veröffentlichte Seite und die OpenAPI-Spezifikation.
- Sprache: Die vom Server gelieferte Dokumentation ist auf Englisch; formulieren Sie Ihre Suchanfragen auf Englisch.
- Rate-Limit: 60 Anfragen pro Minute und IP-Adresse. Darüber antwortet der Server mit dem HTTP-Fehler 429 und dem Header
Retry-After. - Anfragen: höchstens 16 KiB pro Anfrage (darüber HTTP-Fehler 413) und eine einzige JSON-RPC-Nachricht pro Anfrage. Eine Anfrage aus einer Webseite (Header
Origin) wird abgelehnt. - Daten: Der Server speichert weder den Text Ihrer Suchanfragen noch die abgerufenen Seiten noch Ihre IP-Adresse. Für das Rate-Limit wird Ihre IP-Adresse in einen nicht umkehrbaren Hashwert umgewandelt, der nur im Arbeitsspeicher des Servers gehalten wird: Er wird nach einer Minute nicht mehr berücksichtigt und nie auf einen Datenträger geschrieben. Wie bei jeder Seite von qrsuisse.ch können die technischen Protokolle unseres Webservers Ihre IP-Adresse, Datum und Uhrzeit sowie die aufgerufene Adresse enthalten, nie aber den Inhalt Ihrer Anfragen (siehe unsere Datenschutzerklärung). Geben Sie in Ihren Suchanfragen weder Personendaten noch API-Schlüssel ein.
Häufig gestellte Fragen
Braucht es ein QR-Suisse-Konto für den MCP-Server?
Nein. Der Server ist öffentlich und verlangt weder Konto noch API-Schlüssel.
Kann der QR Suisse MCP-Server QR-Codes erstellen oder ändern?
Nein. Er gibt nur Zugriff auf die öffentliche Dokumentation. Um QR-Codes aus einem Tool zu erstellen oder zu ändern, nutzen Sie die QR Suisse API (Pläne Pro und Entreprise).
Was ist der Unterschied zur QR Suisse API?
Die QR Suisse API verwaltet die QR-Codes eines Kontos, mit einem API-Schlüssel. Der MCP-Server lässt einen KI-Assistenten nur die Dokumentation dieser API und des Dienstes durchsuchen und lesen.