خادم MCP من Transcript Dock

يمنح خادم MCP وكيل الذكاء الاصطناعي الإمكانات نفسها التي يتيحها مفتاحك في API: يستطيع البحث عن الفيديوهات وتفريغها وقراءة النتائج في منتصف المحادثة. ويُخصم من أرصدتك. لا يتطلب تثبيت شيء: وجّه العميل إلى الخادم البعيد https://www.transcriptdock.com/mcp.

الاتصال#

Claude (claude.ai وسطح المكتب والجوال)#

• افتح Customize, Connectors واختر Add custom connector.
• سمِّه Transcript Dock، والصق https://www.transcriptdock.com/mcp بوصفه عنوان الخادم. اترك الإعدادات المتقدمة فارغة.
• اختر Add، ثم Connect. سجّل الدخول إلى Transcript Dock واختر Allow access.

لا حاجة إلى مفتاح API. يسجّل الموصل الدخول بحسابك، ويستطيع قراءة المهام وإرسالها وقراءة النصوص المفرّغة، لكنه لا يصل إلى المفاتيح أو الفوترة أو إعدادات الحساب أبدًا. وفي خطط Team وEnterprise يضيفه المالك مرة واحدة من Organization settings ثم Connectors، ويتصل كل عضو بعد ذلك.

Claude Code#

أضف الخادم، ثم شغّل /mcp في Claude Code واختر Authenticate لتسجيل الدخول.

claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp

في أنظمة التكامل المستمر والسكربتات، أرسل مفتاح API بدلًا من تسجيل الدخول:

claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp \
  --header "Authorization: Bearer td_live_YOUR_KEY"

Cursor وغيره من العملاء#

{
  "mcpServers": {
    "transcriptdock": {
      "url": "https://www.transcriptdock.com/mcp",
      "headers": { "Authorization": "Bearer td_live_YOUR_KEY" }
    }
  }
}

يستخدم Windsurf الحقل serverUrl بدلًا من url، ويدرج VS Code الخوادم تحت servers مع "type": "http". تحتوي صفحات العملاء أدناه على الملفات الدقيقة.

• Claude Codeأمر واحد في الطرفية.
• تطبيق Claudeclaude.ai وسطح المكتب والجوال: أضف موصلًا مخصصًا.
• Cursorأضفه إلى mcp.json.
• Windsurfأضفه إلى mcp_config.json.
• OpenClawوكلاء مستقلون عبر stdio.

الخادم المحلي#

بالنسبة للعملاء الذين يعملون عبر stdio فقط، مثل OpenClaw، شغّل الخادم نفسه محليًا باستخدام Node.js 22.15 أو أحدث. المتغيران مطلوبان معًا.

{
  "mcpServers": {
    "transcriptdock": {
      "command": "npx",
      "args": ["-y", "@transcriptdock/mcp"],
      "env": {
        "TRANSCRIPTDOCK_API_KEY": "td_live_YOUR_KEY",
        "TRANSCRIPTDOCK_BASE_URL": "https://www.transcriptdock.com"
      }
    }
  }
}

الأدوات#

get_video_transcript#

الأداة التي يلجأ إليها الوكيل عندما يُسأل عمّا يقوله فيديو ما.

urlstringمطلوب

رابط فيديو YouTube أو TikTok.

mode"captions_only" | "auto" | "transcribe"اختياري

الافتراضي captions_only (رصيد واحد). يلجأ auto إلى التفريغ بالذكاء الاصطناعي عندما لا يكون للفيديو ترجمات، أما transcribe فيستخدمه دائمًا (رصيدان لكل دقيقة مبدوءة، في الخطط المدفوعة).

format"text" | "srt" | "vtt" | "segments"اختياري

text (الافتراضي) هو الأكثر إيجازًا للوكيل، وsegments يعيد JSON بتوقيتات.

timeout_secondsintegerاختياري

الافتراضي 120. عند انتهاء المهلة تُعاد حالة المهمة ومعرّفها بدلًا من ذلك.

{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }

Never gonna give you up
Never gonna let you down
…

يُجاب على الفيديو نفسه بالوضع نفسه من النتيجة المحفوظة في مساحة عملك، مجانًا.

transcribe, wait_for_job, get_transcript#

النسخة المكوّنة من ثلاث خطوات، للوكلاء الذين يريدون التحكم: تأخذ transcribe القيمتين url و mode، و language اختياريًا، و max_credits، إضافة إلى idempotency_key (أي سلسلة ثابتة من 8 إلى 128 حرفًا، فلا يُرسَل الاستدعاء المعاد أكثر من مرة)، وتعيد المهمة. تأخذ wait_for_job القيمة job_id و timeout_seconds اختياريًا. وتأخذ get_transcript القيمة result_id الخاصة بالمهمة باسم transcript_id، و format.

البحث عن الفيديوهات#

تعيد أدوات البحث والعرض فيديوهات تتضمن url والعنوان والمدة وعدد المشاهدات، جاهزة لتمريرها إلى get_video_transcript. يقبل channel المعرّف @handle أو معرّف القناة أو رابطها، و playlist معرّفًا أو رابطًا، و user المعرّف @user أو رابط الملف الشخصي في TikTok. تتنقل أدوات YouTube بين الصفحات عبر limit (الافتراضي 20) و cursor. تعيد TikTok 10 فيديوهات كحد أقصى دون صفحات إضافية، ويضيف include_details الإعجابات والتعليقات والوسوم ولغات الترجمات لكل فيديو.

الأخطاء#

يعيد الاستدعاء الفاشل isError: true مع رمز خطأ API والرسالة ومعرّف الطلب، حتى يستطيع الوكيل شرحه أو تغيير مساره. والرموز هي نفسها المذكورة في مرجع API.

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

• Unauthorized: في Claude، احذف الموصل وأضفه من جديد لتسجيل الدخول من البداية. مع المفتاح، يُوضع في إعداد الخادم (الترويسة أو متغير البيئة) لا في الصدفة الخاصة بك. وتحقّق من أنه لم يُلغَ.
• تعذّر الوصول إلى خادم MCP: استخدم العنوان الدقيق https://www.transcriptdock.com/mcp، بما في ذلك www.
• الأداة غير موجودة: أعد تشغيل العميل بعد تعديل إعداداته.
• الخادم المحلي لا يبدأ: ثبّت Node.js 22.15 أو أحدث، وعيّن TRANSCRIPTDOCK_API_KEY و TRANSCRIPTDOCK_BASE_URL معًا.
• NO_CAPTIONS: الفيديو لا يحتوي على ترجمات. في الخطة المدفوعة، اطلب mode: "auto".