MCP serveris

qr3.app MCP serveris teikia naujausius QR ir DPP įrankius, skirtus Claude, Cursor ir kitiems MCP palaikantiems klientams. Serveris veikia per HTTP su Bearer autentifikavimu.

Saugus ryšys

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

Dabartinis nuotolinis serveris naudoja HTTP Bearer autentifikavimą:

Authorization: Bearer <API_KEY>

Naudokite tik MCP klientą, galintį iš saugios prisijungimo duomenų saugyklos išsiųsti pasirinktinę HTTP antraštę Authorization. Niekada neįrašykite API rakto į projekto konfigūracijos failą ar repozitoriją.

Claude nuotolinės jungtys naudoja OAuth. qr3 šiuo metu siūlo tik Bearer rakto autentifikavimą, todėl iki OAuth palaikymo įdiegimo jis nėra tiesiogiai suderinamas su šiuo jungties srautu.

Discovery be API rakto

Klientui nereikia iš pradžių prašyti prisijungimo duomenų, kad sužinotų, ką siūlo šis serveris. Į šiuos metodus https://mcp.qr3.app/mcp atsako be Authorization antraštės:

Metodas	Grąžina
`initialize`	protokolo versiją, capabilities, serverio pavadinimą
`tools/list`	visus įrankius kartu su įvesties schema
`resources/list`	statinių išteklių katalogą
`resources/read`	vieno ištekliaus turinį
`prompts/list`	prompts sąrašą
`ping`	pasiekiamumą

Kiekvienas metodas, kuris paliečia darbo sritį (workspace), veikia per tools/call — ir jam vis tiek reikalingas Bearer raktas. Be jo serveris atsako su HTTP 401, application/problem+json ir 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":{}}'

Klientams, kurie nepalaiko MCP, tas pats katalogas yra prieinamas kaip paprastas JSON adresu https://mcp.qr3.app/resources, o atskiras išteklius – adresu https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Prieinami įrankiai

Pagrindiniai įrankiai

Įrankis	Aprašymas
`create_qr`	Sukurti URL QR kodą
`update_qr`	Pakeisti QR kodo tikslo URL, būseną, žymas, pastabas arba galiojimo laiką
`list_qrs`	Išvardyti QR kodus su būsenos filtru ir žymeklio puslapiavimu
`get_qr_stats`	Gauti apibendrintą QR kodo nuskaitymo statistiką
`create_batch`	Sukurti QR kodus iš URL sąrašo (ne daugiau kaip 50)
`create_dpp_qr`	Sukurti DPP QR kodą baterijai, tekstilei arba bendram gaminiui
`create_vcard_qr`	Sukurti statinį vCard QR kodą
`create_wifi_qr`	Sukurti statinį WiFi QR kodą
`validate_dpp`	Patikrinti DPP duomenis jų nesukuriant
`get_image`	Gauti API pateiktą PNG, SVG, PDF arba EPS failo URL
`shorten_url`	Sukurti dinaminį URL QR kodą ir grąžinti jo trumpąjį URL

DPP ištekliai

Serveris taip pat teikia statinius išteklius (Resources), skirtus DPP kontraktui:

URI	Turinys
`qr3://qr-types`	Šeši Codes API tipai: URL, vCard, WiFi, el. paštas, SMS ir vieta
`qr3://error-codes`	Klaidų tipai ir sprendimo būdai
`qr3://rate-limits`	Planu pagrįsti užklausų ribojimai (rate limits)
`qr3://quickstart`	Greitojo starto gidas
`qr3://dpp-schema`	Į baterijas orientuotas DPP kontraktas
`qr3://gs1-test-vectors`	GS1 resolver pavyzdžiai
`qr3://dpp-content-negotiation-examples`	Resolver atsakymų pavyzdžiai

Užklausų pavyzdžiai

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