MCP server

MCP server qr3.app poskytuje aktuální nástroje pro QR a DPP pro Claude, Cursor a další klienty s podporou MCP. Server běží přes HTTP s ověřováním Bearer.

Zabezpečené připojení

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

Aktuální vzdálený server používá autentizaci HTTP Bearer:

Authorization: Bearer <API_KEY>

Používejte jen MCP klienta, který umí odeslat vlastní hlavičku HTTP Authorization ze svého bezpečného úložiště přihlašovacích údajů. Klíč API nikdy neukládejte do konfiguračního souboru projektu ani do repozitáře.

Claude Remote Connectors používají OAuth. qr3 nyní nabízí pouze autentizaci klíčem Bearer, takže s tímto tokem konektoru nebude přímo kompatibilní, dokud nepřidáme podporu OAuth.

Discovery bez API klíče

Klient nemusí nejprve žádat o přihlašovací údaje, aby zjistil, co tento server nabízí. Na následující metody odpovídá https://mcp.qr3.app/mcp bez hlavičky Authorization:

Metoda	Vrací
`initialize`	Verze protokolu, capabilities, název serveru
`tools/list`	všechny nástroje včetně vstupního schématu
`resources/list`	katalog statických zdrojů
`resources/read`	obsah jednoho zdroje
`prompts/list`	seznam promptů
`ping`	dostupnost

Každá metoda, která se dotýká Workspace, probíhá přes tools/call — a ta i nadále vyžaduje Bearer klíč. Bez něj server odpoví 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":{}}'

Pro klienty, kteří nepodporují MCP, je stejný katalog k dispozici jako jednoduché JSON na adrese https://mcp.qr3.app/resources, jednotlivý zdroj pak na https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Dostupné nástroje

Hlavní nástroje

Nástroj	Popis
`create_qr`	Vytvořit QR kód pro URL
`update_qr`	Změnit cílovou URL, stav, štítky, poznámky nebo expiraci QR kódu
`list_qrs`	Zobrazit QR kódy s filtrem stavu a stránkováním pomocí kurzoru
`get_qr_stats`	Získat agregované statistiky skenování pro QR kód
`create_batch`	Vytvořit QR kódy ze seznamu URL (max. 50)
`create_dpp_qr`	Vytvořit DPP QR kód pro baterii, textil nebo obecný produkt
`create_vcard_qr`	Vytvořit statický vCard QR kód
`create_wifi_qr`	Vytvořit statický WiFi QR kód
`validate_dpp`	Ověřit DPP data bez jejich vytvoření
`get_image`	Získat adresu URL souboru PNG, SVG, PDF nebo EPS poskytnutou API
`shorten_url`	Vytvořit dynamický QR kód pro URL a vrátit jeho krátkou URL

DPP zdroje

Server také poskytuje statické zdroje (Resources) pro DPP kontrakt:

URI	Obsah
`qr3://qr-types`	Šest typů Codes API: URL, vCard, WiFi, e-mail, SMS a poloha
`qr3://error-codes`	Typy chyb a návody k řešení
`qr3://rate-limits`	Limity požadavků (rate-limits) podle tarifu
`qr3://quickstart`	Rychlý průvodce (Quickstart)
`qr3://dpp-schema`	DPP kontrakt zaměřený na baterie
`qr3://gs1-test-vectors`	Příklady GS1 resolveru
`qr3://dpp-content-negotiation-examples`	Příklady odpovědí resolveru

Příklady promptů

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