Serwer MCP

Serwer MCP qr3.app udostępnia aktualne narzędzia QR i DPP dla Claude, Cursor oraz innych klientów obsługujących MCP. Serwer działa przez HTTP z uwierzytelnianiem Bearer.

Bezpieczne połączenie

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

Obecny zdalny serwer używa uwierzytelniania HTTP Bearer:

Authorization: Bearer <API_KEY>

Używaj wyłącznie klienta MCP, który potrafi wysłać niestandardowy nagłówek HTTP Authorization z bezpiecznego magazynu poświadczeń. Nigdy nie umieszczaj klucza API w pliku konfiguracji projektu ani w repozytorium.

Claude Remote Connectors używają OAuth. qr3 obecnie oferuje wyłącznie uwierzytelnianie kluczem Bearer, dlatego nie jest bezpośrednio zgodny z tym przepływem konektora, dopóki nie zostanie dodana obsługa OAuth.

Discovery bez klucza API

Klient nie musi najpierw pytać o dane uwierzytelniające, aby dowiedzieć się, co oferuje ten serwer. Na poniższe metody https://mcp.qr3.app/mcp odpowiada bez nagłówka Authorization:

Metoda	Zwraca
`initialize`	wersja protokołu, capabilities, nazwa serwera
`tools/list`	wszystkie narzędzia wraz ze schematem wejściowym
`resources/list`	katalog zasobów statycznych
`resources/read`	zawartość pojedynczego zasobu
`prompts/list`	lista promptów
`ping`	dostępność

Każda metoda, która dotyczy obszaru roboczego, działa przez tools/call — i ta nadal wymaga klucza Bearer. Bez niego serwer odpowiada kodem HTTP 401, application/problem+json oraz 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":{}}'

Dla klientów, którzy nie obsługują MCP, ten sam katalog jest dostępny jako zwykły JSON pod adresem https://mcp.qr3.app/resources, a pojedynczy zasób pod adresem https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Dostępne narzędzia

Narzędzia podstawowe

Narzędzie	Opis
`create_qr`	Utworzyć kod QR dla adresu URL
`update_qr`	Zmienić docelowy URL, status, tagi, notatki lub datę wygaśnięcia kodu QR
`list_qrs`	Wyświetlić kody QR z filtrem statusu i paginacją opartą na kursorze
`get_qr_stats`	Pobrać zagregowane statystyki skanowania dla kodu QR
`create_batch`	Utworzyć kody QR z listy adresów URL (maks. 50)
`create_dpp_qr`	Utworzyć kod QR DPP dla baterii, tekstyliów lub produktu ogólnego
`create_vcard_qr`	Utworzyć statyczny kod QR vCard
`create_wifi_qr`	Utworzyć statyczny kod QR WiFi
`validate_dpp`	Zweryfikować dane DPP bez ich tworzenia
`get_image`	Pobrać udostępniony przez API adres URL pliku PNG, SVG, PDF lub EPS
`shorten_url`	Utworzyć dynamiczny kod QR URL i zwrócić jego krótki adres URL

Zasoby DPP

Serwer udostępnia również statyczne zasoby (Resources) dla kontraktu DPP:

URI	Zawartość
`qr3://qr-types`	Sześć typów Codes API: URL, vCard, WiFi, e-mail, SMS i lokalizacja
`qr3://error-codes`	Typy błędów i wskazówki dotyczące ich rozwiązywania
`qr3://rate-limits`	Limity żądań (rate limits) zależne od planu
`qr3://quickstart`	Przewodnik szybkiego startu
`qr3://dpp-schema`	Kontrakt DPP zorientowany na baterie
`qr3://gs1-test-vectors`	Przykłady resolvera GS1
`qr3://dpp-content-negotiation-examples`	Przykłady negocjacji zawartości (content negotiation) resolvera

Przykładowe prompty

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