---
title: "Transcript MCP Server لوكلاء الذكاء الاصطناعي"
description: "اربط Claude أو ChatGPT أو Cursor أو OpenAI Agent Builder بخادم Transcript MCP Server من transcript.im لتمنح وكيلك أدوات للتفريغ والدُفعات واكتشاف YouTube."
canonical: "https://transcript.im/ar/mcp"
markdown: "https://transcript.im/ar/mcp.md"
---

# Transcript MCP Server لوكلاء الذكاء الاصطناعي

اربط Claude أو ChatGPT أو Cursor أو OpenAI Agent Builder بخادم Transcript MCP Server من transcript.im لتمنح وكيلك أدوات للتفريغ والدُفعات واكتشاف YouTube.

## روابط

- [HTML الأساسي](https://transcript.im/ar/mcp)
- [Markdown](https://transcript.im/ar/mcp.md)


يمنح خادم Transcript MCP Server من transcript.im عميل الذكاء الاصطناعي أداة تفريغ يستطيع استدعاءها مباشرة. وجّه Claude أو ChatGPT أو Cursor أو OpenAI Agent Builder إلى الخادم، وقدّم مفتاح API، ليتمكن النموذج من سحب نص من رابط عام، أو بدء دُفعة، أو تصدير ترجمات، أو البحث في YouTube دون متصفح ودون تكامل مخصص. وهو نقطة نهاية HTTP بعيدة، لذا لا يحتاج العميل المستضاف سوى إلى الرابط ومفتاح، لا إلى تثبيت محلي.

- نقطة نهاية بعيدة واحدة على `https://mcp.transcript.im/mcp`، تُوثَّق بمفتاح API الخاص بك — لا شيء يحتاج إلى تثبيت.
- إحدى عشرة أداة للتفريغ والدُفعات والتصدير واكتشاف YouTube وبيانات الاستخدام.
- لا أدوات AI — عميلك يشغّل النموذج بالفعل؛ والخادم يوفّر النصوص وبيانات المنصات.
- الحساب نفسه وخط الاستخراج نفسه الذي تستخدمه عبر REST API.
- تُقسَّم النصوص الطويلة إلى أجزاء مع رمز صفحة حتى لا تُغرق نتيجة واحدة نافذة السياق.

## ما الذي يفعله خادم Transcript MCP Server

يتيح Model Context Protocol للعميل اكتشاف الأدوات التي ينشرها الخادم واستدعاءها. ويستخدم Transcript MCP Server من transcript.im هذه الواجهة لمهمة واحدة: تحويل رابط فيديو أو صوت عام إلى نص، والإجابة عن أسئلة المنصات المحيطة به. يستدعي العميل `get_transcript` مع رابط؛ فيصل الخادم إلى خط الاستخراج في transcript.im، ويستعمل ترجمات الناشر إن وُجدت، ويلجأ إلى التفريغ بالذكاء الاصطناعي إن لم توجد.

ولأن العمل الشاق يتم على الخادم، لا يحتاج العميل إلى برنامج تنزيل ولا إلى حزمة أتمتة متصفح ولا إلى نموذج تحويل كلام إلى نص خاص به. يكفيه استدعاء أداة. وهذا هو موقع خادم MCP للتفريغ: النموذج موجود لديك أصلاً، فيبقى الخادم مركّزاً على البيانات.

- استخراج النص كأداة — استدعاء واحد يحوّل الرابط إلى نص موقّت زمنياً.
- واكتشاف YouTube أيضاً — البحث عن الفيديوهات، وتحديد القنوات، وسرد المرفوعات وعناصر قوائم التشغيل، وقراءة بيانات الترجمات الوصفية.
- الدُفعات والتصدير — صفّ روابط كثيرة، ثم صدّر المجموعة المكتملة.
- لا نموذج بالداخل — الخادم يعيد البيانات؛ والعميل يقرّر ما يفعل بها.

## أدوات يستطيع وكيلك استدعاءها

### النصوص

يستخرج `get_transcript` نصاً من رابط أو يقرأ الجزء التالي من نص طويل، ويعيد `get_transcript_info` بيانات وصفية عن الفيديو ومسارات الترجمات التي يستطيع API تحديدها له قبل أن تلتزم بعملية استخراج. ومعاً يتيحان للوكيل أن يقرر ما إذا كان الفيديو يستحق التفريغ، وأن يطلب أولوية لغة يحتاجها فعلاً، ثم يجلب الكلمات بمواقيت زمنية أو بدونها.

### الدُفعات والتصدير

يبدأ `create_batch` تشغيلاً من قائمة روابط أو قائمة تشغيل أو قناة، ويبلّغ `get_batch` بالحالة والأعداد والصفحة التالية من العناصر، ويحوّل `export_batch` دُفعة مكتملة إلى نص أو ترجمات. وهكذا يعالج الوكيل أرشيف ناشر كامل بدلاً من مقطع واحد في كل مرة، ويُبلَّغ عن رابط فاشل واحد على حدة بدلاً من تجاهل البقية.

### اكتشاف YouTube

يجد `search_video` فيديوهات أو قنوات حسب الموضوع، ويحدّد `get_channel` مقبضاً أو رابطاً، ويسرد `list_channel_video` مرفوعات قناة، ويتنقّل `list_playlist_item` في قائمة تشغيل، ويقرأ `list_caption` بيانات ترجمات فيديو ونصها. هذه هي الأدوات التي يستخدمها الوكيل لدراسة مجال، والتحقق مما نشره ناشر، واختيار المصدر الصحيح قبل تفريغ أي شيء.

### الحساب

يبلّغ `get_usage` بملخص استخدام الحساب، ليتمكن الوكيل من رؤية ما استهلكه الحساب بالفعل قبل أن يلتزم بدُفعة كبيرة أو قناة طويلة، بدلاً من اكتشاف حدّ ما في منتصف التشغيل.

## اربط العميل الذي تستخدمه بالفعل

### Claude

أضف الخادم البعيد كموصل مخصص، أو سجّله من سطر الأوامر. يتفاوض Claude مع خادم MCP، ويعرض أدواته على المحادثة، ويبقيها متاحة بين الأدوار، فتطلب نصاً بلغة عادية وتتابع بطلب ملخص دون تكرار الرابط.

### ChatGPT

أضف موصل MCP واختر المصادقة بمفتاح API. عندئذٍ يستدعي ChatGPT أدوات التفريغ مثل أي تطبيق متصل آخر، ما يعني أن رابط فيديو ملصوقاً في محادثة يمكن أن يصبح نصاً مقروءاً يستطيع النموذج اقتباسه أو ترجمته أو الاستدلال عليه.

### Cursor ومحررات أخرى

وجّه إعداد `mcpServers` في المحرر إلى الرابط البعيد مع مفتاح API الخاص بك. عندئذٍ يستطيع وكيل المحرر تفريغ رابط وكتابة النتيجة مباشرة في مشروعك أو ملاحظاتك.

### OpenAI Agent Builder

أضف أداة MCP برابط الخادم وبيانات اعتماد Bearer، ليتمكن الوكيل من استخدام النصوص كخطوة داخل سير عمل أكبر، وتمرير النص إلى ما يأتي بعدها دون موصل مخصص.

## الاتصال والمصادقة

الخادم نقطة نهاية HTTP بعيدة، لذا فإن ربط عميل به يعني رابطاً ومفتاحاً، لا تثبيتاً.

- HTTP بعيد — أضف `https://mcp.transcript.im/mcp` إلى عميل MCP لديك؛ ولا شيء يحتاج إلى التشغيل على جهازك.
- مفتاح API — أرسل المفتاح بصيغة `Authorization: Bearer <key>` أو `x-api-key`؛ ويوجّهه الخادم إلى REST API، فتسري الصلاحيات والحساب نفسه.
- اكتشاف الأدوات — تجيب نقطة النهاية عن طلبات اكتشاف MCP، فيستطيع العميل عدّ الأدوات التي يعرضها قبل استدعاء أي منها.
- النتائج نفسها — تتطابق الأدوات والتقسيم والأخطاء مع ما يحصل عليه الحساب نفسه من REST API، فلا يتوقف السلوك على العميل.

## النصوص الطويلة تبقى قابلة للإدارة

يمكن أن ينتج تسجيل مدته ساعتان نصاً يفوق بكثير ما ينبغي أن يتلقاه النموذج في نتيجة أداة واحدة، لذا يعيد الخادم النصوص الطويلة في أجزاء محدودة. ويبلّغ كل جزء عن `truncated: true` و`nextPageToken` غير شفاف؛ ويؤدي استدعاء `get_transcript` مرة أخرى بذلك الرمز وحده إلى إعادة الجزء التالي، ويكرّر الوكيل ذلك حتى ينتهي النص.

- نتائج محدودة — يُحدَّد سقف للجزء حتى لا تُغرق نتيجة أداة واحدة نافذة السياق أو تُزيح استدلالاً سابقاً.
- تصفّح بلا حالة — يحمل الرمز الموضع، ولا تُحفظ أي جلسة خادم بين الاستدعاءات، فتستطيع أي نسخة متماثلة تقديم الجزء التالي.
- تصفّح JSON — يُقسَّم نص JSON حسب المقطع، فيحافظ المستهلك المهيكل على المخطط الذي يتوقعه أثناء تنقّله في النص.
- استطلاع المهمة — يعيد فيديو بلا ترجمات معرّف مهمة، ويستطلع الوكيل حالته حتى يصبح النص جاهزاً.
- بداية قابلة للقراءة — يكفي الجزء الأول للإجابة عن سؤال حول الافتتاحية، فلا يضطر متابعة قصيرة إلى سحب النص كاملاً.

## أخطاء يستطيع وكيلك التصرف بناءً عليها

حين يفشل استدعاء أداة، يعيد الخادم خطأ MCP بنص مقروء لا بتتبّع مكدّس. وتنتقل تفاصيل مهيكلة مع النتيجة ليتمكن الوكيل من التعافي بدلاً من التخمين: `code` و`status` بصيغة HTTP، و`upgradeUrl` عند بلوغ حدّ، و`availableLanguages` حين تكون اللغة المطلوبة غير متاحة. وهذا يحوّل الطريق المسدود إلى خطوة تالية — تجربة لغة أخرى، أو اختيار رابط مختلف، أو إبراز الحدّ للشخص في المحادثة. والنموذج الذي يقرأ سبب الفشل يستطيع تصحيح محاولته التالية، وهذا هو الفرق بين وكيل يعيد المحاولة بجدوى ووكيل يكرّر الاستدعاء المعطوب نفسه.

## ذات صلة

- [REST API](/ar/api)
- [مهارات الوكلاء](/ar/skills)
- [توثيق API](/docs)
- [مولّد نصوص YouTube](/ar/youtube-transcript)
- [ملخّص فيديوهات YouTube](/ar/youtube-video-summarizer)
- [مولّد ترجمات YouTube](/ar/youtube-subtitle-generator)
- [تحميل ترجمات YouTube](/ar/youtube-subtitle-downloader)
- [نصوص قناة YouTube](/ar/youtube-channel-transcript)
- [نصوص قائمة تشغيل YouTube](/ar/youtube-playlist-transcript)
## الأسئلة الشائعة حول خادم MCP

### ما هو خادم Transcript MCP Server في transcript.im؟

خادم Transcript MCP Server من transcript.im هو واجهة Model Context Protocol تعرض استخراج النصوص ومهام الدُفعات والتصدير واكتشاف YouTube كأدوات يستطيع عميل الذكاء الاصطناعي استدعاءها.

### أي العملاء يمكنهم الاتصال بخادم Transcript MCP Server من transcript.im؟

يستطيع Claude وChatGPT وCursor وOpenAI Agent Builder وأي عميل MCP آخر الاتصال بنقطة نهاية HTTP البعيدة بمفتاح API.

### هل يتضمن خادم Transcript MCP Server من transcript.im أدوات AI؟

لا. يعرض الخادم عن قصد أدوات البيانات والاستخراج فقط، لأن العميل يشغّل بالفعل النموذج الذي يلخّص النتيجة أو يعيد صياغتها.

### كيف يحصل الوكيل على نص من رابط فيديو؟

يستدعي أداة النصوص مع الرابط؛ فيستخدم الخادم الترجمات الموجودة أولاً، ويلجأ إلى التفريغ بالذكاء الاصطناعي إن لم توجد، ثم يعيد نصاً موقّتاً زمنياً.

### كيف يتعامل خادم MCP مع النصوص الطويلة؟

تُعاد في أجزاء محدودة. تحمل كل نتيجة علامة اقتطاع ورمز صفحة، ويستدعي الوكيل الأداة مرة أخرى بذلك الرمز لقراءة الجزء التالي.

### هل يمكن للوكيل تشغيل دُفعة عبر خادم Transcript MCP Server من transcript.im؟

نعم. تقبل أدوات الدُفعات قائمة روابط أو قائمة تشغيل أو قناة، وتبلّغ بالحالة والأعداد، وتصدّر المجموعة المكتملة كنص أو ترجمات.

### هل يعمل خادم Transcript MCP Server من transcript.im مع البحث والقنوات في YouTube؟

نعم. تغطي أدوات مخصصة البحث عن الفيديوهات والقنوات، وتحديد القنوات، ومرفوعات القنوات، وعناصر قوائم التشغيل، وبيانات الترجمات الوصفية.

### كيف يصادق خادم MCP على عميل؟

يقبل مفتاح API كرمز Bearer أو ترويسة `x-api-key` ويوجّهه إلى REST API، فتصل استدعاءاته إلى الحساب نفسه الذي يصل إليه طلب API مباشر.

## اربط خادم Transcript MCP Server من transcript.im

أضف رابط الخادم إلى عميل MCP لديك، وقدّم مفتاح API، واطلب من وكيلك نصاً.

- [أنشئ مفتاح API](/app/account/api-keys)
- [اقرأ عقد API](/docs)