MCP Server

Ο MCP Server του qr3.app παρέχει τα τρέχοντα εργαλεία QR και DPP για το Claude, το Cursor και άλλους πελάτες (clients) με υποστήριξη MCP. Ο διακομιστής εκτελείται μέσω HTTP με έλεγχο ταυτότητας Bearer.

Ασφαλής σύνδεση

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

Ο τρέχων απομακρυσμένος διακομιστής χρησιμοποιεί έλεγχο ταυτότητας HTTP Bearer:

Authorization: Bearer <API_KEY>

Χρησιμοποιείτε μόνο MCP client που μπορεί να στείλει προσαρμοσμένη κεφαλίδα HTTP Authorization από τον ασφαλή χώρο αποθήκευσης διαπιστευτηρίων του. Μην καταχωρίζετε ποτέ κλειδί API σε αρχείο ρυθμίσεων έργου ή αποθετήριο.

Οι Claude Remote Connectors χρησιμοποιούν OAuth. Το qr3 προσφέρει προς το παρόν μόνο έλεγχο ταυτότητας με κλειδί Bearer, επομένως δεν είναι άμεσα συμβατό με αυτή τη ροή connector έως ότου προστεθεί υποστήριξη OAuth.

Discovery χωρίς API-Key

Ένας client δεν χρειάζεται να ζητήσει πρώτα διαπιστευτήρια για να ανακαλύψει τι προσφέρει αυτός ο διακομιστής. Οι ακόλουθες μέθοδοι απαντώνται από το https://mcp.qr3.app/mcp χωρίς κεφαλίδα Authorization:

Μέθοδος	Επιστρέφει
`initialize`	Έκδοση πρωτοκόλλου, capabilities, όνομα διακομιστή
`tools/list`	όλα τα εργαλεία μαζί με το σχήμα εισαγωγής
`resources/list`	τον κατάλογο των στατικών πόρων
`resources/read`	το περιεχόμενο ενός μεμονωμένου πόρου
`prompts/list`	τη λίστα prompt
`ping`	διαθεσιμότητα

Κάθε μέθοδος που επηρεάζει έναν Workspace εκτελείται μέσω του tools/call — και αυτή εξακολουθεί να απαιτεί το κλειδί Bearer. Χωρίς αυτό, ο διακομιστής απαντά με HTTP 401, application/problem+json και 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":{}}'

Για clients που δεν υποστηρίζουν MCP, ο ίδιος κατάλογος είναι διαθέσιμος ως απλό JSON στη διεύθυνση https://mcp.qr3.app/resources, και ένας μεμονωμένος πόρος στη διεύθυνση https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Διαθέσιμα εργαλεία

Βασικά εργαλεία

Εργαλείο	Περιγραφή
`create_qr`	Δημιουργία κωδικού QR για URL
`update_qr`	Αλλαγή της URL προορισμού, της κατάστασης, των ετικετών, των σημειώσεων ή της λήξης ενός κωδικού QR
`list_qrs`	Λίστα κωδικών QR με φίλτρο κατάστασης και σελιδοποίηση με δρομέα
`get_qr_stats`	Λήψη συγκεντρωτικών στατιστικών σάρωσης για έναν κωδικό QR
`create_batch`	Δημιουργία κωδικών QR από λίστα URL (έως 50)
`create_dpp_qr`	Δημιουργία κωδικού QR DPP για μπαταρία, κλωστοϋφαντουργικό ή γενικό προϊόν
`create_vcard_qr`	Δημιουργία στατικού κωδικού QR vCard
`create_wifi_qr`	Δημιουργία στατικού κωδικού QR WiFi
`validate_dpp`	Επικύρωση δεδομένων DPP χωρίς δημιουργία
`get_image`	Λήψη URL που παρέχει το API για αρχείο PNG, SVG, PDF ή EPS
`shorten_url`	Δημιουργία δυναμικού κωδικού QR για URL και επιστροφή της σύντομης URL

Πόροι DPP

Ο διακομιστής παρέχει επίσης στατικούς πόρους (Resources) για το συμβόλαιο DPP (DPP-Contract):

URI	Περιεχόμενο
`qr3://qr-types`	Οι έξι τύποι του Codes API: URL, vCard, WiFi, email, SMS και τοποθεσία
`qr3://error-codes`	Τύποι σφαλμάτων και οδηγίες επίλυσης
`qr3://rate-limits`	Όρια ρυθμού (rate limits) βάσει προγράμματος
`qr3://quickstart`	Οδηγός γρήγορης εκκίνησης
`qr3://dpp-schema`	Συμβόλαιο DPP (DPP-Contract) με επίκεντρο τις μπαταρίες
`qr3://gs1-test-vectors`	Παραδείγματα GS1 Resolver
`qr3://dpp-content-negotiation-examples`	Παραδείγματα απαντήσεων του Resolver

Παραδείγματα prompt

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