Serveur MCP QR Suisse (documentation)
Le serveur MCP QR Suisse permet à un assistant IA compatible avec le Model Context Protocol (MCP) de chercher et de lire la documentation publique de QR Suisse. Il est accessible sans compte ni clé API. Il ne donne accès à aucun compte et n'agit sur aucun QR code : il sert uniquement à consulter la documentation.
Adresse du serveur
https://www.qrsuisse.ch/mcp/docs
Transport : Streamable HTTP, sans état (chaque requête est un POST indépendant, sans session). Aucune authentification.
Outils
qr_suisse_search_docs: cherche par mots-clés dans la documentation publique de QR Suisse (présentation llms.txt, consignes pour les agents IA, guide d'authentification de l'API, tarifs et une page par opération de l'API REST v1) et renvoie jusqu'à 5 pages, la plus pertinente d'abord, chacune avec son identifiant, son titre, son adresse et un extrait. Paramètre :query(texte, obligatoire, 200 caractères au maximum), des mots-clés en anglais.qr_suisse_get_page: renvoie le texte complet d'une page de cette documentation, en Markdown, désignée par son identifiant. Paramètre :page(obligatoire), un identifiant renvoyé parqr_suisse_search_docs, par exempleauth-mdouapi/suivi de l'operationId d'une opération.
Configurer votre client
Dans Claude Code :
claude mcp add --transport http qr-suisse-docs https://www.qrsuisse.ch/mcp/docsDans Visual Studio Code, fichier .vscode/mcp.json :
{
"servers": {
"qr-suisse-docs": {
"type": "http",
"url": "https://www.qrsuisse.ch/mcp/docs"
}
}
}Dans un autre client compatible MCP, ajoutez un serveur distant de type HTTP avec l'adresse ci-dessus. Aucune clé n'est à saisir.
Limites
- Documentation publique seulement, en lecture. Le serveur ne crée, ne modifie, ne lit ni ne supprime aucun QR code, aucune statistique et aucun compte. Pour agir sur vos QR codes depuis vos outils, utilisez la QR Suisse API, une API REST réservée aux plans Pro et Entreprise, avec une clé API. Si un agent agit pour vous, les consignes pour les agents IA (en anglais) s'appliquent.
- Contenu de la documentation publique. Le serveur renvoie une copie des documents publiés sur qrsuisse.ch (llms.txt, agents.md, auth.md, pricing.md) et une page par opération tirée de la spécification OpenAPI. Cette copie ne contient pas les prix et peut omettre certains plans : pour les tarifs et les plans à jour, consultez nos tarifs. En cas d'écart, la page publiée et la spécification OpenAPI font foi.
- Langue : la documentation renvoyée par le serveur est en anglais ; formulez vos recherches en anglais.
- Limite de débit : 60 requêtes par minute et par adresse IP. Au-delà, le serveur répond par une erreur HTTP 429 avec l'en-tête
Retry-After. - Requêtes : 16 Kio au maximum par requête (erreur HTTP 413 au-delà) et un seul message JSON-RPC par requête. Une requête envoyée depuis une page web (en-tête
Origin) est refusée. - Données : le serveur n'enregistre ni le texte de vos recherches, ni les pages demandées, ni votre adresse IP. Pour la limite de débit, votre adresse IP est transformée en une empreinte non réversible, gardée uniquement en mémoire du serveur : elle cesse d'être prise en compte après une minute et n'est jamais écrite sur disque. Comme pour toute page de qrsuisse.ch, les journaux techniques de notre serveur web peuvent contenir votre adresse IP, la date et l'adresse appelée, jamais le contenu de vos requêtes (voir notre politique de confidentialité). N'indiquez dans vos recherches ni données personnelles ni clé API.
Questions fréquentes
Faut-il un compte QR Suisse pour utiliser le serveur MCP ?
Non. Le serveur est public et ne demande ni compte ni clé API.
Le serveur MCP QR Suisse peut-il créer ou modifier des QR codes ?
Non. Il ne donne accès qu'à la documentation publique. Pour créer ou modifier des QR codes depuis un outil, utilisez la QR Suisse API (plans Pro et Entreprise).
Quelle différence avec la QR Suisse API ?
La QR Suisse API agit sur les QR codes d'un compte, avec une clé API. Le serveur MCP permet seulement à un assistant IA de chercher et de lire la documentation de cette API et du service.