ٹرانسکرپٹ MCP سرور

MCP سرور AI ایجنٹ کو وہی API دیتا ہے جو آپ کی کی دیتی ہے: وہ ویڈیوز تلاش کر سکتا ہے، ان کا ٹرانسکرپشن کر سکتا ہے، اور گفتگو کے دوران نتائج پڑھ سکتا ہے۔ یہ آپ کے کریڈٹس استعمال کرتا ہے۔ کچھ انسٹال کرنے کی ضرورت نہیں: کلائنٹ کو ریموٹ سرور کی طرف اشارہ کریں، https://www.transcriptdock.com/mcp۔

کنیکٹ کریں#

Claude (claude.ai، ڈیسک ٹاپ، موبائل)#

• Customize, Connectors کھولیں اور Add custom connector منتخب کریں۔
• اس کا نام Transcript Dock رکھیں اور سرور URL کے طور پر https://www.transcriptdock.com/mcp چسپاں کریں۔ ایڈوانسڈ سیٹنگز خالی چھوڑ دیں۔
• Add اور پھر Connect منتخب کریں۔ Transcript Dock میں سائن اِن کریں اور Allow access منتخب کریں۔

API کی کی ضرورت نہیں: کنیکٹر آپ کے اکاؤنٹ سے سائن اِن ہوتا ہے اور کام جمع کرانے اور ٹرانسکرپٹ پڑھنے کی اجازت رکھتا ہے۔ کیز، بلنگ یا اکاؤنٹ سیٹنگز تک اس کی رسائی نہیں ہوتی۔ Team اور Enterprise پلانز پر کوئی Owner اسے ایک بار Organization settings اور Connectors کے تحت شامل کرتا ہے، اور ہر رکن اسے اپنے طور پر کنیکٹ کرتا ہے۔

Claude Code#

سرور شامل کریں، پھر Claude Code میں /mcp چلائیں اور سائن اِن کے لیے Authenticate منتخب کریں۔

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

CI اور اسکرپٹس کے لیے سائن اِن کرنے کے بجائے 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 میں url کے بجائے serverUrl استعمال ہوتا ہے، اور VS Code سرورز کو servers کے تحت "type": "http" کے ساتھ درج کرتا ہے۔ نیچے دیے گئے کلائنٹ صفحات میں درست فائلیں موجود ہیں۔

• Claude Codeایک ٹرمینل کمانڈ۔
• Claude ایپclaude.ai، ڈیسک ٹاپ اور موبائل: ایک حسب ضرورت کنیکٹر شامل کریں۔
• Cursormcp.json میں شامل کریں۔
• Windsurfmcp_config.json میں شامل کریں۔
• OpenClawstdio کے ذریعے خودکار ایجنٹس۔

لوکل سرور#

OpenClaw جیسے صرف stdio کلائنٹس کے لیے، 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 ویڈیو کا URL۔

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

ڈیفالٹ captions_only (1 کریڈٹ)۔ auto اگر ویڈیو میں کیپشن نہ ہوں تو AI ٹرانسکرپشن پر جاتا ہے؛ transcribe ہمیشہ AI ٹرانسکرپشن استعمال کرتا ہے (شروع ہونے والے ہر منٹ کے 2 کریڈٹس، پیڈ پلانز پر)۔

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

text (ڈیفالٹ) ایجنٹ کے لیے سب سے مختصر ہے؛ segments وقت والا JSON واپس کرتا ہے۔

timeout_secondsintegerاختیاری

ڈیفالٹ 120۔ ٹائم آؤٹ پر کام کی حالت اور ID واپس کر دی جاتی ہے۔

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

یہ ایک مثال ہے
اس میں دو لائنیں ہیں
…

وہی ویڈیو اور وہی موڈ ہو تو جواب آپ کے ورک اسپیس کے محفوظ نتیجے سے، مفت دیا جاتا ہے۔

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، چینل ID یا چینل URL دیا جا سکتا ہے؛ playlist میں ID یا URL؛ user میں TikTok @user یا پروفائل URL۔ YouTube ٹولز limit (ڈیفالٹ 20) اور cursor کے ساتھ صفحہ بندی کرتے ہیں۔ TikTok زیادہ سے زیادہ 10 ویڈیوز واپس کرتا ہے اور اس سے آگے کوئی صفحہ نہیں ہوتا؛ include_details ہر ویڈیو کے لیے لائکس، تبصرے، ہیش ٹیگز اور کیپشن کی زبانیں بھی شامل کرتا ہے۔

خرابیاں#

ناکام کال isError: true کے ساتھ API خرابی کا کوڈ، پیغام اور ریکوئسٹ ID واپس کرتی ہے، تاکہ ایجنٹ اسے سمجھا سکے یا اپنا راستہ بدل سکے۔ کوڈ وہی ہیں جو API ریفرنس میں درج ہیں۔

مسائل کا حل#

• Unauthorized: Claude میں کنیکٹر ہٹا کر دوبارہ شامل کریں تاکہ نئے سرے سے سائن اِن ہو۔ کی کے ساتھ وہ سرور کنفیگ (ہیڈر یا env) میں جاتی ہے، آپ کے شیل میں نہیں؛ دیکھیں کہ وہ منسوخ تو نہیں ہو گئی۔
• MCP سرور تک رسائی نہیں ہو سکی: بالکل یہی URL استعمال کریں، www سمیت: https://www.transcriptdock.com/mcp۔
• ٹول نہیں ملا: کنفیگ میں ترمیم کے بعد کلائنٹ دوبارہ شروع کریں۔
• لوکل سرور شروع نہیں ہوتا: Node.js 22.15 یا نیا ورژن انسٹال کریں، اور TRANSCRIPTDOCK_API_KEY اور TRANSCRIPTDOCK_BASE_URL دونوں سیٹ کریں۔
• NO_CAPTIONS: ویڈیو میں کیپشن نہیں ہیں۔ پیڈ پلان پر mode: "auto" استعمال کریں۔