# خادم MCP

اربط ناشر بمساعدك البرمجي عبر Model Context Protocol — جدولة ونشر وتحليلات من داخل محادثتك.

[English](/en/mcp)

يوفّر ناشر خادم **MCP** (Model Context Protocol) يتيح لمساعد ذكاء اصطناعي — مثل Claude — أن يقرأ حساباتك ويكتب منشوراتك ويجدولها نيابةً عنك بأمان. متاح في باقتَي **الفِرق** و**الوكالات**.

## [نقطة الاتصال](#نقطة-الاتصال)

|          |                                                   |
| -------- | ------------------------------------------------- |
| العنوان  | https://api.naasher.com/api/mcp                   |
| النقل    | Streamable HTTP                                   |
| المصادقة | ترويسة x-naasher-api-key أو Authorization: Bearer |

العملاء المتوافقون مع OAuth يمكنهم بدء الربط من عنوان MCP مباشرةً؛ يعيد رد `401` ترويسة `WWW-Authenticate` التي تشير إلى بيانات المورد المحمي، ومنها يكتشف العميل خادم التفويض والتسجيل الديناميكي وPKCE تلقائيًا. يربط المستخدم التفويض بمساحة عمل محددة، وتبقى النطاقات محكومة بصلاحيات عضويته الحالية.

## [الإعداد في Claude Code](#الإعداد-في-claude-code)

```
claude mcp add naasher --transport http https://api.naasher.com/api/mcp \
  --header "x-naasher-api-key: $NAASHER_API_KEY"
```

أو أضِفه يدويًا إلى ملف إعدادات عميلك:

```
{
  "mcpServers": {
    "naasher": {
      "type": "http",
      "url": "https://api.naasher.com/api/mcp",
      "headers": { "x-naasher-api-key": "YOUR_KEY" }
    }
  }
}
```

## [الأدوات المتاحة](#الأدوات-المتاحة)

| الأداة             | ما تفعله                        | النطاق المطلوب |
| ------------------ | ------------------------------- | -------------- |
| channels.list      | يسرد الحسابات المتصلة           | channels:read  |
| posts.list         | يسرد المنشورات مع الفلاتر       | posts:read     |
| posts.create       | ينشئ منشورًا (مسودة أو مجدولًا) | posts:create   |
| posts.schedule     | يجدول منشورًا موجودًا           | posts:schedule |
| analytics.overview | يعرض ملخّص الأداء               | analytics:read |

يحترم الخادم نطاقات المفتاح: أداة خارج نطاق مفتاحك لا تظهر أصلًا في `tools/list`.

## [مثال عملي](#مثال-عملي)

بعد الربط، اطلب من مساعدك بالعربية مباشرة:

> «اعرض حساباتي المتصلة، ثم أنشئ مسودة منشور عن إطلاق منتجنا الجديد لحساب لينكدإن، وجدولها الأحد القادم الساعة 9 صباحًا.»

سيستدعي المساعد `channels.list` ثم `posts.create` ثم `posts.schedule` بالترتيب، ويعرض لك النتيجة قبل التنفيذ.

## [إصدارات البروتوكول](#إصدارات-البروتوكول)

يدعم الخادم إصدارات البروتوكول `2025-11-25` و`2025-06-18` و`2025-03-26`. أثناء `initialize` يردّ الخادم بإصدارك إن كان مدعومًا، وإلا بأحدث إصدار لديه — فتعمل العملاء القديمة والحديثة معًا دون تعديل.

اكتشاف تلقائي

ينشر الخادم بيانات المورد المحمي على `/.well-known/oauth-protected-resource` و`/.well-known/oauth-protected-resource/api/mcp`، فتتمكن العملاء المتوافقة من اكتشاف خادم التفويض والنطاقات المطلوبة تلقائيًا. يبقى مفتاح API خيارًا مباشرًا للعملاء التي لا تدعم تدفق OAuth بعد.

[دورة حياة واجهة Naasher APIسياسة إصدارات واجهة ناشر البرمجية، والتوافق، والإهمال التدريجي، ومواعيد الإيقاف.](/api-lifecycle)[الويب هوكساستقبل أحداث ناشر في أنظمتك مع توقيع HMAC موثوق، وتحقّق منه بأمان.](/webhooks)

---

Canonical URL: https://docs.naasher.com/mcp