# خادم Embroidery MCP لوكلاء الذكاء الاصطناعي

الصفحة القانونية: https://embroideryfileconverter.com/ar/ai-agents

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

## اختر التكامل المناسب

- استخدم خادم MCP البعيد هذا عندما يحتاج مساعد الذكاء الاصطناعي إلى التصرف نيابة عن مستخدم عبر OAuth المعتمد من المتصفح.
- استخدم [REST Developer API](https://embroideryfileconverter.com/ar/developers) للخلفية التقليدية أو منتج 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 على الويب، فعّل وضع المطور في الإعدادات > التطبيقات > الإعدادات المتقدمة، أو افتح إعدادات مساحة العمل > التطبيقات > إنشاء.
2. أنشئ تطبيقاً واضبط عنوان URL لخادم 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. يضيف مالكو الفرق والمؤسسات الموصل ضمن إعدادات المؤسسة > الموصلات قبل اتصال الأعضاء بشكل فردي.

أمر 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

يجب أن تكمل الخلفية الخاصة بك رمز تفويض 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`

يقبل تسجيل العميل الديناميكي فقط أصول رد الاتصال والمخططات الأصلية المسموح بها صراحة من المشغل. تُرفض نطاقات رد الاتصال التعسفية. يجب أن يكون للحساب عنوان بريد إلكتروني موثق قبل استخدام نقطة نهاية 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[]` مع حقول قابلة للقراءة وقابلة للكتابة والتسمية والتحذيرات. استدعه قبل اختيار سير العمل أو تنسيق الهدف.

### `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`. استطلع مع التراجع وتوقف عند حالة نهائية. تتطلب عناوين الملفات رمز وصول OAuth نفسه وتبقى خاضعة لتاريخ الاحتفاظ `expiresAt` للتحميل.

## أمثلة مطالبات باللغة الطبيعية

- “تحقق أي التنسيقات تقرأ PES وتكتب JEF بأمان. أظهر تحذيرات التوافق.”
- “اسرد أحدث خمس مهام تطريز لدي ولخص أي فشل.”
- “قبل الرفع، اطلب مني التأكيد. ثم رقمن logo.png بعرض 90 مم وبحد أقصى 8 ألوان وأعد معاينة PES.”
- “استطلع المهمة 01J… حتى تنتهي، ثم أبلغ عن مقاييس الغرز والتحذيرات وما إذا كان التنزيل مفتوحاً بالفعل.”

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

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

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

- `401 Unauthorized`: لم يُرسل رمز وصول صالح؛ أعد تشغيل اتصال OAuth للعميل.
- `403 Forbidden`: يفتقر الرمز إلى `mcp:use`، أو الحساب غير موثق، أو المهمة المطلوبة تخص حساباً آخر.
- `invalid_redirect_uri`: أصل الاستدعاء أو المخطط الأصلي غير مدرج في قائمة السماح بالخادم.
- `422`: فشل التحقق من وسائط الأداة أو بيانات base64 أو نوع المصدر أو تنسيق الهدف أو حصة الحساب.
- `429`: تجاوز حد المعدل؛ احترم `Retry-After` واستخدم التراجع الأسي مع التباين.

## الصفحات ذات الصلة

- [توثيق واجهة برمجة التطبيقات للمطورين](https://embroideryfileconverter.com/ar/developers)
- [وصف OpenAPI 3.1](https://embroideryfileconverter.com/developers/openapi.json)
- [سياسة الخصوصية](https://embroideryfileconverter.com/ar/privacy)