أضف الاتصال في إعدادات محرر الكود
ضع الرابط ومفتاح API في .cursor/mcp.json. وفي VS Code استخدم الرابط نفسه داخل .vscode/mcp.json. يتضمن دليل إعداد MCP تثبيتا بنقرة واحدة لكل منهما.
يجب أن يدعم العميل خوادم MCP البعيدة عبر streamable HTTP، وأن يرسل ترويسة Authorization مع الطلبات. تختلف بنية إعدادات Cursor عن VS Code؛ انسخ المثال الخاص بعميلك، ولا تكتف بتغيير اسم الملف.
بعد الاتصال اطلب من المساعد استدعاء get_account أو list_transcriptions. هكذا تتحقق من الدخول دون إنشاء تفريغ مدفوع. إذا لم تظهر الأدوات، افحص تحميل الإعدادات وتفعيل الخادم. وإذا رفضت المصادقة، راجع المفتاح المحفوظ في العميل.
{
"mcpServers": {
"transcript1": {
"url": "https://api.transcript1.com/mcp",
"headers": {
"Authorization": "Bearer t1_YOURKEY"
}
}
}
}اربط Claude Code أو سجل الدخول من المساعد
في Claude Code استخدم claude mcp add مع الرابط ومفتاح API. وفي Claude أضف موصلا مخصصا ثم سجل الدخول؛ يستخدم موصل ChatGPT الرابط نفسه. اتبع الخطوات الخاصة بعميلك.
تستخدم موصلات Claude وChatGPT تسجيل الدخول عبر OAuth. يعتمد توفرها على باقة المساعد وإعدادات مساحة العمل. إعداد مفتاح API في محرر الكود مسار مختلف؛ اختر تعليمات التطبيق الذي تستخدمه فعلا.
حين تظهر الأدوات، أرسل رابط فيديو عاما مع طلب واضح. يمكنك مثلا طلب نص Reel من Instagram، ثم استخراج التعليمات المنطوقة منه. يقدم transcript1 النص المفرغ من الصوت، ولا يجعل المساعد يرى محتوى الفيديو الذي لم يفحصه.
claude mcp add --transport http transcript1 https://api.transcript1.com/mcp --header "Authorization: Bearer t1_YOURKEY"دع المساعد يطلب النص ويتابع قراءته
يستدعي المساعد transcribe وينتظر النص أو يحصل على معرف لمتابعته عبر get_transcription. يشرح مرجع الأدوات المعاملات، ويعرض دليل الوكلاء طريقة متابعة المهمة وقراءة صفحاتها.
التنسيق الافتراضي نص مع الطوابع الزمنية. إذا كان طويلا، ترجع الصفحة next_from_seconds؛ مرره في from_seconds لقراءة التالية. يجب أن يقرأ المساعد كل الأجزاء ذات الصلة قبل تلخيص التسجيل، وألا يعرض الصفحة الأولى بوصفها النص الكامل.
يمكن للرابط الكامل المدعوم أن يعيد استخدام تفريغ مطابق خلال 24 ساعة، بخلاف رابط المشاركة المختصر. في الحالتين تجنب طلب إنشاء جديد إذا كنت تعرف المعرف. واستبدل الرابط التجريبي في المثال برابط TikTok عام حقيقي.
transcribe(url="[public TikTok video URL]")
get_transcription(id="tr_8fK2Lm0PqRsTuVwXyZaBcD", format="srt")هل يستطيع المساعد الوصول إلى ملفك المحلي؟
تنقل أدوات MCP الطلبات والاستجابات، لا بايتات التسجيل. تحجز create_upload عملية الرفع وتعيد خطة الأجزاء. يحتاج الوكيل بعدها إلى قراءة الملف وإرسال أجزائه عبر HTTP خارج MCP، ثم استدعاء complete_upload. يوضح دليل الملفات هذا الفصل.
بعض المساعدات تستطيع استدعاء أدوات بعيدة لكنها لا تستطيع قراءة مسار محلي أو إرسال بيانات ثنائية. ارفع التسجيل عندئذ من لوحة التحكم، ثم أعط المساعد معرف التفريغ المكتمل. مجرد كتابة اسم الملف في المحادثة لا ترسل محتواه إلى transcript1.
إذا احتجت webhook عند الانتهاء، استخدم REST API؛ أدوات MCP لا تعرض هذا الخيار. وللعمل داخل المحادثة، انتظر مدة محدودة ثم تابع عبر get_transcription. إذا انقطع العميل، ابحث عن التفريغ الحديث أو تابع بالمعرف؛ انقطاع الاستدعاء لا يثبت أن المهمة لم تنشأ.
يمكنك استخدام الاتصال نفسه مع فيديو Bluesky أو فيديو TikTok. تبقى قواعد المصدر كما هي؛ المنشور عام، والنص ينقل الصوت لا ما يظهر في الصورة وحدها.