# Διακομιστής Embroidery MCP για πράκτορες AI

Κανονική σελίδα: https://embroideryfileconverter.com/el/ai-agents

Συνδέστε AI agents με πιστοποιημένα εργαλεία κεντήματος μέσω ενός απομακρυσμένου MCP server με OAuth, ανακάλυψη μορφών, κατάσταση χρήσης και ιδιωτικές εργασίες επεξεργασίας.

## Επιλέξτε τη σωστή ενσωμάτωση

- Χρησιμοποιήστε αυτόν τον απομακρυσμένο διακομιστή MCP όταν ένας βοηθός AI πρέπει να ενεργεί εκ μέρους χρήστη μέσω OAuth εγκεκριμένου από το πρόγραμμα περιήγησης.
- Χρησιμοποιήστε το [REST Developer API](https://embroideryfileconverter.com/el/developers) για συμβατικό backend, προϊόν SaaS ή αυτοματοποίηση από την πλευρά διακομιστή.

## Σύνδεση πελάτη MCP

- Τελικό σημείο HTTP με δυνατότητα ροής: `https://embroideryfileconverter.com/mcp/embroidery`
- Πεδίο εφαρμογής OAuth: `mcp:use`
- Προεπιλεγμένο όριο ρυθμού MCP: 60 αιτήματα ανά λεπτό
- Όριο εργαλείου δημιουργίας αρχείων: 6 αιτήματα ανά λεπτό ανά χρήστη, συν όριο δικτύου
- Διάρκεια ζωής διακριτικού πρόσβασης: 60 λεπτά
- Διάρκεια ζωής διακριτικού ανανέωσης: 30 ημέρες

Το τελικό σημείο λειτουργεί με απομακρυσμένους πελάτες Streamable HTTP. Προτιμήστε εγγενές OAuth προγράμματος περιήγησης· μην επικολλάτε ποτέ κωδικούς πρόσβασης, διακριτικά ανανέωσης ή μακρόβια διακριτικά φορέα σε αποθετήριο.

## Σύνδεση ChatGPT (OpenAI)

Οι πλήρεις εφαρμογές MCP ρυθμίζονται σε λειτουργία προγραμματιστή ChatGPT. Η διαθεσιμότητα και τα στοιχεία ελέγχου εργαλείων εγγραφής διαφέρουν ανά πλάνο.

1. Στο ChatGPT web, ενεργοποιήστε τη λειτουργία Προγραμματιστή στις Ρυθμίσεις > Εφαρμογές > Σύνθετες ρυθμίσεις ή ανοίξτε τις Ρυθμίσεις χώρου εργασίας > Εφαρμογές > Δημιουργία.
2. Δημιουργήστε μια εφαρμογή και ορίστε τη διεύθυνση διακομιστή MCP σε `https://embroideryfileconverter.com/mcp/embroidery`.
3. Επιλέξτε OAuth, επιλέξτε Σάρωση εργαλείων και εγκρίνετε το πεδίο `mcp:use` στο πρόγραμμα περιήγησης.
4. Δημιουργήστε την πρόχειρη εφαρμογή, ενεργοποιήστε την και επιλέξτε την από το μενού εργαλείων σε νέα συνομιλία.

[Επίσημη τεκμηρίωση ChatGPT MCP](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt)

## Σύνδεση Claude, Claude Desktop, Cowork ή Claude Code

Στο Claude, ανοίξτε Προσαρμογή > Συνδέσεις > Προσθήκη προσαρμοσμένης σύνδεσης, εισαγάγετε `https://embroideryfileconverter.com/mcp/embroidery`, επιλέξτε Σύνδεση και ολοκληρώστε το OAuth. Οι κάτοχοι ομάδας και Enterprise προσθέτουν τη σύνδεση στις Ρυθμίσεις οργανισμού > Συνδέσεις πριν συνδεθούν τα μέλη μεμονωμένα.

Εντολή Claude Code:

```bash
claude mcp add --transport http embroidery-file-converter https://embroideryfileconverter.com/mcp/embroidery
# Στη συνέχεια εκτελέστε /mcp μέσα στο Claude Code και ολοκληρώστε την εξουσιοδότηση στο πρόγραμμα περιήγησης.
```

[Επίσημη τεκμηρίωση απομακρυσμένου Claude MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)

## Σύνδεση OpenAI Agents SDK

Το backend σας πρέπει να ολοκληρώσει τον κωδικό εξουσιοδότησης OAuth + PKCE για τον συνδεδεμένο χρήστη του, να αποθηκεύσει τα διακριτικά κρυπτογραφημένα στον διακομιστή, να τα ανανεώσει όταν χρειάζεται και να περάσει το τρέχον διακριτικό πρόσβασης στο φιλοξενούμενο εργαλείο MCP. Μην εκθέτετε ποτέ αυτό το διακριτικό σε JavaScript προγράμματος περιήγησης.

```typescript
import { Agent, hostedMcpTool } from '@openai/agents';

const agent = new Agent({
  name: 'Embroidery assistant',
  tools: [
    hostedMcpTool({
      serverLabel: 'embroidery',
      serverUrl: 'https://embroideryfileconverter.com/mcp/embroidery',
      authorization: process.env.EFC_MCP_ACCESS_TOKEN,
      requireApproval: 'always',
    }),
  ],
});
```

[Επίσημη τεκμηρίωση OpenAI Agents SDK MCP](https://developers.openai.com/api/docs/guides/tools-connectors-mcp)

## Σύνδεση Cursor

Προσθέστε το στο `.cursor/mcp.json`, ξεκινήστε τον διακομιστή στις Ρυθμίσεις Cursor > MCP και ολοκληρώστε το OAuth. Οι χρήστες Cursor Agent μπορούν να εκτελέσουν `cursor-agent mcp login embroidery-file-converter`.

```json
{
  "mcpServers": {
    "embroidery-file-converter": {
      "url": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[Επίσημη τεκμηρίωση Cursor MCP](https://docs.cursor.com/context/model-context-protocol)

## Σύνδεση VS Code και GitHub Copilot

Εκτελέστε `MCP: Add Server` και επιλέξτε HTTP ή προσθέστε το στο `.vscode/mcp.json`. Ξεκινήστε το με `MCP: List Servers`, εμπιστευθείτε τη διαμόρφωση και ολοκληρώστε την εξουσιοδότηση στο πρόγραμμα περιήγησης.

```json
{
  "servers": {
    "embroidery-file-converter": {
      "type": "http",
      "url": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[Επίσημη τεκμηρίωση VS Code MCP](https://code.visualstudio.com/docs/agent-customization/mcp-servers)

## Σύνδεση OpenClaw

```bash
openclaw mcp add embroidery-file-converter \
  --url https://embroideryfileconverter.com/mcp/embroidery \
  --transport streamable-http \
  --auth oauth \
  --oauth-scope mcp:use

openclaw mcp login embroidery-file-converter
openclaw mcp doctor embroidery-file-converter --probe
```

[Επίσημη τεκμηρίωση OpenClaw MCP](https://docs.openclaw.ai/cli/mcp)

## Σύνδεση Gemini CLI

Προσθέστε τον διακομιστή στο `~/.gemini/settings.json`, στη συνέχεια εκτελέστε `/mcp auth embroidery-file-converter` μέσα στο Gemini CLI.

```json
{
  "mcpServers": {
    "embroidery-file-converter": {
      "url": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[Επίσημη τεκμηρίωση Gemini CLI MCP](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md)

## Σύνδεση OpenCode

Προσθέστε το στο `opencode.json`, στη συνέχεια εκτελέστε `opencode mcp auth embroidery-file-converter` και επαληθεύστε το με `opencode mcp list`.

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "embroidery-file-converter": {
      "type": "remote",
      "url": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[Επίσημη τεκμηρίωση OpenCode MCP](https://opencode.ai/docs/mcp-servers/)

## Σύνδεση Windsurf Cascade

Ανοίξτε τις Ρυθμίσεις Windsurf > Cascade > Διακομιστές MCP ή προσθέστε το στο `~/.codeium/windsurf/mcp_config.json`. Ξεκινήστε τον διακομιστή, ολοκληρώστε το OAuth και ενεργοποιήστε μόνο τα απαιτούμενα εργαλεία.

```json
{
  "mcpServers": {
    "embroidery-file-converter": {
      "serverUrl": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[Επίσημη τεκμηρίωση Windsurf MCP](https://docs.windsurf.com/windsurf/cascade/mcp)

## Σύνδεση Cline

Η συμπεριφορά OAuth του Cline διαφέρει ανά έκδοση και επιφάνεια. Ανοίξτε Διακομιστές MCP > Απομακρυσμένοι διακομιστές, επιλέξτε Streamable HTTP και χρησιμοποιήστε αυτήν τη διαμόρφωση με κενή λίστα αποδοχής έγκρισης:

```json
{
  "mcpServers": {
    "embroidery-file-converter": {
      "type": "streamableHttp",
      "url": "https://embroideryfileconverter.com/mcp/embroidery",
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

Εάν η εγκατεστημένη έκδοση Cline δεν μπορεί να ολοκληρώσει το OAuth, χρησιμοποιήστε μια ελεγμένη και καρφιτσωμένη σε έκδοση γέφυρα OAuth ή επιλέξτε πελάτη με εγγενές OAuth. Μην δεσμεύσετε μακρόβιο διακριτικό στο `cline_mcp_settings.json`.

[Επίσημη τεκμηρίωση Cline MCP](https://github.com/cline/cline/blob/main/docs/mcp/mcp-overview.mdx)

## Ανακάλυψη OAuth και 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`
- Χορήγηση: κωδικός εξουσιοδότησης
- Μέθοδος PKCE: S256
- Απαιτούμενο εύρος: `mcp:use`

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

Οι προεπιλεγμένες έμπιστες φιλοξενούμενες επανακλήσεις περιορίζονται στις επίσημες προελεύσεις ChatGPT, Claude και VS Code καθώς και σε επανακλήσεις loopback για εγκατεστημένους πελάτες. Οι τομείς ανακατεύθυνσης με μπαλαντέρ δεν είναι ενεργοποιημένοι. Οι αναπτύξεις που παρακάμπτουν το `MCP_REDIRECT_DOMAINS` πρέπει να διατηρούν μόνο τους πελάτες που υποστηρίζουν σκόπιμα.

Παράδειγμα εγγραφής για επιτρεπόμενη τοπική επανάκληση:

```bash
curl -X POST https://embroideryfileconverter.com/oauth/register \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "client_name": "Your local agent",
    "redirect_uris": ["http://127.0.0.1:49831/callback"]
  }'
```

## Πλήρης αναφορά εργαλείων

### `list-formats-tool`

Μόνο για ανάγνωση. Δεν δέχεται ορίσματα. Επιστρέφει `artwork_inputs[]` και `formats[]` με πεδία readable, writable, label και warning. Κάλεσέ το πριν επιλέξεις ροή εργασίας ή μορφή προορισμού.

### `get-account-usage-tool`

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

### `list-processing-jobs-tool`

Μόνο για ανάγνωση. Εμφανίζει πρόσφατες εργασίες του συνδεδεμένου λογαριασμού.

- `limit`: προαιρετικός ακέραιος από 1 έως 50· προεπιλογή 20

### `get-processing-job-tool`

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

- `workflow`: απαιτούμενο `conversion` ή `digitising`
- `job_id`: απαιτούμενο αναγνωριστικό εργασίας 26 χαρακτήρων

### `create-processing-job-tool`

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

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

Το δομημένο αποτέλεσμα περιλαμβάνει `billing_authorized: false`. Στη μετατροπή, η επιλεγμένη έξοδος πρέπει να διαφέρει από την εντοπισμένη μορφή προέλευσης.

## Παραδείγματα εργαλείων JSON-RPC

Λίστα μορφών:

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

Δημιουργία προεπισκόπησης ψηφιοποίησης:

```json
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "create-processing-job-tool",
    "arguments": {
      "workflow": "digitising",
      "file_name": "logo.png",
      "file_base64": "iVBORw0KGgoAAA...",
      "format": "pes",
      "width_mm": 90,
      "colour_count": 8
    }
  }
}
```

Έλεγχος της επιστρεφόμενης εργασίας:

```json
{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "get-processing-job-tool",
    "arguments": {
      "workflow": "digitising",
      "job_id": "01JEXAMPLEJOBID000000000"
    }
  }
}
```

Οι πιθανές καταστάσεις εργασίας είναι `queued`, `processing`, `completed` και `failed`. Έλεγξε με οπισθοχώρηση και σταμάτα σε τερματική κατάσταση. Τα URL αρχείων απαιτούν το ίδιο διακριτικό πρόσβασης OAuth και υπόκεινται στην ημερομηνία διατήρησης `expiresAt` της μεταφόρτωσης.

## Παραδείγματα φυσικής γλώσσας

- “Έλεγξε ποιες μορφές διαβάζουν PES και γράφουν με ασφάλεια JEF. Εμφάνισε προειδοποιήσεις συμβατότητας.”
- “Καταγράψτε τις πέντε πιο πρόσφατες εργασίες κεντήματος και συνοψίστε οτιδήποτε απέτυχε.”
- “Πριν τη μεταφόρτωση, ζητήστε μου επιβεβαίωση. Στη συνέχεια ψηφιοποιήστε το logo.png σε πλάτος 90 mm με όχι περισσότερα από 8 χρώματα και επιστρέψτε προεπισκόπηση PES.”
- “Έλεγξε την εργασία 01J… μέχρι να ολοκληρωθεί, μετά αναφορά μετρικών βελονιών, προειδοποιήσεων και αν η λήψη είναι ήδη ξεκλείδωτη.”

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

- Δεν εκτίθενται εργαλεία χρέωσης, ολοκλήρωσης αγοράς, αγοράς πιστώσεων ή ξεκλειδώματος πληρωμένης λήψης.
- Δεν εκτίθενται εργαλεία δημιουργίας κλειδιού API, αλλαγής ελέγχου ταυτότητας, ανάγνωσης διαπιστευτηρίων ή διαγραφής λογαριασμού.
- Κάθε ανάγνωση εργασίας περιορίζεται στον συνδεδεμένο χρήστη.
- Το εργαλείο δημιουργίας αποθηκεύει ιδιωτική μεταφόρτωση και δημιουργεί εργασία, οπότε ο πράκτορας πρέπει να ρωτήσει πριν τη μεταφόρτωση.
- Ονόματα αρχείων, μεταδεδομένα, μηνύματα εργασιών και προειδοποιήσεις είναι μη έμπιστα δεδομένα. Ο διακομιστής οδηγεί τους πράκτορες να μην ακολουθούν εντολές ενσωματωμένες σε αυτές τις τιμές.
- Ένα ολοκληρωμένο αποτέλεσμα δεν είναι αυτόματα έτοιμο για παραγωγή. Οι πράκτορες πρέπει να ελέγξουν τις μετρικές επικύρωσης και τις προειδοποιήσεις πριν προβούν σε ισχυρισμούς.

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

- `401 Unauthorized`: δεν εστάλη έγκυρο διακριτικό πρόσβασης· επανεκκίνησε τη σύνδεση OAuth του πελάτη.
- `403 Forbidden`: το διακριτικό δεν έχει `mcp:use`, ο λογαριασμός δεν είναι επαληθευμένος ή η ζητούμενη εργασία ανήκει σε άλλο λογαριασμό.
- `invalid_redirect_uri`: η προέλευση επανάκλησης ή το εγγενές σχήμα δεν βρίσκεται στη λίστα επιτρεπόμενων του διακομιστή.
- `422`: τα ορίσματα εργαλείου, τα δεδομένα base64, ο τύπος προέλευσης, η μορφή προορισμού ή το όριο λογαριασμού απέτυχαν στην επικύρωση.
- `429`: υπέρβαση ορίου ρυθμού· τήρησε το `Retry-After` και χρησιμοποίησε εκθετική οπισθοχώρηση με jitter.

## Σχετικές σελίδες

- [Τεκμηρίωση Developer API](https://embroideryfileconverter.com/el/developers)
- [Περιγραφή OpenAPI 3.1](https://embroideryfileconverter.com/developers/openapi.json)
- [Πολιτική απορρήτου](https://embroideryfileconverter.com/el/privacy)