AiVideoEditor
ابدأ مجانًا
القائمة

رُوجع 2026-11-10 · إصدار API 2026-11-09 · قراءة Markdown

إعداد MCP

خادم MCP محلي عبر stdio يغلّف الخدمات المشتركة نفسها المستخدمة في واجهة المستخدم وواجهة REST API عبر /api/v1. يرسل المحوّل مفتاح منتجك فقط إلى واجهة AiVideoEditor API المكوَّنة. لا تُستخدم بيانات اعتماد Supabase أو المزودين.

المتطلبات المسبقة

هذا محوّل من شيفرة مصدرية، وليس حزمة منشورة أو اتصالًا مستضافًا. احصل على وصول مصرَّح به إلى مستودع AiVideoEditor، وثبّت Node 22+، وشغّل npm ci في جذر المستودع. أنشئ مفتاح منتج لمساحة العمل في /app/developers بالنطاقات المطلوبة فقط وبوصول الوجهات المطلوب. مفتاح المسودات فقط لا يستطيع النشر أو الجدولة. لا تلصق المفتاح أبدًا في مطالبة دردشة.

تشغيله

export PUBLISHER_API_URL=https://app.example.com   # HTTPS; http://localhost is allowed for dev
export PUBLISHER_API_KEY=pk_v1_…                   # create in /app/developers
node packages/mcp/bin/publisher-mcp.mjs            # or: npm start --workspace packages/mcp

الملف التنفيذي مشغّل حقيقي (TypeScript + استيراد بلا امتدادات تُحل عبر tsx). كل التشخيصات تذهب إلى stderr؛ ويحمل stdout حركة البروتوكول فقط. يجب أن يكون PUBLISHER_API_URL بصيغة HTTPS (HTTP عادي فقط لتطوير loopback) ويجب ألا يحمل بيانات اعتماد أو استعلامات أو أجزاء تقطيع.

تكوين عميل عام

{
  "mcpServers": {
    "autoposted": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp/bin/publisher-mcp.mjs"],
      "env": {
        "PUBLISHER_API_URL": "https://app.example.com",
        "PUBLISHER_API_KEY": "pk_v1_…"
      }
    }
  }
}

يتطلب المشغّل Node 22+ وتبعيات مساحة العمل (tsx و@modelcontextprotocol/sdk). نقل MCP مستضاف مع OAuth عمل مستقبلي؛ لا تفترض أن كل عميل مكتبي أو مستضاف يدعم مفاتيح الحامل الملصوقة.

الأدوات

الأداةقراءة/تغييرملاحظات
list_accountsقراءةتحترم قائمة سماح الحسابات للمفتاح
get_capabilitiesقراءةالتنسيقات والحدود ومتطلبات الموافقة
create_upload_intentتغييرتعيد تعليمات تحميل مباشرة؛ بايتات الوسائط لا تمر عبر الأدوات أبدًا
finalize_uploadتغييرمعرّف الجلسة (+ إيصالات أجزاء multipart)؛ يفحص الخادم البايتات/MIME بنفسه
create_draftتغييرالمصدر + متغيرات الوجهة
validate_postقراءةمشكلات مهيكلة لكل وجهة
schedule_postتغييرلحظة واحدة، ≤90 يومًا مقدمًا، يتطلب expectedVersion
publish_postتغييردلالات 202؛ ليست دليل نشر
get_post_statusقراءةحالات كل وجهة والروابط الأصلية
list_postsقراءةترقيم بالمؤشرات
cancel_deliveryتغييرفقط ما دام غير مطالب به بأمان
retry_deliveryتغييرفقط الإخفاقات المعروفة؛ لا تكرار أبدًا
get_usageقراءةلا يوجد عدّاد منشورات متبقية

وسيطات الأدوات المطلوبة

الأداةالوسيطات المطلوبة
list_accountsبلا
get_capabilitiesبلا
create_upload_intentfilename، declaredMime، declaredBytes
finalize_uploadassetId، sessionId
create_draftcaption، destinations
validate_postpostId
schedule_postpostId، scheduledAt، timezone، expectedVersion
publish_postpostId
get_post_statuspostId
list_postsبلا
cancel_deliverydeliveryId
retry_deliverydeliveryId
get_usageبلا

تشمل الوسيطات الاختيارية ترقيم الصفحات على أدوات القوائم، وidempotencyKey على عمليات التغيير، وmultipart.parts لإنهاء multipart، ووسائط المسودة ومتغيرات الوجهة. مخطط الأدوات الزمني المُعاد من tools/list هو المرجع للحقول الاختيارية والأشكال المتداخلة وحدود التحقق.

تقبل أدوات التغيير وسيطة idempotencyKey اختيارية. عند إغفالها، يولّدها الخادم ويعيدها في كل نتيجة: بما في ذلك إخفاقات النقل، حيث قد تكون العملية قد وصلت إلى واجهة البرمجة بالفعل (يحمل الخطأ transport_outcome_unknown مع المفتاح). الأدوات لا تعيد المحاولة تلقائيًا أبدًا؛ أعد المحاولة بمفتاح idempotency نفسه لتجنب إنشاء عملية مكررة.

مثال سير عمل وكيل آلي

  1. list_accounts + get_capabilities → اختر وجهات صالحة.
  2. create_upload_intent → ارفع البايتات مباشرة → finalize_upload.
  3. create_draft → validate_post → صحّح أو ألغِ تحديد الوجهات غير الصالحة.
  4. publish_post (أو schedule_post) → سجّل معرّفات التسليم.
  5. get_post_status (استقصاء محدود أو خطافات ويب للعملاء): تعامل مع استجابات requires_action كتعليمات قابلة للتنفيذ، مثل موافقة TikTok.

العملاء المختبرون

  • عميل TypeScript الرسمي @modelcontextprotocol/sdk عبر subprocess stdio حقيقي مقابل الملف التنفيذي الموثق (initialize → tools/list → tools/call): اختُبر في packages/mcp/tests/stdio.test.ts، بما في ذلك فحوص stdout النظيف وفحوص فشل بدء التشغيل.
  • عميل SDK الرسمي عبر نقل في الذاكرة: مغطى أيضًا.
  • العملاء المكتبيون (Claude Desktop وCursor وغيرهما): لم يُختبروا بعد: كوّنهم وفق المقتطف العام أعلاه وأبلغ عن النتائج قبل الادعاء بالدعم.

توافق العملاء

العميل أو النقلالحالةالإعداد
SDK الرسمي لـ TypeScript عبر subprocess stdioتغطية اختبار آليالمشغّل الموضح أعلاه في المستودع
نقل SDK الرسمي في الذاكرةتغطية اختبار آليمنصة الاختبار فقط
Claude Desktop / عملاء مكتبية أخرىلم يُتحقق منه يدويًاعميل محلي يدعم stdio؛ استخدم مسار مشغّل مطلقًا
اتصال ChatGPT المستضافغير مقدم من هذا المحوّليتطلب نقلًا مستضافًا؛ JSON الخاص بـ stdio المحلي ليس موصلًا مستضافًا
MCP مستضاف مع OAuthغير منفَّذعمل منتج منفصل

استكشاف الأخطاء وإصلاحها

  • لا يستطيع المشغّل حل التبعيات: شغّل npm ci في نسخة المصدر المصرَّح بها وتحقق من إصدار Node. لا تستبدل حزمة عامة غير ذات صلة.
  • العميل لا يبدأ أبدًا: استخدم مسار المشغّل المطلق وافحص stderr. لا تكتب مخرجات التصحيح إلى stdout.
  • 401: تحقق من أن مفتاح المنتج المكوَّن حالي؛ أنشئ بديلًا في واجهة المستخدم إذا أُبطل. 403: تحقق من النطاقات وقيود الحسابات.
  • transport_outcome_unknown: احتفظ بمفتاح idempotency المُعاد وأعد المحاولة للعملية المطابقة بذلك المفتاح، وليس أبدًا مفتاحًا جديدًا.
  • requires_action: سلّم التعليمات المقدَّمة لشخص مصرَّح له؛ لا يستطيع وكيل آلي توفير موافقة TikTok البشرية.

التعامل مع بيانات الاعتماد

يُرسل مفتاح المنتج فقط إلى واجهة AiVideoEditor API المكوَّنة (Authorization: Bearer). لا يُرسل أبدًا إلى مزودي النماذج أو الشبكات الاجتماعية، ولا يُسجَّل أبدًا، وتتحقق عناوين URL بحيث لا يمكن للمفتاح اتباع إعادة توجيه أو الهروب من المنشأ المكوَّن.