Gå til indhold

MCP-server

MCP-server

qr3.app MCP-serveren stiller de aktuelle QR- og DPP-værktøjer til rådighed for Claude, Cursor og andre MCP-kompatible klienter. Serveren kører over HTTP med Bearer-autentificering.

Sikker forbindelse

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

Den aktuelle fjernserver bruger HTTP Bearer-godkendelse:

Authorization: Bearer <API_KEY>

Brug kun en MCP-klient, der kan sende en brugerdefineret HTTP-header Authorization fra sit sikre credential-lager. Gem aldrig en API-nøgle i en projektkonfigurationsfil eller et repository.

Claude Remote Connectors bruger OAuth. qr3 tilbyder i øjeblikket kun Bearer-key-godkendelse og er derfor ikke direkte kompatibel med dette connector-flow, før OAuth-understøttelse er tilføjet.

Discovery uden API-key

En klient behøver ikke først at anmode om adgangsoplysninger for at finde ud af, hvad denne server tilbyder. De følgende metoder besvares af https://mcp.qr3.app/mcp uden Authorization-header:

MetodeReturnerer
initializeProtokolversion, capabilities, servernavn
tools/listalle værktøjer samt inputskema
resources/listkataloget over statiske ressourcer
resources/readindholdet af en enkelt ressource
prompts/listprompt-listen
pingtilgængelighed

Enhver metode, der berører et workspace, kører via tools/call — og den kræver fortsat Bearer-keyen. Uden den svarer serveren med HTTP 401, application/problem+json og WWW-Authenticate: Bearer realm="qr3.app".

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

For klienter, der ikke taler MCP, er det samme katalog tilgængeligt som simpel JSON på https://mcp.qr3.app/resources, og en enkelt ressource på https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Tilgængelige værktøjer

Kerneværktøjer

VærktøjBeskrivelse
create_qrOpret en QR-kode til en URL
update_qrSkift mål-URL, status, tags, noter eller udløb for en QR-kode
list_qrsOplist QR-koder med statusfilter og markørbaseret paginering
get_qr_statsHent aggregeret scanningsstatistik for en QR-kode
create_batchOpret QR-koder fra en liste med URL’er (maks. 50)
create_dpp_qrOpret en DPP-QR-kode til et batteri, tekstil eller generelt produkt
create_vcard_qrOpret en statisk vCard-QR-kode
create_wifi_qrOpret en statisk WiFi-QR-kode
validate_dppValider DPP-data uden at oprette dem
get_imageHent en API-leveret URL til en PNG-, SVG-, PDF- eller EPS-fil
shorten_urlOpret en dynamisk URL-QR-kode, og returner dens korte URL

DPP-ressourcer

Serveren stiller desuden statiske ressourcer til rådighed for DPP-kontrakten:

URIIndhold
qr3://qr-typesDe seks Codes API-typer: URL, vCard, WiFi, e-mail, SMS og placering
qr3://error-codesFejltyper og løsningsvejledninger
qr3://rate-limitsPlanbaserede rate-limits
qr3://quickstartHurtigstart-guide
qr3://dpp-schemaBatteri-centreret DPP-kontrakt
qr3://gs1-test-vectorsGS1-resolver-eksempler
qr3://dpp-content-negotiation-examplesSvar-eksempler fra resolveren

Eksempel-prompts

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