Skip to main content
يتيح خادم MCP من Ayrshare لوكيل الذكاء الاصطناعي تشغيل واجهة برمجة تطبيقات Ayrshare. تشرح هذه الصفحة كيفية الاتصال به وكيفية عمل المصادقة.

​
نقطة النهاية والنقل

يتوفر خادم MCP للإنتاج على: https://api.ayrshare.com/mcp يستخدم النقل Streamable HTTP وهو عديم الحالة — لا توجد جلسة يجب الحفاظ عليها بين المكالمات.

​
العملاء المدعومون

يصادق خادم Action MCP فقط باستخدام ترويسة طلب ثابتة Authorization: Bearer. هذا المتطلب الوحيد يحدد كل ما يلي: العميل الذي يمكنه تعيين ترويسة HTTP مخصصة على اتصال Streamable HTTP يمكنه المصادقة، والعميل الذي لا يمكنه ذلك لا يمكنه المصادقة. اعثر على عميلك قبل أن تبدأ الإعداد.

​
لماذا لا يمكن للموصلات الشخصية المصادقة

يتطلب Action MCP من Ayrshare ترويسة Authorization: Bearer ثابتة. إضافته كموصل مخصص شخصي على claude.ai أو Claude Desktop أو Claude mobile لا تعمل، لأن Ayrshare لا تنشر أي بيانات وصفية لـ OAuth، وبديل ترويسة الطلب هو ميزة بيتا مقصورة على المؤسسات المعتمدة. في الموصل الشخصي، لا يوجد إعداد من جانبك يحل هذه المشكلة: لا يوجد حقل لترويسة Authorization، ولا يوجد مفتاح API أو ملف شخصي أو إعداد حساب يتيح ذلك. لا تنشر Ayrshare بيانات وصفية لـ OAuth، لذا لا يوجد ما يتصل به مسار OAuth الخاص بالموصل. استخدم بدلاً من ذلك عميلاً من الجدول أعلاه: Claude Code، أو مكوّن Claude Code، أو أي عميل يتيح لك تعيين ترويسة Authorization مخصصة. إذا كنت مسؤولاً عن مؤسسة مشمولة في بيتا ترويسة الطلب من Anthropic، فراجع مؤسسات Team وEnterprise أدناه.
إذا كان موصلك يبدو سليمًا لكن كل أداة تفشل. يُضاف الموصل بنجاح، ويُبلغ بأنه سليم، ويعرض كتالوج الأدوات الكامل — ثم تُرجع كل مكالمة أداة خطأ Ayrshare 403 / رمز 102، “API Key not valid”. هذا هو ذلك القيد، وليس مفتاحًا معطلاً — عميلك لا يمكنه إرسال ترويسة Authorization: Bearer الثابتة التي يتطلبها هذا الخادم. يمكن الوصول إلى initialize وtools/list قبل المصادقة (راجع المصادقة أدناه)، لذا لا يفشل شيء حتى أول مكالمة أداة، حين يتضح أنه لم تُرسل أي بيانات اعتماد على الإطلاق.قدرة العميل، أم مفتاح سيئ بالفعل؟ كلاهما يُرجع الخطأ نفسه، لذا استخدم النمط المميز للتفريق بينهما. فشل قدرة العميل يعني أن الموصل سليم وكل أداة تفشل، بينما يعمل المفتاح نفسه في مكان آخر. أما المفتاح السيئ فيُنتج الخطأ نفسه لكنه قابل للتكرار خارج الموصل — إذ يفشل في مكالمة REST أيضًا. لدلالات الخطأ نفسها، راجع أخطاء المصادقة أدناه.

​
مؤسسات Team وEnterprise

تتيح آلية static_headers من Anthropic لموصل مخصص إرسال بيانات اعتماد ثابتة كترويسة طلب بدلاً من استخدام OAuth. وهي متاحة في مرحلة بيتا لمسؤولي المؤسسات في مجموعة محدودة من المؤسسات، وهي غير متاحة للمستخدمين الأفراد الذين يضيفون موصلاً شخصيًا. إذا كانت مؤسستك تملك حق الوصول، فيجب على المسؤول إدخال قيمة الترويسة كـ Bearer متبوعة بمفتاح Ayrshare API الخاص بك، بما في ذلك المسافة — يرسل Claude القيمة تمامًا كما أُدخلت ولا يضيف المخطط نيابة عنك. للاطلاع على التوفر الحالي والإعداد، راجع توثيق مصادقة الموصلات من Anthropic.
المفتاح مشترك بين المؤسسة بأكملها. تُدخَل بيانات اعتماد ترويسة الطلب من Anthropic مرة واحدة بواسطة مسؤول ويستخدمها كل عضو في المؤسسة، لذا يتصرف جميعهم كحساب Ayrshare الوحيد الذي ينتمي إليه ذلك المفتاح — مع إمكانية الوصول إلى كل User Profile تحته على مفتاح Business، وبدون إسناد لكل مستخدم في سجل Ayrshare أو تحليلاته. تعامل معه كبيانات اعتماد خدمة مشتركة، وليس كوصول فردي.

​
المصادقة

يتم فرض المصادقة بواسطة سلسلة Ayrshare API نفسها التي تشغل REST API.
  • مطلوب: Authorization: Bearer YOUR_API_KEY — مفتاح API الخاص بحسابك (مفتاح خطة Business للملفات الشخصية والملفات الفرعية).
  • اختياري: Profile-Key: YOUR_PROFILE_KEY — يستهدف ملفًا فرعيًا لكل مكالمة على الاتصال.
  • اختياري لكل مكالمة: وسيطة أداة profileKey — تستهدف ملفًا فرعيًا لمكالمة أداة واحدة.

​
الأسبقية: الوسيطة تتفوق على الترويسة

عندما تتضمن مكالمة أداة وسيطة profileKey و يحتوي الاتصال على ترويسة Profile-Key، فإن وسيطة profileKey لكل مكالمة تفوز. يتم استخدام الترويسة فقط عندما لا يتم توفير وسيطة صالحة. استثناء واحد: في get_platform_history وget_social_network_analytics، يجب أن يستخدم البحث عن userId/userName في X/Twitter مفتاح API الخاص بالحساب فقط؛ توفير وسيطة profileKey أو ترويسة Profile-Key هناك يُرجع الخطأ 400.
يمكن الوصول إلى طريقتي MCP initialize وtools/list قبل المصادقة — فهما تُرجعان البيانات الوصفية فقط ولا تنفذان شيئًا. يتم مصادقة كل مكالمة أداة.

​
أخطاء المصادقة

يُرجع مفتاح غير مصادق أو غير صالح في مكالمة أداة خطأ Ayrshare 403 / رمز 102 مع الرسالة “API Key not valid”. وفقًا لمواصفة MCP، يتم إرجاع أخطاء تنفيذ الأداة داخل النطاق: تحمل نتيجة الأداة isError: true وهذه الرسالة، بينما يستجيب نقل MCP نفسه بـ HTTP 200. (يعد 403/102 خطأ تطبيق Ayrshare، وليس حالة النقل.)

​
الاتصال

​
الخيار أ: مكوّن Claude Code

إذا كنت تستخدم Claude Code، فقم بتثبيت مكوّن Ayrshare. يجمع تكوين خادم MCP وأمر الإعداد والوكلاء والمهارات وخطاف التأكيد. راجع صفحة مكوّن Claude Code لخطوات التثبيت الكاملة.

​
الخيار ب: أي عميل MCP

لأي عميل MCP يدعم Streamable HTTP ويتيح لك تعيين ترويسة طلب مخصصة — راجع العملاء المدعومون أعلاه — سجل الخادم مباشرة. في Claude Code:
لاستهداف ملف فرعي عند كل مكالمة، أضف ترويسة Profile-Key الاختيارية:
يتم تهيئة اتصال MCP في بداية الجلسة. أعد تشغيل عميل MCP بعد تثبيت الخادم أو تغيير المفتاح حتى يسري التكوين الجديد.

​
بيانات اعتماد X/Twitter الخاصة بك (BYO)

منذ 31 مارس 2026، تتطلب عمليات X/Twitter عبر Ayrshare بيانات اعتماد OAuth 1.0a الخاصة بك. عندما تستهدف مكالمة أداة X/Twitter، مرر هاتين الترويستين على الاتصال إلى جانب ترويسة Authorization (وProfile-Key الاختيارية): هذه هي نفس الترويسات المستخدمة من قبل REST API — زوج مفاتيح OAuth 1.0a واحد لكل حساب Ayrshare، يُرسل في كل طلب يستهدف X (ينطبق نفس الزوج على جميع الملفات الفرعية). لا تستخدم Ayrshare OAuth 2.0 هنا. راجع نظرة عامة على API ودليل إعداد مفتاح X BYO للإعداد والسياسة واستكشاف الأخطاء وإصلاحها.
بدون هذه الترويسات، تُرجع مكالمة أداة X/Twitter الخطأ 419 (x_credentials_required).

​
الاتصال باستخدام ترويسات BYO

لإعداد بيانات اعتماد X/Twitter BYO من البداية، أضف الخادم مع كلتا ترويستي OAuth 1.0a إلى جانب ترويسة Authorization (أضف Profile-Key أيضًا إذا كنت تستهدف ملفًا فرعيًا عند كل مكالمة):

​
إضافة ترويسات BYO إلى اتصال موجود

يتم تثبيت ترويسات الاتصال عند إضافة الخادم، لذا إذا كنت قد اتصلت بالفعل بدون ترويسات BYO، فأزل الخادم وأعد إضافته بالمجموعة الكاملة (أعد تضمين أي ترويسات كنت تستخدمها بالفعل، مثل Profile-Key):
أعد تشغيل عميل MCP بعد تغيير الترويسات حتى يسري التكوين الجديد. هل تستخدم مكوّن Claude Code بدلاً من الاتصال الخام؟ راجع مكوّن Claude Code ← بيانات اعتماد X/Twitter BYO.

​
الخطوات التالية

كتالوج الأدوات

الأدوات الـ 33 مجمعة حسب المجال، مع النطاق والغرض.

مكوّن Claude Code

قم بتثبيت مكوّن Ayrshare لـ Claude Code.