# שרת Embroidery MCP לסוכני AI

דף קנוני: https://embroideryfileconverter.com/he/ai-agents

חבר סוכני AI לכלי רקמה מאומתים דרך שרת MCP מרוחק עם OAuth, גילוי פורמטים, סטטוס שימוש ועבודות עיבוד פרטיות.

## בחר את האינטגרציה הנכונה

- השתמש בשרת MCP מרוחק זה כאשר עוזר AI צריך לפעול בשם משתמש דרך OAuth שאושר בדפדפן.
- השתמש ב-[REST Developer API](https://embroideryfileconverter.com/he/developers) עבור backend קונבנציונלי, מוצר SaaS או אוטומציה בצד השרת.

## חבר לקוח MCP

- נקודת קצה HTTP ניתנת להזרמה: `https://embroideryfileconverter.com/mcp/embroidery`
- היקף OAuth: `mcp:use`
- מגבלת קצב MCP ברירת מחדל: 60 בקשות לדקה
- מגבלת כלי יצירת קבצים: 6 בקשות לדקה למשתמש, בתוספת מגבלת רשת
- זמן חיים של אסימון גישה: 60 דקות
- זמן חיים של אסימון רענון: 30 ימים

נקודת הקצה עובדת עם לקוחות Streamable HTTP מרוחקים. העדף OAuth מקורי של הדפדפן; לעולם אל תדביק סיסמאות, אסימוני רענון או אסימוני bearer ארוכי חיים למאגר.

## התחבר ל-ChatGPT (OpenAI)

אפליקציות MCP מלאות מוגדרות במצב מפתח של ChatGPT. זמינות ובקרות כלי כתיבה משתנות לפי תוכנית.

1. ב-ChatGPT web, הפעל מצב מפתח ב-הגדרות > אפליקציות > הגדרות מתקדמות, או פתח הגדרות Workspace > אפליקציות > צור.
2. צור אפליקציה והגדר את כתובת שרת ה-MCP ל-`https://embroideryfileconverter.com/mcp/embroidery`.
3. בחר OAuth, בחר סריקת כלים ואשר את היקף ה-`mcp:use` בדפדפן.
4. צור את טיוטת האפליקציה, הפעל אותה ובחר אותה מתפריט הכלים בשיחה חדשה.

[תיעוד MCP רשמי של ChatGPT](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. בעלי צוות וארגון מוסיפים את המחבר תחת הגדרות ארגון > מחברים לפני שחברים מתחברים בנפרד.

פקודת Claude Code:

```bash
claude mcp add --transport http embroidery-file-converter https://embroideryfileconverter.com/mcp/embroidery
# לאחר מכן הרץ /mcp בתוך Claude Code והשלם אישור בדפדפן.
```

[תיעוד MCP מרוחק רשמי של Claude](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',
    }),
  ],
});
```

[תיעוד MCP רשמי של OpenAI Agents SDK](https://developers.openai.com/api/docs/guides/tools-connectors-mcp)

## התחבר ל-Cursor

הוסף זאת ל-`.cursor/mcp.json`, הפעל את השרת ב-Cursor Settings > MCP והשלם OAuth. משתמשי Cursor Agent יכולים להריץ `cursor-agent mcp login embroidery-file-converter`.

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

[תיעוד MCP רשמי של Cursor](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"
    }
  }
}
```

[תיעוד MCP רשמי של VS Code](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
```

[תיעוד MCP רשמי של OpenClaw](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"
    }
  }
}
```

[תיעוד MCP רשמי של Gemini CLI](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"
    }
  }
}
```

[תיעוד MCP רשמי של OpenCode](https://opencode.ai/docs/mcp-servers/)

## התחבר ל-Windsurf Cascade

פתח Windsurf Settings > Cascade > MCP Servers, או הוסף זאת ל-`~/.codeium/windsurf/mcp_config.json`. הפעל את השרת, השלם OAuth והפעל רק את הכלים הנדרשים.

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

[תיעוד MCP רשמי של Windsurf](https://docs.windsurf.com/windsurf/cascade/mcp)

## התחבר ל-Cline

התנהגות ה-OAuth של Cline משתנה לפי גרסה וממשק. פתח MCP Servers > Remote Servers, בחר 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`.

[תיעוד MCP רשמי של Cline](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`

רישום לקוח דינמי מקבל רק מקורות callback וסכימות מקוריות שהותרו במפורש על ידי המפעיל. דומיינים שרירותיים של callback נדחים. החשבון חייב להיות בעל כתובת דוא"ל מאומתת לפני שניתן להשתמש בנקודת הקצה של MCP.

ה-callbacks המארחים המהימנים כברירת מחדל מוגבלים למקורות הרשמיים של ChatGPT, Claude ו-VS Code וכן ל-callbacks loopback עבור לקוחות מותקנים. דומיינים של הפניה עם wildcard אינם מופעלים. פריסות שדורסות את `MCP_REDIRECT_DOMAINS` חייבות לשמור רק את הלקוחות שהן מתכוונות לתמוך בהם בכוונה.

דוגמה לרישום עבור callback מקומי מותר:

```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`

קריאה בלבד. מחזיר עבודה אחת שבבעלות עם סטטוס, אירועים, מדדים, אזהרות, פריטי תצוגה מקדימה וכתובות קובץ מוגנות ב-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`. יש לסקור עם backoff ולהפסיק בסטטוס סופי. כתובות קובץ דורשות את אותו אסימון גישה של OAuth וכפופות לתאריך השמירה `expiresAt` של ההעלאה.

## דוגמאות להנחיות בשפה טבעית

- “בדוק אילו פורמטים יכולים לקרוא PES ולכתוב JEF בבטחה. הצג אזהרות תאימות.”
- “רשום את חמש עבודות הרקמה האחרונות שלי וסכם כל מה שנכשל.”
- “לפני ההעלאה, בקש ממני לאשר. לאחר מכן דגיטציה של logo.png ברוחב 90 מ"מ עם לא יותר מ-8 צבעים והחזר תצוגה מקדימה של PES.”
- “סקור את העבודה 01J… עד לסיום, ולאחר מכן דווח על מדדי תפרים, אזהרות והאם הורדה כבר נפתחה.”

## מודל בטיחות

- אין חשיפה לכלי חיוב, תשלום, רכישת קרדיטים או פתיחת הורדה בתשלום.
- אין חשיפה לכלי יצירת מפתח API, שינוי אימות, קריאת אישורים או מחיקת חשבון.
- כל קריאת עבודה מוגבלת למשתמש המחובר.
- כלי היצירה שומר העלאה פרטית ויוצר עבודה, ולכן הסוכן מקבל הוראה לשאול לפני העלאה.
- שמות קבצים, מטא-נתונים, הודעות עבודה ואזהרות הם נתונים לא מהימנים. השרת מורה לסוכנים לעולם לא לבצע פקודות המוטמעות בערכים אלה.
- תוצאה שהושלמה אינה מוכנה לייצור באופן אוטומטי. על הסוכנים לבדוק מדדי אימות ואזהרות לפני הצהרות.

## פתרון תקלות

- `401 Unauthorized`: לא נשלח אסימון גישה תקף; הפעל מחדש את חיבור ה-OAuth של הלקוח.
- `403 Forbidden`: לאסימון חסר `mcp:use`, החשבון אינו מאומת, או שהעבודה המבוקשת שייכת לחשבון אחר.
- `invalid_redirect_uri`: מקור ה-callback או הסכמה המקומית אינם ברשימת ההיתרים של השרת.
- `422`: פרמטרי הכלי, נתוני base64, סוג מקור, פורמט יעד או מכסת חשבון נכשלו באימות.
- `429`: חריגה ממגבלת קצב; כבד את `Retry-After` והשתמש ב-backoff מעריכי עם jitter.

## דפים קשורים

- [תיעוד API למפתחים](https://embroideryfileconverter.com/he/developers)
- [תיאור OpenAPI 3.1](https://embroideryfileconverter.com/developers/openapi.json)
- [מדיניות פרטיות](https://embroideryfileconverter.com/he/privacy)