خادم MCP — وثائق ناشر

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

يوفّر ناشر خادم 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 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 بعد.