MCP-server

De qr3.app MCP-server stelt de actuele QR- en DPP-tools beschikbaar voor Claude, Cursor en andere MCP-compatibele clients. De server draait via HTTP met Bearer-authenticatie.

Veilige verbinding

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

De huidige externe server gebruikt HTTP Bearer-authenticatie:

Authorization: Bearer <API_KEY>

Gebruik alleen een MCP-client die vanuit zijn beveiligde referentieopslag een aangepaste HTTP-header Authorization kan verzenden. Sla nooit een API-sleutel op in een projectconfiguratiebestand of repository.

Claude Remote Connectors gebruiken OAuth. qr3 biedt momenteel alleen authenticatie met een Bearer-sleutel en is daarom niet rechtstreeks compatibel met deze connectorflow totdat OAuth-ondersteuning is toegevoegd.

Discovery zonder API-key

Een client hoeft niet eerst om inloggegevens te vragen om te ontdekken wat deze server aanbiedt. De volgende methoden beantwoordt https://mcp.qr3.app/mcp zonder Authorization-header:

Methode	Levert
`initialize`	Protocolversie, capabilities, servernaam
`tools/list`	alle tools inclusief invoerschema
`resources/list`	de catalogus van statische resources
`resources/read`	de inhoud van een enkele resource
`prompts/list`	de prompt-lijst
`ping`	bereikbaarheid

Elke methode die een workspace raakt, verloopt via tools/call — en die vereist nog steeds de Bearer-key. Zonder deze antwoordt de server met HTTP 401, application/problem+json en 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":{}}'

Voor clients die geen MCP spreken, is dezelfde catalogus beschikbaar als eenvoudige JSON onder https://mcp.qr3.app/resources, een enkele resource onder https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Beschikbare tools

Kern-tools

Tool	Beschrijving
`create_qr`	Een QR-code voor een URL maken
`update_qr`	Doel-URL, status, tags, notities of verloop van een QR-code wijzigen
`list_qrs`	QR-codes weergeven met statusfilter en cursorpaginering
`get_qr_stats`	Geaggregeerde scanstatistieken voor een QR-code ophalen
`create_batch`	QR-codes maken uit een lijst met URL’s (maximaal 50)
`create_dpp_qr`	Een DPP-QR-code maken voor een batterij, textiel of algemeen product
`create_vcard_qr`	Een statische vCard-QR-code maken
`create_wifi_qr`	Een statische WiFi-QR-code maken
`validate_dpp`	DPP-gegevens valideren zonder ze aan te maken
`get_image`	Een door de API verstrekte URL voor een PNG-, SVG-, PDF- of EPS-bestand ophalen
`shorten_url`	Een dynamische URL-QR-code maken en de korte URL teruggeven

DPP-bronnen

De server stelt daarnaast statische resources voor het DPP-contract beschikbaar:

URI	Inhoud
`qr3://qr-types`	De zes Codes API-types: URL, vCard, WiFi, e-mail, sms en locatie
`qr3://error-codes`	Fouttypes en oplossingsinstructies
`qr3://rate-limits`	Abonnementsgebaseerde rate limits
`qr3://quickstart`	Snelstartgids
`qr3://dpp-schema`	Batterij-gecentreerd DPP-contract
`qr3://gs1-test-vectors`	GS1-resolver-voorbeelden
`qr3://dpp-content-negotiation-examples`	Antwoordvoorbeelden van de resolver

Voorbeeldprompts

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