MCP-szerver

A qr3.app MCP-szerver biztosítja a legújabb QR- és DPP-eszközöket Claude, Cursor és más MCP-képes kliensek számára. A szerver HTTP-n keresztül fut Bearer hitelesítéssel.

Biztonságos kapcsolat

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

A jelenlegi távoli szerver HTTP Bearer-hitelesítést használ:

Authorization: Bearer <API_KEY>

Csak olyan MCP-klienst használjon, amely biztonságos hitelesítőadat-tárolójából egyedi HTTP Authorization fejlécet tud küldeni. API-kulcsot soha ne helyezzen projektkonfigurációs fájlba vagy repozitóriumba.

A Claude Remote Connectors OAuthot használ. A qr3 jelenleg csak Bearer-kulcsos hitelesítést kínál, így az OAuth-támogatás hozzáadásáig nem közvetlenül kompatibilis ezzel a connector-folyamattal.

Felfedezés API-kulcs nélkül

Egy kliensnek nem kell először hozzáférési adatokat kérnie ahhoz, hogy megtudja, mit kínál ez a szerver. A következő metódusokra a https://mcp.qr3.app/mcp Authorization fejléc nélkül is válaszol:

Metódus	Visszaadott adat
`initialize`	Protokollverzió, Capabilities, szervernév
`tools/list`	az összes eszköz a bemeneti sémával együtt
`resources/list`	a statikus erőforrások katalógusa
`resources/read`	egy egyedi erőforrás tartalma
`prompts/list`	a prompt-lista
`ping`	elérhetőség

Minden olyan metódus, amely érint egy Workspace-t, a tools/call metóduson keresztül fut — és ez továbbra is megköveteli a Bearer-kulcsot. Enélkül a szerver HTTP 401 hibával, application/problem+json tartalommal és WWW-Authenticate: Bearer realm="qr3.app" fejléccel válaszol.

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":{}}'

Azon kliensek számára, amelyek nem támogatják az MCP protokollt, ugyanez a katalógus egyszerű JSON formátumban érhető el a https://mcp.qr3.app/resources címen, egy egyedi erőforrás pedig a https://mcp.qr3.app/resources/<uri-ohne-qr3://> címen.

Elérhető eszközök

Alapeszközök

Eszköz	Leírás
`create_qr`	QR-kód létrehozása URL-hez
`update_qr`	QR-kód cél-URL-jének, állapotának, címkéinek, jegyzeteinek vagy lejáratának módosítása
`list_qrs`	QR-kódok listázása állapotszűrővel és kurzoros lapozással
`get_qr_stats`	Összesített beolvasási statisztikák lekérése egy QR-kódhoz
`create_batch`	QR-kódok létrehozása URL-listából (legfeljebb 50)
`create_dpp_qr`	DPP QR-kód létrehozása akkumulátorhoz, textilhez vagy általános termékhez
`create_vcard_qr`	Statikus vCard QR-kód létrehozása
`create_wifi_qr`	Statikus WiFi QR-kód létrehozása
`validate_dpp`	DPP-adatok ellenőrzése létrehozás nélkül
`get_image`	Az API által biztosított PNG-, SVG-, PDF- vagy EPS-fájl URL-jének lekérése
`shorten_url`	Dinamikus URL QR-kód létrehozása és rövid URL-jének visszaadása

DPP-erőforrások

A szerver statikus erőforrásokat (Resources) is biztosít a DPP-szerződéshez (DPP-Contract):

URI	Tartalom
`qr3://qr-types`	A Codes API hat típusa: URL, vCard, WiFi, e-mail, SMS és helyszín
`qr3://error-codes`	Hibatípusok és megoldási javaslatok
`qr3://rate-limits`	Csomagalapú sebességkorlátok (rate limits)
`qr3://quickstart`	Gyorsútmutató
`qr3://dpp-schema`	Akkumulátor-központú DPP-szerződés (DPP-Contract)
`qr3://gs1-test-vectors`	GS1 Resolver példák
`qr3://dpp-content-negotiation-examples`	A Resolver válaszpéldái

Példa promptok

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