Server MCP QR Suisse (documentazione)
Il server MCP QR Suisse permette a un assistente IA compatibile con il Model Context Protocol (MCP) di cercare e leggere la documentazione pubblica di QR Suisse. È accessibile senza account né chiave API. Non dà accesso ad alcun account e non agisce su alcun codice QR: serve solo a consultare la documentazione.
Indirizzo del server
https://www.qrsuisse.ch/mcp/docs
Trasporto: Streamable HTTP, senza stato (ogni richiesta è un POST indipendente, senza sessione). Nessuna autenticazione.
Strumenti
qr_suisse_search_docs: cerca per parole chiave nella documentazione pubblica di QR Suisse (presentazione llms.txt, istruzioni per gli agenti IA, guida all'autenticazione dell'API, prezzi e una pagina per ogni operazione dell'API REST v1) e restituisce fino a 5 pagine, la più pertinente per prima, ciascuna con identificativo, titolo, indirizzo e un estratto. Parametro:query(testo, obbligatorio, al massimo 200 caratteri), parole chiave in inglese.qr_suisse_get_page: restituisce il testo completo di una pagina di questa documentazione, in Markdown, indicata tramite il suo identificativo. Parametro:page(obbligatorio), un identificativo restituito daqr_suisse_search_docs, per esempioauth-mdoppureapi/seguito dall'operationId di un'operazione.
Configurare il Suo client
In Claude Code:
claude mcp add --transport http qr-suisse-docs https://www.qrsuisse.ch/mcp/docsIn Visual Studio Code, file .vscode/mcp.json:
{
"servers": {
"qr-suisse-docs": {
"type": "http",
"url": "https://www.qrsuisse.ch/mcp/docs"
}
}
}In un altro client compatibile con MCP, aggiunga un server remoto di tipo HTTP con l'indirizzo qui sopra. Non serve alcuna chiave.
Limiti
- Solo documentazione pubblica, in sola lettura. Il server non crea, modifica, legge né elimina alcun codice QR, alcuna statistica e alcun account. Per gestire i Suoi codici QR dai Suoi strumenti, utilizzi la QR Suisse API, un'API REST disponibile con i piani Pro ed Entreprise, con una chiave API. Se un agente agisce per Suo conto, si applicano le istruzioni per gli agenti IA (in inglese).
- Contenuto della documentazione pubblica. Il server restituisce una copia dei documenti pubblicati su qrsuisse.ch (llms.txt, agents.md, auth.md, pricing.md) e una pagina per ogni operazione tratta dalla specifica OpenAPI. Questa copia non contiene i prezzi e può omettere alcuni piani: per prezzi e piani aggiornati, consulti i nostri prezzi. In caso di differenze, fanno fede la pagina pubblicata e la specifica OpenAPI.
- Lingua: la documentazione restituita dal server è in inglese; formuli le ricerche in inglese.
- Limite di frequenza: 60 richieste al minuto per indirizzo IP. Oltre questo limite, il server risponde con un errore HTTP 429 e l'intestazione
Retry-After. - Richieste: al massimo 16 KiB per richiesta (errore HTTP 413 oltre questo limite) e un solo messaggio JSON-RPC per richiesta. Una richiesta inviata da una pagina web (intestazione
Origin) viene rifiutata. - Dati: il server non registra né il testo delle Sue ricerche, né le pagine richieste, né il Suo indirizzo IP. Per il limite di frequenza, il Suo indirizzo IP viene trasformato in un'impronta non reversibile, conservata solo nella memoria del server: dopo un minuto non viene più presa in considerazione e non viene mai scritta su disco. Come per ogni pagina di qrsuisse.ch, i log tecnici del nostro server web possono contenere il Suo indirizzo IP, la data e l'ora e l'indirizzo richiesto, mai il contenuto delle Sue richieste (consulti la nostra informativa sulla privacy). Non inserisca nelle ricerche dati personali né chiavi API.
Domande frequenti
Serve un account QR Suisse per usare il server MCP?
No. Il server è pubblico e non richiede né account né chiave API.
Il server MCP QR Suisse può creare o modificare codici QR?
No. Dà accesso solo alla documentazione pubblica. Per creare o modificare codici QR da uno strumento, utilizzi la QR Suisse API (piani Pro ed Entreprise).
Che differenza c'è con la QR Suisse API?
La QR Suisse API agisce sui codici QR di un account, con una chiave API. Il server MCP permette solo a un assistente IA di cercare e leggere la documentazione di questa API e del servizio.