MCP-server

qr3.app MCP-server pakub kaasaegseid QR- ja DPP-tööriistu Claude, Cursori ja muude MCP-toega klientide jaoks. Server töötab üle HTTP koos Bearer-autentimisega.

Turvaline ühendus

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

Praegune kaugserver kasutab HTTP Bearer-autentimist:

Authorization: Bearer <API_KEY>

Kasuta ainult MCP-klienti, mis saab saata kohandatud HTTP-päise Authorization oma turvalisest mandaadihoidlast. Ära kunagi lisa API-võtit projekti seadistusfaili ega repositooriumi.

Claude’i kaugühendused kasutavad OAuthi. qr3 pakub praegu ainult Bearer-võtme autentimist ega ühildu seetõttu selle ühenduse vooga otseselt enne OAuthi toe lisamist.

Discovery ilma API-võtmeta

Klient ei pea esmalt küsima sisselogimisandmeid, et teada saada, mida see server pakub. Järgmistele meetoditele vastab https://mcp.qr3.app/mcp ilma Authorization-päiseta:

Meetod	Tagastab
`initialize`	Protokolli versioon, Capabilities, serveri nimi
`tools/list`	kõik tööriistad koos sisendskeemiga
`resources/list`	staatiliste ressursside kataloog
`resources/read`	üksiku ressursi sisu
`prompts/list`	promptide loend
`ping`	kättesaadavus

Iga meetod, mis puudutab Workspace’i, käib läbi tools/call — ja see nõuab endiselt Bearer-võtit. Ilma selleta vastab server koodiga HTTP 401, application/problem+json ja 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":{}}'

Klientide jaoks, mis ei toeta MCP-d, on sama kataloog saadaval lihtsa JSON-ina aadressil https://mcp.qr3.app/resources, ning üksik ressurss aadressil https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Saadaolevad tööriistad

Põhitööriistad

Tööriist	Kirjeldus
`create_qr`	URL-i jaoks QR-koodi loomine
`update_qr`	QR-koodi sihtkoha URL-i, staatuse, siltide, märkmete või aegumise muutmine
`list_qrs`	QR-koodide loetlemine staatusefiltri ja kursoripõhise lehekülgjaotusega
`get_qr_stats`	QR-koodi skannimise koondstatistika hankimine
`create_batch`	QR-koodide loomine URL-ide loendist (max 50)
`create_dpp_qr`	DPP QR-koodi loomine akule, tekstiilile või üldisele tootele
`create_vcard_qr`	Staatilise vCardi QR-koodi loomine
`create_wifi_qr`	Staatilise WiFi QR-koodi loomine
`validate_dpp`	DPP andmete valideerimine ilma neid loomata
`get_image`	API pakutud PNG-, SVG-, PDF- või EPS-faili URL-i hankimine
`shorten_url`	Dünaamilise URL-i QR-koodi loomine ja selle lühikese URL-i tagastamine

DPP-ressursid

Server pakub lisaks staatilisi ressursse (Resources) DPP-lepingu (DPP-Contract) jaoks:

URI	Sisu
`qr3://qr-types`	Codes API kuus tüüpi: URL, vCard, WiFi, e-post, SMS ja asukoht
`qr3://error-codes`	Veatüübid ja lahendusjuhised
`qr3://rate-limits`	Paketipõhised päringupiirangud (rate-limits)
`qr3://quickstart`	Kiirjuhend
`qr3://dpp-schema`	Akukeskne DPP-leping (DPP-Contract)
`qr3://gs1-test-vectors`	GS1-resolveri näited
`qr3://dpp-content-negotiation-examples`	Resolveri vastuste näited

Näidisviiped

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