MCP-strežnik

MCP-strežnik qr3.app ponuja najnovejša orodja za QR in DPP za Claude, Cursor in druge odjemalce, ki podpirajo MCP. Strežnik deluje prek protokola HTTP z avtentikacijo Bearer.

Varna povezava

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

Trenutni oddaljeni strežnik uporablja preverjanje pristnosti HTTP Bearer:

Authorization: Bearer <API_KEY>

Uporabite le odjemalca MCP, ki lahko iz svoje varne shrambe poverilnic pošlje prilagojeno glavo HTTP Authorization. Ključa API nikoli ne zapisujte v konfiguracijsko datoteko projekta ali repozitorij.

Claude Remote Connectors uporabljajo OAuth. qr3 trenutno ponuja samo preverjanje pristnosti s ključem Bearer, zato s tem tokom connectorja ni neposredno združljiv, dokler ni dodana podpora za OAuth.

Odkrivanje brez API-ključa

Odjemalcu ni treba najprej zahtevati poverilnic, da bi ugotovil, kaj ta strežnik ponuja. Na naslednje metode https://mcp.qr3.app/mcp odgovori brez glave Authorization:

Metoda	Vrne
`initialize`	različico protokola, zmožnosti, ime strežnika
`tools/list`	vsa orodja skupaj z vhodno shemo
`resources/list`	katalog statičnih virov
`resources/read`	vsebino posameznega vira
`prompts/list`	seznam promptov
`ping`	dosegljivost

Vsaka metoda, ki se nanaša na delovni prostor, poteka prek tools/call — in ta še vedno zahteva ključ Bearer. Brez njega strežnik odgovori s HTTP 401, application/problem+json in 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":{}}'

Za odjemalce, ki ne podpirajo MCP, je isti katalog na voljo kot preprost JSON na naslovu https://mcp.qr3.app/resources, posamezen vir pa na https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Razpoložljiva orodja

Ključna orodja

Orodje	Opis
`create_qr`	Ustvari kodo QR za URL
`update_qr`	Spremeni ciljni URL, stanje, oznake, opombe ali potek veljavnosti kode QR
`list_qrs`	Prikaži kode QR s filtrom stanja in paginacijo s kazalcem
`get_qr_stats`	Pridobi agregirano statistiko skeniranja za kodo QR
`create_batch`	Ustvari kode QR s seznama URL-jev (največ 50)
`create_dpp_qr`	Ustvari kodo QR DPP za baterijo, tekstil ali splošen izdelek
`create_vcard_qr`	Ustvari statično kodo QR vCard
`create_wifi_qr`	Ustvari statično kodo QR WiFi
`validate_dpp`	Preveri podatke DPP, ne da bi jih ustvaril
`get_image`	Pridobi URL datoteke PNG, SVG, PDF ali EPS, ki ga zagotovi API
`shorten_url`	Ustvari dinamično kodo QR za URL in vrni njen kratki URL

DPP viri

Strežnik ponuja tudi statične vire za DPP-Contract:

URI	Vsebina
`qr3://qr-types`	Šest vrst Codes API: URL, vCard, WiFi, e-pošta, SMS in lokacija
`qr3://error-codes`	Vrste napak in navodila za reševanje
`qr3://rate-limits`	Omejitve porabe (Rate-Limits) glede na paket
`qr3://quickstart`	Vodnik za hiter začetek
`qr3://dpp-schema`	DPP-Contract, osredotočen na baterije
`qr3://gs1-test-vectors`	Primeri GS1-Resolverja
`qr3://dpp-content-negotiation-examples`	Primeri odgovorov Resolverja

Primeri pozivov

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