Server MCP

Serverul MCP qr3.app oferă instrumentele actuale pentru coduri QR și DPP pentru Claude, Cursor și alți clienți compatibili cu MCP. Serverul rulează prin HTTP cu autentificare Bearer.

Conexiune securizată

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

Serverul la distanță actual folosește autentificare HTTP Bearer:

Authorization: Bearer <API_KEY>

Folosiți doar un client MCP care poate trimite un antet HTTP Authorization personalizat din magazinul său securizat de acreditări. Nu includeți niciodată o cheie API într-un fișier de configurare al proiectului sau într-un depozit.

Claude Remote Connectors folosesc OAuth. qr3 oferă în prezent doar autentificare cu cheie Bearer, astfel încât nu este compatibil direct cu acest flux de conector până la adăugarea suportului OAuth.

Descoperire fără cheie API

Un client nu trebuie să solicite mai întâi date de acces pentru a afla ce oferă acest server. https://mcp.qr3.app/mcp răspunde la următoarele metode fără antetul Authorization:

Metodă	Returnează
`initialize`	Versiunea protocolului, capabilitățile, numele serverului
`tools/list`	toate instrumentele, inclusiv schema de input
`resources/list`	catalogul de resurse statice
`resources/read`	conținutul unei singure resurse
`prompts/list`	lista de prompturi
`ping`	disponibilitatea

Orice metodă care interacționează cu un workspace rulează prin tools/call — iar aceasta solicită în continuare cheia Bearer. Fără ea, serverul răspunde cu HTTP 401, application/problem+json și 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":{}}'

Pentru clienții care nu utilizează MCP, același catalog este disponibil ca JSON simplu la https://mcp.qr3.app/resources, iar o singură resursă la https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Instrumente disponibile

Instrumente de bază

Instrument	Descriere
`create_qr`	Creează un cod QR pentru un URL
`update_qr`	Modifică URL-ul de destinație, starea, etichetele, notele sau expirarea unui cod QR
`list_qrs`	Listează codurile QR cu filtru de stare și paginare prin cursor
`get_qr_stats`	Obține statistici agregate de scanare pentru un cod QR
`create_batch`	Creează coduri QR dintr-o listă de URL-uri (maximum 50)
`create_dpp_qr`	Creează un cod QR DPP pentru o baterie, un material textil sau un produs general
`create_vcard_qr`	Creează un cod QR vCard static
`create_wifi_qr`	Creează un cod QR WiFi static
`validate_dpp`	Validează datele DPP fără a le crea
`get_image`	Obține un URL de resursă PNG, SVG, PDF sau EPS furnizat de API
`shorten_url`	Creează un cod QR URL dinamic și returnează URL-ul său scurt

Resurse DPP

De asemenea, serverul oferă resurse statice pentru contractul DPP:

URI	Conținut
`qr3://qr-types`	Cele șase tipuri Codes API: URL, vCard, WiFi, e-mail, SMS și locație
`qr3://error-codes`	Tipuri de erori și instrucțiuni de rezolvare
`qr3://rate-limits`	Limite de rată bazate pe plan
`qr3://quickstart`	Ghid de pornire rapidă
`qr3://dpp-schema`	Contract DPP centrat pe baterii
`qr3://gs1-test-vectors`	Exemple de rezolvare GS1
`qr3://dpp-content-negotiation-examples`	Exemple de răspuns ale resolverului

Exemple de prompturi

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