بروتوكول MCP

اربط تطبيقات الذكاء الاصطناعي بحسابات Influence والوسائط والمراجعات والجدولة والإحصاءات المتاحة.

اختر نقطة النهاية المناسبة للمهمة. تتطلب أدوات المنتج صلاحية الوصول إلى مساحة عمل في Influence؛ أما خادم التوثيق، فلا يقرأ إلا الأدلة العامة.

نقطة النهاية	الغرض
`https://influence.so/api/mcp`	الاتصال العام بالمنتج، بما فيه أدوات التخطيط والصور والبحث المفعلة.
`https://influence.so/api/mcp/claude`	اتصال Claude. يشمل رفع الوسائط والمسودات والمراجعات والجدولة والتخطيط والإحصاءات؛ ويستثني أدوات توليد الصور و`search`/`fetch`.
`https://docs.influence.so/mcp`	البحث في التوثيق العام وقراءته. لا يتطلب حسابا في المنتج؛ ولا يمكنه الوصول إلى بيانات مساحة العمل أو النشر.

اتصل واستكشف الأدوات

استخدم مسار OAuth الخاص بخدمة Influence في تطبيق العميل، أو مفتاح API بصلاحيات محددة إذا كان العميل يدعم مصادقة Bearer. توفر التطبيقات والأتمتة خطوات الإعداد الخاصة بكل تطبيق عميل. احفظ مفاتيح API في بيئة أسرار تطبيق العميل.

اقرأ profileGet للتحقق من بريد Influence ومساحة العمل (nickname)، ثم connectionStatusGet للتحقق من نطاقات الصلاحيات وحصة الجدولة بالذكاء الاصطناعي. قد يستخدم تسجيل الدخول في تطبيق الذكاء الاصطناعي بريدا مختلفا. اختر هوية Influence المقصودة عند التفويض.

يتطلب تجديد OAuth موافقة صريحة على offline_access. عند إنشاء اتصال مخصص جديد في ChatGPT، تحدد تعليمات الإعداد هذا النطاق الأساسي أيضا. تحديث الأدوات لا يضيف صلاحيات ولا يوسع النطاقات الأساسية لاتصال قديم.

استخدم tools/list ومرجع أدوات MCP. قد يعرض الاستكشاف أدوات لم تمنح نطاقات صلاحياتها بعد؛ وتظل الصلاحيات مفروضة عند كل استدعاء. تؤثر الميزات المفعلة ودعم تطبيق العميل في الإتاحة. تختلف نقطة النهاية العامة عن نقطة Claude؛ ولا يثبت تنزيل مهارة أو إضافة إدراج أدواتها في تطبيق العميل المثبت.

جهز المحتوى النهائي

اقرأ accountList، ثم integrationSchema لمعرفة الإعدادات المطلوبة وحدود الوسائط لكل حساب محدد. استخدم أدوات الاستعلام المسماة الخاصة بمزود الخدمة للعثور على اللوحات والقنوات والوجهات المشابهة.
استورد ملف HTTPS متاحا باستخدام mediaImport مع url وname اختياريا. يستخدم الملف الحقيقي الذي توفره البيئة المضيفة كائن file المنفصل؛ ولا تختلق معرفات ملفات. للملفات المحلية، استخدم أدوات الرفع متعدد الأجزاء أو الأداة المساعدة الموجودة في SDK أو واجهة سطر الأوامر. تسري حدود الوسائط وشروط جاهزيتها.
عند تجهيز 1–10 منشورات مكتملة للجدولة، استخدم campaignScheduleBatchReview مع itemKey ثابت وdraft وscheduledFor لكل عنصر. تحفظ الأداة المسودات والمراجعات المعلقة معا، مع نصوص ووسائط خاصة بكل وجهة وبحد أقصى 50 عملية تسليم. للعمل على المسودات فقط أو لإجراء تعديلات، استخدم campaignDraftSave؛ وتحضر campaignReview الإجراء المقصود لحملة محفوظة.
اعرض المراجعة المحفوظة كاملة. تعرضها البطاقة الظاهرة بعد اكتمال تحميلها؛ وعند عدم وجود بطاقة، اعرض الحسابات والنص ومعاينات الوسائط أو روابطها والإعدادات وموعد الجدولة والمنطقة الزمنية كما حفظت تماما. اقرأ campaignReviewGet إذا كانت المراجعة مفقودة أو لم تعد صالحة للحالة الحالية أو كان وضعها غير مؤكد.
احصل على موافقة بشرية صريحة وحديثة قبل التنفيذ. تتضمن البطاقة المدعومة زر الموافقة الخاص بها. للمنشورات الاجتماعية المؤهلة، ترسل الموافقة عبر المحادثة باستخدام campaignReviewExecute أو campaignScheduleBatchExecute. يجب ألا يستدعي النموذج إجراء واجهة المستخدم الخاص campaignReviewApprove.

يدعم النشر المباشر على TikTok المحادثة النصية. اقرأ tiktokCreatorInfoGet، ثم اطرح سؤالا واحدا مجمعا عن الخيارات التي لم تحسم بعد: الظهور والتفاعلات والترويج وخيارات الذكاء الاصطناعي والموسيقى المنطبقة على الحالة. اعرض صياغة الموافقة وروابطها بحسب ما ينطبق؛ ولا تفترض الموافقة أو تتيح التفاعلات المقيدة. احفظ خيارات الشخص كاملة باستخدام campaignReview مع reviewId وعناصر tiktokSettings التي تتضمن connectionId وsettings. يعيد ذلك مراجعة معلقة جديدة، ولا يمنح الموافقة. اعرض هذه المراجعة كما هي وانتظر موافقة صريحة حديثة قبل التنفيذ. تظل بطاقة المراجعة المدعومة اختيارية. تكتمل عملية النشر عبر صندوق وارد TikTok داخل TikTok.

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

التأكيد والتعامل مع النتائج غير المؤكدة

عند استخدام أداة موسومة بأنها تتطلب تأكيدا، حضر الطلب أولا دون _confirmationCapability أو _idempotencyKey. ثم أكد مدخلات العمل نفسها باستخدام قيمة التأكيد المعادة ومفتاح ثابت لمنع التكرار ينشئه المستدعي. يحفظ هذا التبادل ما تحدده الأداة أو ينفذ الإجراء الذي تنص عليه؛ وهو مستقل عن الموافقة البشرية على النشر. التزم بطلبات الإذن التي تعرضها البيئة المضيفة.

تتابع mediaUploadPart وmediaUploadComplete وmediaUploadAbort عملية رفع مصرحا بها مباشرة. انقل بايتات الملف إلى عناوين URL التخزينية المعادة، وليس ضمن JSON الخاص بالأداة. بعد الانقطاع، اقرأ حالة الرفع واستأنف بالملف نفسه وقيمة clientKey نفسها.

تمثل expiresAt للرفع المهلة الحالية للنقل أو المعالجة: تكون في البداية 24 ساعة، ثم 15 دقيقة بعد بدء المعالجة عند إكمال الرفع. لا تنتهي صلاحية الوسائط الجاهزة بانتهاء هذه المهلة؛ أعد استخدام assetId الخاص بها من مكتبة الوسائط.

احتفظ بقيم التأكيد وإعادة المحاولة بعد عدم تأكد النتيجة. اقرأ المراجعة أو الحملة المحفوظة قبل إعادة محاولة إجراء نشر؛ ولا تفترض أن انتهاء المهلة يعني أن شيئا لم يحدث. تحتاج المراجعة المعدلة أو المنتهية الصلاحية إلى مراجعة جديدة وموافقة جديدة.

تسري حدود الجدولة بالذكاء الاصطناعي على جميع عملاء MCP وInfluence IQ. تستثنى الأتمتة العادية عبر HTTP وواجهة سطر الأوامر، وكذلك الجدولة اليدوية عبر الويب. يوضح قسم الإحصاءات نطاق التغطية وآلية التحديث. تتطلب اشتراكات الأحداث الاختيارية دعما منفصلا مفعلا في البيئة المضيفة؛ ولا تمثل وعدا عاما بإشعارات تعمل في الخلفية لدى كل تطبيق عميل.