MCP server

MCP server qr3.app poskytuje aktuálne QR a DPP nástroje pre Claude, Cursor a ďalších klientov s podporou MCP. Server beží cez HTTP s Bearer autentifikáciou.

Bezpečné pripojenie

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

Aktuálny vzdialený server používa overovanie HTTP Bearer:

Authorization: Bearer <API_KEY>

Používajte len klienta MCP, ktorý dokáže odoslať vlastnú hlavičku HTTP Authorization zo svojho bezpečného úložiska poverení. Kľúč API nikdy nezapisujte do konfiguračného súboru projektu ani do repozitára.

Claude Remote Connectors používajú OAuth. qr3 momentálne ponúka iba overovanie kľúčom Bearer, preto nie je priamo kompatibilný s týmto tokom konektora, kým sa nepridá podpora OAuth.

Discovery bez API kľúča

Klient nemusí najprv žiadať o prístupové údaje, aby zistil, čo tento server ponúka. Na nasledujúce metódy odpovedá https://mcp.qr3.app/mcp bez hlavičky Authorization:

Metóda	Vracia
`initialize`	verziu protokolu, Capabilities, názov servera
`tools/list`	všetky nástroje vrátane vstupnej schémy
`resources/list`	katalóg statických zdrojov
`resources/read`	obsah jedného zdroja
`prompts/list`	zoznam promptov
`ping`	dostupnosť

Každá metóda, ktorá sa týka Workspace, prebieha cez tools/call — a tá naďalej vyžaduje Bearer kľúč. Bez neho server odpovie s HTTP 401, application/problem+json a 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":{}}'

Pre klientov, ktorí neovládajú MCP, je rovnaký katalóg k dispozícii ako jednoduché JSON na adrese https://mcp.qr3.app/resources, jednotlivý zdroj potom na https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Dostupné nástroje

Hlavné nástroje

Nástroj	Popis
`create_qr`	Vytvoriť QR kód pre URL
`update_qr`	Zmeniť cieľovú URL, stav, tagy, poznámky alebo platnosť QR kódu
`list_qrs`	Zobraziť QR kódy s filtrom stavu a stránkovaním pomocou kurzora
`get_qr_stats`	Získať agregované štatistiky skenovania pre QR kód
`create_batch`	Vytvoriť QR kódy zo zoznamu URL (max. 50)
`create_dpp_qr`	Vytvoriť DPP QR kód pre batériu, textil alebo všeobecný produkt
`create_vcard_qr`	Vytvoriť statický vCard QR kód
`create_wifi_qr`	Vytvoriť statický WiFi QR kód
`validate_dpp`	Overiť DPP údaje bez ich vytvorenia
`get_image`	Získať adresu URL súboru PNG, SVG, PDF alebo EPS poskytnutú API
`shorten_url`	Vytvoriť dynamický QR kód pre URL a vrátiť jeho krátku URL

DPP zdroje

Server tiež poskytuje statické zdroje (Resources) pre DPP kontrakt:

URI	Obsah
`qr3://qr-types`	Šesť typov Codes API: URL, vCard, WiFi, e-mail, SMS a poloha
`qr3://error-codes`	Typy chýb a návody na riešenie
`qr3://rate-limits`	Limity požiadaviek (Rate-Limits) podľa programu
`qr3://quickstart`	Rýchly sprievodca (Quickstart)
`qr3://dpp-schema`	DPP kontrakt zameraný na batérie
`qr3://gs1-test-vectors`	Príklady GS1 resolvera
`qr3://dpp-content-negotiation-examples`	Príklady odpovedí resolvera

Príklady promptov

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