MCP מרוחק · v1.0OAuth 2.1 + PKCE

תן לסוכני AI כלי רקמה.

חבר עוזרים לגילוי תבניות, שימוש בחשבון ועבודות עיבוד פרטיות—בשם משתמש, עם אישור דפדפן וללא כלי חיוב או אישורים.

נקודת קצה HTTP ניתנת להזרמה

https://embroideryfileconverter.com/mcp/embroidery

כלים

5

היקף

mcp:use

קצב קריאה

60/min

המשתמש נכנס, מאמת את הדוא"ל שלו ומאשר גישה בדפדפן. הסוכן מקבל אסימון מוגבל בהיקף—לא את סיסמת המשתמש או מפתח API.

תאימות לקוח

בחר את הסוכן שלך. העתק את ההגדרות שלו.

השתמש במדריכים הבאים עבור ChatGPT, Claude, OpenAI Agents SDK, Cursor, VS Code, OpenClaw, Gemini CLI, OpenCode, Windsurf ו-Cline. כל מדריך מזהה אם OAuth מקורי, מנוהל על ידי מפתח או דורש גשר שנבדק.

לוגו OpenAI
OAuth מקומיChatGPT web · הגדרות → אפליקציות

התחבר ChatGPT

צור אפליקציית MCP מותאמת אישית במצב מפתחים של ChatGPT ותן ל-ChatGPT לגלות את הכלים ומטה-נתוני ה-OAuth.

  1. 1הפעל מצב מפתחים בהגדרות → אפליקציות → הגדרות מתקדמות, או פתח הגדרות Workspace → אפליקציות → צור.
  2. 2צור אפליקציה, הדבק את נקודת הקצה של MCP ובחר אימות OAuth.
  3. 3בחר סריקת כלים, אשר גישה בדפדפן, ואז צור והפעל את טיוטת האפליקציה.
תיעוד MCP רשמי של ChatGPT
התקנת ChatGPT · ערכי חיבור
MCP server URL: https://embroideryfileconverter.com/mcp/embroidery
Authentication: OAuth
Required scope: mcp:use

השתמש ב-OAuth של הדפדפן ובקש רק mcp:use. לעולם אל תמקם סיסמה, אסימון רענון או bearer token ארוך-חיים במאגר.

תמיכה מלאה בכלי כתיבה מיועדת למרחבי עבודה של ChatGPT Business ו-Enterprise/Edu. זמינות ובקרות מנהל משתנות לפי תוכנית.

Streamable HTTPקוד אישור OAuth + PKCEנתונים פרטיים לכל משתמש

אם הלקוח שלך לא יכול לפתוח OAuth

אשר שהוא תומך בשרתי MCP HTTP ניתנים להזרמה מרוחקים ובגילוי משאבים מוגנים. לקוח stdio-בלבד מקומי אינו יכול להתחבר לנקודת קצה זו ללא גשר תואם.

אימות

קוד אימות OAuth + PKCE.

השרת מפרסם מטא-נתונים מבוססי תקנים, דורש S256 PKCE וחושף היקף אחד בזכויות מינימליות. רישום דינמי זמין רק עבור מקורות callback המותרים על ידי המפעיל וסכמות מקוריות.

משאב מוגן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, והמשתמש המחובר חייב להיות בעל כתובת דוא"ל מאומתת.

הפניית כלים

חמישה כלים, גבולות מפורשים.

list-formats-tool

מציג מקורות רקמה לקריאה, פלטי מכונה לכתיבה, סוגי קלט יצירה ואזהרות תאימות.

קריאה בלבד

ארגומנטים

  • ללא ארגומנטים

תוצאה מובנית

artwork_inputs[] ו-formats[]

get-account-usage-tool

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

קריאה בלבד

ארגומנטים

  • ללא ארגומנטים

תוצאה מובנית

אובייקט שימוש

list-processing-jobs-tool

מציג עבודות המרה ודיגיטציה אחרונות שבבעלות החשבון המחובר.

קריאה בלבד

ארגומנטים

  • limit: מספר שלם, 1–50, ברירת מחדל 20

תוצאה מובנית

jobs[] עם סטטוס, קבצים ומדדים

get-processing-job-tool

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

קריאה בלבד

ארגומנטים

  • 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 מ"מ עם לא יותר מ-8 צבעים והחזר תצוגה מקדימה של PES.

הנחיה 4

סקור את העבודה 01J… עד שהיא מסתיימת, ואז דווח על מדדי תפרים, אזהרות והאם הורדה כבר נפתחה.

מודל בטיחות

גישה שימושית ללא סמכות תשלום.

אין כלי חיוב

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

אין כלי אישורים

הסוכן אינו יכול להנפיק מפתחות API, לשנות אימות או לאחזר חומר סודי.

נתונים בבעלות בלבד

כל שאילתת עבודה מוגבלת למשתמש המחובר לפני החזרת פרטים.

פלט לא מהימן נשאר נתונים

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

יצירת תצוגה מקדימה משנה מצב

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

תצוגה מקדימה אינה אישור ייצור

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

פתרון תקלות

אבחן כשלי חיבור במהירות.

401 Unauthorized

לא נשלח אסימון גישה תקף. הפעל מחדש את חיבור ה-OAuth של הלקוח.

403 Forbidden

האסימון חסר mcp:use, החשבון לא מאומת, או שהעבודה שייכת למשתמש אחר.

invalid_redirect_uri

מקור ה-callback של הלקוח או הסכימה המקומית אינם ברשימת ההיתרים של השרת.

422 tool error

ארגומנטים, נתוני base64, סוג מקור, פורמט יעד או מכסת חשבון נכשלו באימות.

429 Too Many Requests

כלי קריאה מאפשרים 60 בקשות לדקה כברירת מחדל; כלי יצירת הקבצים מאפשר 6. כבד את Retry-After.

הימנע מסקרים אגרסיביים

סקור עבודות ממתינות ומעובדות עם backoff. הפסק כאשר הסטטוס הופך ל completed או failed.

קובץ פרטי שפג תוקפו

כתובות URL של קבצים דורשות את אותו אסימון גישת OAuth ונשארות כפופות ל expiresAt תאריך השמירה. אל תתייחס לכתובות URL כמזהי קבצים קבועים.

בונה אפליקציה קונבנציונלית?

השתמש ב-REST API עם היקפים.

מדריך ה-REST כולל ניהול מפתחות API, דוגמאות multipart בשלוש שפות, כל נקודת קצה, מחזור חיי תגובה ו-OpenAPI 3.1.

פתח מסמכי REST API