الانتقال إلى المحتوى الرئيسي
يتيح خادم MCP من Ayrshare لوكيل الذكاء الاصطناعي تشغيل واجهة برمجة تطبيقات Ayrshare. تشرح هذه الصفحة كيفية الاتصال به وكيفية عمل المصادقة.

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

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

​
المصادقة

يتم فرض المصادقة بواسطة سلسلة 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.

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

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

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

مكوّن Claude Code

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