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.
Anwendungsbeispiel: QR-Codes aus einer Software oder einem KI-Agenten erstellen, mit der API.
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.