Server MCP

Il server MCP di qr3.app fornisce gli strumenti QR e DPP aggiornati per Claude, Cursor e altri client compatibili con MCP. Il server funziona tramite HTTP con autenticazione Bearer.

Connessione sicura

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

L’attuale server remoto usa l’autenticazione HTTP Bearer:

Authorization: Bearer <API_KEY>

Usa solo un client MCP che possa inviare un’intestazione HTTP Authorization personalizzata dal proprio archivio sicuro delle credenziali. Non inserire mai una chiave API in un file di configurazione del progetto o in un repository.

I connettori remoti di Claude usano OAuth. qr3 offre attualmente solo l’autenticazione con chiave Bearer, quindi non è direttamente compatibile con quel flusso del connettore finché non verrà aggiunto il supporto OAuth.

Discovery senza chiave API

Un client non deve prima richiedere le credenziali di accesso per scoprire cosa offre questo server. Il server risponde ai seguenti metodi all’indirizzo https://mcp.qr3.app/mcp senza l’header Authorization:

Metodo	Restituisce
`initialize`	Versione del protocollo, capabilities, nome del server
`tools/list`	tutti gli strumenti con il relativo schema di input
`resources/list`	il catalogo delle risorse statiche
`resources/read`	il contenuto di una singola risorsa
`prompts/list`	l’elenco dei prompt
`ping`	raggiungibilità

Qualsiasi metodo che interessi un workspace passa attraverso tools/call — e questo richiede ancora la chiave Bearer. Senza di essa, il server risponde con HTTP 401, application/problem+json e 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":{}}'

Per i client che non supportano MCP, lo stesso catalogo è disponibile come semplice JSON all’indirizzo https://mcp.qr3.app/resources, mentre una singola risorsa è disponibile all’indirizzo https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Strumenti disponibili

Strumenti principali

Strumento	Descrizione
`create_qr`	Creare un codice QR per un URL
`update_qr`	Modificare URL di destinazione, stato, tag, note o scadenza di un codice QR
`list_qrs`	Elencare i codici QR con filtro per stato e paginazione tramite cursore
`get_qr_stats`	Ottenere statistiche di scansione aggregate per un codice QR
`create_batch`	Creare codici QR da un elenco di URL (massimo 50)
`create_dpp_qr`	Creare un codice QR DPP per una batteria, un tessile o un prodotto generico
`create_vcard_qr`	Creare un codice QR vCard statico
`create_wifi_qr`	Creare un codice QR WiFi statico
`validate_dpp`	Convalidare i dati DPP senza crearli
`get_image`	Ottenere un URL di risorsa PNG, SVG, PDF o EPS fornito dall’API
`shorten_url`	Creare un codice QR URL dinamico e restituirne l’URL breve

Risorse DPP

Il server fornisce inoltre risorse statiche per il contratto DPP:

URI	Contenuto
`qr3://qr-types`	I sei tipi della Codes API: URL, vCard, WiFi, e-mail, SMS e posizione
`qr3://error-codes`	Tipi di errore e suggerimenti per la risoluzione
`qr3://rate-limits`	Limiti di frequenza basati sul piano
`qr3://quickstart`	Guida rapida
`qr3://dpp-schema`	Contratto DPP incentrato sulle batterie
`qr3://gs1-test-vectors`	Esempi di resolver GS1
`qr3://dpp-content-negotiation-examples`	Esempi di negoziazione del contenuto del resolver

Prompt di esempio

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