Serveur MCP

Le serveur MCP qr3.app fournit les outils QR et DPP actuels pour Claude, Cursor et d’autres clients compatibles MCP. Le serveur fonctionne via HTTP avec authentification Bearer.

Connexion sécurisée

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

Le serveur distant actuel utilise l’authentification HTTP Bearer :

Authorization: Bearer <API_KEY>

Utilisez uniquement un client MCP capable d’envoyer un en-tête HTTP Authorization personnalisé depuis son stockage sécurisé d’identifiants. N’enregistrez jamais une clé API dans un fichier de configuration du projet ou dans un dépôt.

Les connecteurs distants de Claude utilisent OAuth. qr3 ne propose actuellement que l’authentification par clé Bearer ; il n’est donc pas directement compatible avec ce flux de connecteur tant que la prise en charge d’OAuth n’est pas ajoutée.

Découverte sans clé API

Un client n’a pas besoin de demander d’abord des identifiants pour découvrir ce que ce serveur propose. Les méthodes suivantes sont traitées par https://mcp.qr3.app/mcp sans en-tête Authorization :

Méthode	Fournit
`initialize`	Version du protocole, capabilities, nom du serveur
`tools/list`	tous les outils avec leur schéma de saisie
`resources/list`	le catalogue des ressources statiques
`resources/read`	le contenu d’une ressource individuelle
`prompts/list`	la liste des prompts
`ping`	accessibilité

Chaque méthode qui touche à un espace de travail passe par tools/call — et celle-ci requiert toujours la clé Bearer. Sans elle, le serveur répond avec HTTP 401, application/problem+json et 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":{}}'

Pour les clients qui ne parlent pas MCP, le même catalogue est disponible sous forme de JSON simple à l’adresse https://mcp.qr3.app/resources, et une ressource individuelle à l’adresse https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Outils disponibles

Outils principaux

Outil	Description
`create_qr`	Créer un code QR pour une URL
`update_qr`	Modifier l’URL cible, le statut, les tags, les notes ou l’expiration d’un code QR
`list_qrs`	Lister les codes QR avec un filtre de statut et une pagination par curseur
`get_qr_stats`	Récupérer les statistiques de scan agrégées pour un code QR
`create_batch`	Créer des codes QR à partir d’une liste d’URL (50 max.)
`create_dpp_qr`	Créer un code QR DPP pour une batterie, un textile ou un produit général
`create_vcard_qr`	Créer un code QR vCard statique
`create_wifi_qr`	Créer un code QR WiFi statique
`validate_dpp`	Valider les données DPP sans les créer
`get_image`	Récupérer une URL de ressource PNG, SVG, PDF ou EPS fournie par l’API
`shorten_url`	Créer un code QR d’URL dynamique et renvoyer son URL courte

Ressources DPP

Le serveur fournit également des ressources statiques pour le contrat DPP :

URI	Contenu
`qr3://qr-types`	Les six types de la Codes API : URL, vCard, WiFi, e-mail, SMS et localisation
`qr3://error-codes`	Types d’erreurs et conseils de résolution
`qr3://rate-limits`	Limites de taux basées sur le forfait
`qr3://quickstart`	Guide de démarrage rapide
`qr3://dpp-schema`	Contrat DPP centré sur les batteries
`qr3://gs1-test-vectors`	Exemples de résolveur GS1
`qr3://dpp-content-negotiation-examples`	Exemples de négociation de contenu du résolveur

Exemples de 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