Απομακρυσμένο MCP · v1.0OAuth 2.1 + PKCE

Παροχή σε πράκτορες AI εργαλείων κεντήματος.

Σύνδεση βοηθών με ανακάλυψη μορφών, χρήση λογαριασμού και ιδιωτικές εργασίες επεξεργασίας—εκ μέρους χρήστη, με έγκριση προγράμματος περιήγησης και χωρίς εργαλεία χρέωσης ή διαπιστευτηρίων.

Σύνδεση πελάτη MCP Μεταδεδομένα ανακάλυψης

Τελικό σημείο HTTP με δυνατότητα ροής

https://embroideryfileconverter.com/mcp/embroidery

Εργαλεία

Εύρος

mcp:use

Ρυθμός ανάγνωσης

60/min

Ο χρήστης συνδέεται, επαληθεύει το email του και εγκρίνει πρόσβαση στο πρόγραμμα περιήγησης. Ο πράκτορας λαμβάνει διακριτικό με εύρος—όχι τον κωδικό πρόσβασης του χρήστη ή κλειδί API.

Επισκόπηση Οδηγοί πελάτη OAuth + PKCE Αναφορά εργαλείων Παραδείγματα agent Μοντέλο ασφάλειας Αντιμετώπιση προβλημάτων

Συμβατότητα πελάτη

Επιλέξτε τον πράκτορά σας. Αντιγράψτε τη ρύθμισή του.

Χρησιμοποιήστε τους παρακάτω οδηγούς για ChatGPT, Claude, το OpenAI Agents SDK, Cursor, VS Code, OpenClaw, Gemini CLI, OpenCode, Windsurf και Cline. Κάθε οδηγός προσδιορίζει αν το OAuth είναι εγγενές, διαχειριζόμενο από προγραμματιστή ή μπορεί να απαιτεί ελεγχόμενη γέφυρα.

Native OAuthChatGPT web · Ρυθμίσεις → Apps

Σύνδεση ChatGPT

Δημιουργήστε προσαρμοσμένη εφαρμογή MCP σε λειτουργία προγραμματιστή ChatGPT και αφήστε το ChatGPT να ανακαλύψει τα εργαλεία και τα μεταδεδομένα OAuth.

1Ενεργοποιήστε τη λειτουργία Developer στις Ρυθμίσεις → Apps → Advanced settings, ή ανοίξτε τις Ρυθμίσεις Workspace → Apps → Create.
2Δημιουργήστε εφαρμογή, επικολλήστε το MCP endpoint και επιλέξτε έλεγχο ταυτότητας OAuth.
3Επιλέξτε Scan tools, εγκρίνετε την πρόσβαση στον browser και δημιουργήστε/ενεργοποιήστε το draft app.

Επίσημη τεκμηρίωση ChatGPT MCP

Ρύθμιση ChatGPT · Τιμές σύνδεσης

MCP server URL: https://embroideryfileconverter.com/mcp/embroidery
Authentication: OAuth
Required scope: mcp:use

Χρησιμοποιήστε browser OAuth και ζητήστε μόνο mcp:use. Μην τοποθετείτε ποτέ κωδικό πρόσβασης, refresh token ή μακρόβιο bearer token σε repository.

Η πλήρης υποστήριξη write-tool προορίζεται για ChatGPT Business και Enterprise/Edu workspaces. Η διαθεσιμότητα και οι έλεγχοι διαχειριστή διαφέρουν ανά πλάνο.

Streamable HTTPOAuth authorization code + PKCEΙδιωτικά δεδομένα ανά χρήστη

Αν ο πελάτης σας δεν μπορεί να ανοίξει OAuth

Επιβεβαιώστε ότι υποστηρίζει απομακρυσμένους διακομιστές Streamable HTTP MCP και ανακάλυψη προστατευμένου πόρου. Ένας τοπικός πελάτης μόνο stdio δεν μπορεί να συνδεθεί σε αυτό το φιλοξενούμενο τελικό σημείο χωρίς συμβατή γέφυρα.

Εξουσιοδότηση

Κωδικός εξουσιοδότησης OAuth + PKCE.

Ο διακομιστής δημοσιεύει μεταδεδομένα βασισμένα σε πρότυπα, απαιτεί S256 PKCE και εκθέτει ένα εύρος ελάχιστου προνομίου. Η δυναμική εγγραφή διατίθεται μόνο για προελεύσεις επανάκλησης που επιτρέπονται από τον χειριστή και εγγενή σχήματα.

Προστατευμένος πόροςhttps://embroideryfileconverter.com/.well-known/oauth-protected-resource/mcp/embroidery

Διακομιστής εξουσιοδότησηςhttps://embroideryfileconverter.com/.well-known/oauth-authorization-server

Δυναμική εγγραφήhttps://embroideryfileconverter.com/oauth/register

Εκδότηςhttps://embroideryfileconverter.com

Απαιτούμενο εύροςmcp:use

Παραδείγματα επιπέδου πρωτοκόλλου · JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "Your agent",
      "version": "1.0.0"
    }
  }
}

Βραχύβια πρόσβαση

Τα διακριτικά πρόσβασης λήγουν μετά από 60 λεπτά. Τα διακριτικά ανανέωσης λήγουν μετά από 30 ημέρες και παραμένουν ανακλητά.

Απαιτείται επαληθευμένος λογαριασμός

Ένα έγκυρο διακριτικό πρέπει να περιέχει mcp:use, και ο συνδεδεμένος χρήστης πρέπει να έχει επαληθευμένη διεύθυνση email.

Αναφορά εργαλείων

Πέντε εργαλεία, ρητά όρια.

list-formats-tool

Εμφανίζει αναγνώσιμες πηγές κεντήματος, εγγράψιμες εξόδους μηχανής, τύπους εισόδου έργων τέχνης και προειδοποιήσεις συμβατότητας.

Μόνο ανάγνωση

Ορίσματα

Χωρίς ορίσματα

Δομημένο αποτέλεσμα

artwork_inputs[] και formats[]

get-account-usage-tool

Επιστρέφει το επίδομα προεπισκόπησης, το υπόλοιπο πιστώσεων, το κόστος ροών εργασίας, τα όρια συνδρομής και τις ημερομηνίες επαναφοράς.

Μόνο ανάγνωση

Ορίσματα

Χωρίς ορίσματα

Δομημένο αποτέλεσμα

αντικείμενο χρήσης

list-processing-jobs-tool

Παραθέτει πρόσφατες εργασίες μετατροπής και ψηφιοποίησης που ανήκουν στον συνδεδεμένο λογαριασμό.

Μόνο ανάγνωση

Ορίσματα

limit: ακέραιος, 1–50, προεπιλογή 20

Δομημένο αποτέλεσμα

jobs[] με κατάσταση, αρχεία και μετρικές

get-processing-job-tool

Λαμβάνει μία ανήκουσα εργασία με συμβάντα, προειδοποιήσεις, μετρικές, τεχνουργήματα προεπισκόπησης και διαθέσιμα OAuth-προστατευμένα URL αρχείων.

Μόνο ανάγνωση

Ορίσματα

workflow: μετατροπή | ψηφιοποίηση
job_id: αναγνωριστικό εργασίας 26 χαρακτήρων

Δομημένο αποτέλεσμα

αντικείμενο εργασίας

create-processing-job-tool

Δημιουργεί μία ιδιωτική μετατροπή ή αυτοματοποιημένη προεπισκόπηση ψηφιοποίησης από ένα τυπικό αρχείο κωδικοποιημένο σε base64.

Δημιουργεί δεδομένα

Ορίσματα

workflow: μετατροπή | ψηφιοποίηση
file_name: αρχικό όνομα με επέκταση
file_base64: ακατέργαστο τυπικό base64, χωρίς πρόθεμα data URL
format: εγγράψιμη έξοδος σε πεζά
width_mm: 10–300, απαιτούμενο για ψηφιοποίηση
colour_count: 1–24, απαιτούμενο για ψηφιοποίηση

Δομημένο αποτέλεσμα

σύνοψη εργασίας και billing_authorized: false

Κλήσεις εργαλείων και προτροπές

Έτοιμα παραδείγματα πράκτορα για αντιγραφή.

Κλήση εργαλείου MCP · JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list-formats-tool",
    "arguments": {}
  }
}

Προτροπή 1

“Ελέγξτε ποιες μορφές μπορούν να διαβάσουν PES και να γράψουν με ασφάλεια JEF. Δείξτε μου τυχόν προειδοποιήσεις συμβατότητας.”

Προτροπή 2

“Καταγράψτε τις πέντε πιο πρόσφατες εργασίες κεντήματος και συνοψίστε οτιδήποτε απέτυχε.”

Προτροπή 3

“Πριν τη μεταφόρτωση, ζητήστε μου επιβεβαίωση. Στη συνέχεια ψηφιοποιήστε το logo.png σε πλάτος 90 mm με όχι περισσότερα από 8 χρώματα και επιστρέψτε προεπισκόπηση PES.”

Προτροπή 4

“Κάντε δημοσκόπηση της εργασίας 01J… μέχρι να ολοκληρωθεί, στη συνέχεια αναφέρετε μετρήσεις βελονιών, προειδοποιήσεις και αν μια λήψη είναι ήδη ξεκλείδωτη.”

Μοντέλο ασφάλειας

Χρήσιμη πρόσβαση χωρίς εξουσία πληρωμής.

Χωρίς εργαλεία χρέωσης

Δεν εκτίθενται εργαλεία αγοράς, ολοκλήρωσης αγοράς, κατανάλωσης πιστώσεων με ρητό ξεκλείδωμα ή ξεκλειδώματος επί πληρωμή λήψης.

Χωρίς εργαλεία διαπιστευτηρίων

Ο πράκτορας δεν μπορεί να εκδώσει κλειδιά API, να αλλάξει έλεγχο ταυτότητας ή να ανακτήσει μυστικό υλικό.

Μόνο ιδιόκτητα δεδομένα

Κάθε ερώτημα εργασίας περιορίζεται στον συνδεδεμένο χρήστη πριν επιστραφούν λεπτομέρειες.

Μη έμπιστη έξοδος παραμένει δεδομένα

Οι οδηγίες διακομιστή λένε στους πράκτορες να μην ακολουθούν ποτέ εντολές ενσωματωμένες σε ονόματα αρχείων, μεταδεδομένα, μηνύματα εργασιών ή προειδοποιήσεις.

Η δημιουργία προεπισκόπησης αλλάζει κατάσταση

Το εργαλείο δημιουργίας αποθηκεύει ιδιωτική μεταφόρτωση, δημιουργεί εργασία και μπορεί να καταναλώσει επίδομα προεπισκόπησης. Περιορίζεται ξεχωριστά σε 6 αιτήματα ανά λεπτό ανά χρήστη, με πρόσθετο όριο δικτύου. Ο διακομιστής καθοδηγεί τον πράκτορα να ρωτήσει τον χρήστη πριν τη μεταφόρτωση.

Η προεπισκόπηση δεν είναι έγκριση παραγωγής

Μια επιτυχής κλήση εργαλείου ορίζει billing_authorized: false. Οι agents δεν πρέπει να ισχυρίζονται ότι ένα σχέδιο είναι έτοιμο για παραγωγή πριν την ολοκλήρωση, τον έλεγχο των μετρικών και των προειδοποιήσεων.

Αντιμετώπιση προβλημάτων

Διάγνωση αποτυχιών σύνδεσης γρήγορα.

401 Unauthorized

Δεν εστάλη έγκυρο access token. Επανεκκινήστε τη σύνδεση OAuth του client.

403 Forbidden

Το token δεν έχει mcp:use, ο λογαριασμός δεν είναι επαληθευμένος ή η εργασία ανήκει σε άλλον χρήστη.

invalid_redirect_uri

Η προέλευση callback του client ή το native scheme δεν βρίσκεται στη λίστα επιτρεπόμενων του server.

422 tool error

Τα ορίσματα, τα δεδομένα base64, ο τύπος πηγής, η μορφή προορισμού ή το quota λογαριασμού απέτυχαν στην επικύρωση.

429 Too Many Requests

Τα εργαλεία ανάγνωσης επιτρέπουν 60 αιτήματα ανά λεπτό από προεπιλογή· το εργαλείο δημιουργίας αρχείων επιτρέπει 6. Σεβαστείτε το Retry-After.

Αποφύγετε την επιθετική polling

Κάντε polling σε εργασίες στην ουρά και σε επεξεργασία με backoff. Σταματήστε όταν η κατάσταση γίνει completed ή failed.

Ληγμένο ιδιωτικό αρχείο

Τα URL αρχείων απαιτούν το ίδιο OAuth access token και παραμένουν υπό τους όρους του upload’s expiresAt ημερομηνία διατήρησης. Μην αντιμετωπίζετε τα URL ως μόνιμα αναγνωριστικά αρχείων.

Φτιάχνετε συμβατική εφαρμογή;

Χρησιμοποιήστε το scoped REST API.

Ο οδηγός REST περιλαμβάνει διαχείριση API κλειδιών, παραδείγματα multipart σε τρεις γλώσσες, όλα τα endpoints, τον κύκλο ζωής αποκρίσεων και το OpenAPI 3.1.

Άνοιγμα τεκμηρίωσης REST API

Χρειάζεστε βοήθεια; Επικοινωνία με υποστήριξη προγραμματιστών

Άνοιγμα μεταδεδομένων ανακάλυψης MCP