MCP البعيد · الإصدار 1.0OAuth 2.1 + PKCE

امنح وكلاء الذكاء الاصطناعي أدوات التطريز.

اربط المساعدين باكتشاف التنسيقات واستخدام الحساب ومهام المعالجة الخاصة—نيابة عن المستخدم، بموافقة المتصفح وبدون أدوات فوترة أو بيانات اعتماد.

نقطة نهاية HTTP قابلة للبث

https://embroideryfileconverter.com/mcp/embroidery

الأدوات

5

النطاق

mcp:use

معدل القراءة

60/min

يسجل المستخدم الدخول ويتحقق من بريده الإلكتروني ويوافق على الوصول في المتصفح. يتلقى الوكيل رمزاً محدد النطاق—وليس كلمة مرور المستخدم أو مفتاح واجهة برمجة التطبيقات.

توافق العميل

اختر وكيلك. انسخ إعداده.

استخدم الأدلة أدناه لـ ChatGPT وClaude وOpenAI Agents SDK وCursor وVS Code وOpenClaw وGemini CLI وOpenCode وWindsurf وCline. يحدد كل دليل ما إذا كان OAuth أصلياً أو مُداراً من المطور أو قد يتطلب جسر مراجعة.

OpenAI logo
OAuth الأصليChatGPT web · الإعدادات ← التطبيقات

اتصال ChatGPT

أنشئ تطبيق MCP مخصصاً في وضع مطور ChatGPT ودع ChatGPT يكتشف الأدوات وبيانات OAuth الوصفية.

  1. 1فعّل وضع المطور في الإعدادات ← التطبيقات ← الإعدادات المتقدمة، أو افتح إعدادات مساحة العمل ← التطبيقات ← إنشاء.
  2. 2أنشئ تطبيقاً، والصق نقطة نهاية MCP، واختر مصادقة OAuth.
  3. 3اختر فحص الأدوات، ووافق على الوصول في المتصفح، ثم أنشئ التطبيق المسودة وفعّله.
وثائق ChatGPT MCP الرسمية
إعداد ChatGPT · قيم الاتصال
MCP server URL: https://embroideryfileconverter.com/mcp/embroidery
Authentication: OAuth
Required scope: mcp:use

استخدم OAuth المتصفح واطلب فقط mcp:use. لا تضع كلمة مرور أو رمز تحديث أو رمز bearer طويل الأمد في مستودع أبداً.

دعم أدوات الكتابة الكامل مخصص لمساحات عمل ChatGPT Business وEnterprise/Edu. يختلف التوفر وضوابط المشرف حسب الخطة.

Streamable HTTPرمز تفويض OAuth + PKCEبيانات خاصة لكل مستخدم

إذا لم يتمكن عميلك من فتح OAuth

تأكد من دعمه لخوادم MCP البعيدة القابلة للبث عبر HTTP واكتشاف الموارد المحمية. لا يمكن للعميل المحلي الذي يدعم 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, ويجب أن يكون للمستخدم المتصل عنوان بريد إلكتروني موثق.

مرجع الأدوات

خمس أدوات، حدود واضحة.

list-formats-tool

يسرد مصادر التطريز القابلة للقراءة ومخرجات الماكينة القابلة للكتابة وأنواع مدخلات العمل الفني وتحذيرات التوافق.

للقراءة فقط

الوسائط

  • بلا وسائط

النتيجة المهيكلة

artwork_inputs[] و formats[]

get-account-usage-tool

يعيد بدل المعاينة ورصيد الائتمان وتكاليف سير العمل وحدود الاشتراك وتواريخ إعادة التعيين.

للقراءة فقط

الوسائط

  • بلا وسائط

النتيجة المهيكلة

كائن الاستخدام

list-processing-jobs-tool

يسرد وظائف التحويل والرقمنة الأخيرة المملوكة للحساب المتصل.

للقراءة فقط

الوسائط

  • limit: عدد صحيح، 1–50، الافتراضي 20

النتيجة المهيكلة

jobs[] مع الحالة والملفات والمقاييس

get-processing-job-tool

يجلب وظيفة مملوكة واحدة مع الأحداث والتحذيرات والمقاييس ومعاينات المعاينة وعناوين URL للملفات المحمية بـ OAuth.

للقراءة فقط

الوسائط

  • workflow: conversion | digitising
  • job_id: معرف الوظيفة المكون من 26 حرفاً

النتيجة المهيكلة

كائن الوظيفة

create-processing-job-tool

ينشئ معاينة خاصة واحدة للتحويل أو الرقمنة الآلية من ملف مشفر بـ base64 قياسي.

ينشئ البيانات

الوسائط

  • workflow: conversion | digitising
  • 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… حتى تنتهي، ثم أبلغ عن مقاييس الغرز والتحذيرات وما إذا كان التنزيل مفتوحاً بالفعل.

نموذج السلامة

وصول مفيد بدون سلطة دفع.

لا توجد أدوات فوترة

لا يتم عرض أدوات الشراء أو الدفع أو استهلاك الرصيد عبر فتح القفل الصريح أو فتح التنزيل المدفوع.

لا توجد أدوات بيانات اعتماد

لا يمكن للوكيل إصدار مفاتيح واجهة برمجة التطبيقات أو تغيير المصادقة أو استرداد مواد سرية.

البيانات المملوكة فقط

تُقيد كل استعلامات المهام بالمستخدم المتصل قبل إعادة التفاصيل.

يبقى الإخراج غير الموثوق بيانات

تخبر تعليمات الخادم الوكلاء بعدم اتباع الأوامر المضمنة في أسماء الملفات أو البيانات الوصفية أو رسائل المهام أو التحذيرات.

إنشاء المعاينة يغير الحالة

تخزن أداة الإنشاء رفعاً خاصاً وتنشئ مهمة ويمكنها استهلاك رصيد المعاينة. تُحدد بشكل منفصل إلى 6 طلبات في الدقيقة لكل مستخدم، مع حد شبكة إضافي. يوجه الخادم الوكيل إلى سؤال المستخدم قبل الرفع.

المعاينة ليست موافقة إنتاج

يضبط استدعاء الأداة الناجح billing_authorized: false. يجب ألا يدّعي الوكلاء أن التصميم جاهز للإنتاج قبل الإكمال وفحص المقاييس والتحذيرات.

استكشاف الأخطاء وإصلاحها

تشخيص أعطال الاتصال بسرعة.

401 Unauthorized

لم يُرسل رمز وصول صالح. أعد تشغيل اتصال OAuth الخاص بالعميل.

403 Forbidden

يفتقر الرمز إلى mcp:use، أو الحساب غير موثَّق، أو المهمة تخص مستخدماً آخر.

invalid_redirect_uri

أصل رد الاتصال للعميل أو المخطط الأصلي غير مدرج في قائمة السماح بالخادم.

422 tool error

فشل التحقق من الوسائط أو بيانات base64 أو نوع المصدر أو تنسيق الهدف أو حصة الحساب.

429 Too Many Requests

تسمح أدوات القراءة بـ 60 طلبات في الدقيقة افتراضياً؛ وتسمح أداة إنشاء الملفات بـ 6. احترم Retry-After.

تجنب الاستطلاع المكثف

استطلع المهام في قائمة الانتظار والمعالجة بتراجع. توقف عندما تصبح الحالة completed أو failed.

ملف خاص منتهي الصلاحية

تتطلب عناوين URL للملفات نفس رمز وصول OAuth وتظل خاضعة لـ expiresAt تاريخ الاحتفاظ. لا تعامل عناوين URL كمعرفات ملفات دائمة.

هل تبني تطبيقاً تقليدياً؟

استخدم واجهة REST API ذات النطاق المحدد.

يغطي دليل REST إدارة مفاتيح API وأمثلة متعددة الأجزاء بثلاث لغات وكل نقطة نهاية ودورة حياة الاستجابة وOpenAPI 3.1.

فتح توثيق REST API