MCP server

qr3.app MCP server pruža najnovije QR i DPP alate za Claude, Cursor i druge klijente koji podržavaju MCP. Server radi putem HTTP-a s Bearer autentifikacijom.

Sigurna veza

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

Trenutačni udaljeni poslužitelj koristi HTTP Bearer autentikaciju:

Authorization: Bearer <API_KEY>

Koristite samo MCP klijent koji može poslati prilagođeno HTTP zaglavlje Authorization iz svoje sigurne pohrane vjerodajnica. Nikada ne spremajte API ključ u konfiguracijsku datoteku projekta ili repozitorij.

Claude Remote Connectors koristi OAuth. qr3 trenutačno nudi samo autentikaciju Bearer ključem, stoga nije izravno kompatibilan s tim tokom konektora dok se ne doda podrška za OAuth.

Discovery bez API ključa

Klijent ne mora najprije tražiti vjerodajnice da bi saznao što ovaj poslužitelj nudi. Na sljedeće metode https://mcp.qr3.app/mcp odgovara bez Authorization zaglavlja:

Metoda	Vraća
`initialize`	Verzija protokola, capabilities, naziv poslužitelja
`tools/list`	svi alati zajedno sa shemom unosa
`resources/list`	katalog statičkih resursa
`resources/read`	sadržaj pojedinačnog resursa
`prompts/list`	popis promptova
`ping`	dostupnost

Svaka metoda koja dotiče Workspace ide preko tools/call — i ona i dalje zahtijeva Bearer ključ. Bez njega poslužitelj odgovara s 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":{}}'

Za klijente koji ne govore MCP, isti katalog dostupan je kao jednostavan JSON na https://mcp.qr3.app/resources, a pojedinačni resurs na https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Dostupni alati

Temeljni alati

Alat	Opis
`create_qr`	Stvorite QR kod za URL
`update_qr`	Promijenite ciljni URL, status, oznake, bilješke ili istek QR koda
`list_qrs`	Prikažite QR kodove s filtrom statusa i paginacijom pokazivačem
`get_qr_stats`	Dohvatite agregiranu statistiku skeniranja za QR kod
`create_batch`	Stvorite QR kodove iz popisa URL-ova (najviše 50)
`create_dpp_qr`	Stvorite DPP QR kod za bateriju, tekstil ili opći proizvod
`create_vcard_qr`	Stvorite statični vCard QR kod
`create_wifi_qr`	Stvorite statični WiFi QR kod
`validate_dpp`	Provjerite DPP podatke bez njihova stvaranja
`get_image`	Dohvatite URL PNG, SVG, PDF ili EPS datoteke koji pruža API
`shorten_url`	Stvorite dinamični URL QR kod i vratite njegov kratki URL

DPP resursi

Server također pruža statičke resurse (Resources) za DPP ugovor:

URI	Sadržaj
`qr3://qr-types`	Šest tipova Codes API-ja: URL, vCard, WiFi, e-pošta, SMS i lokacija
`qr3://error-codes`	Vrste pogrešaka i savjeti za rješavanje
`qr3://rate-limits`	Ograničenja učestalosti (rate limits) na temelju paketa
`qr3://quickstart`	Vodič za brzi početak
`qr3://dpp-schema`	DPP ugovor usmjeren na baterije
`qr3://gs1-test-vectors`	Primjeri GS1 resolvera
`qr3://dpp-content-negotiation-examples`	Primjeri odgovora resolvera

Primjeri upita

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