Transcript MCP सर्वर

MCP सर्वर किसी AI एजेंट को वही API देता है जो आपकी कुंजी से मिलती है: वह बातचीत के बीच वीडियो ढूंढ सकता है, उन्हें ट्रांसक्राइब कर सकता है और नतीजे पढ़ सकता है। इसमें आपके क्रेडिट खर्च होते हैं। कुछ इंस्टॉल करने की ज़रूरत नहीं: क्लाइंट को रिमोट सर्वर https://www.transcriptdock.com/mcp पर पॉइंट करें।

कनेक्ट करें#

Claude (claude.ai, Desktop, मोबाइल)#

• Customize, Connectors खोलें और Add custom connector चुनें।
• नाम में Transcript Dock लिखें और सर्वर URL में https://www.transcriptdock.com/mcp पेस्ट करें। एडवांस्ड सेटिंग खाली छोड़ दें।
• Add चुनें, फिर Connect। Transcript Dock में साइन इन करें और एक्सेस की अनुमति दें चुनें।

इसमें कोई 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, Desktop और मोबाइल: कस्टम कनेक्टर जोड़ें।
• Cursormcp.json में जोड़ें।
• Windsurfmcp_config.json में जोड़ें।
• OpenClawstdio पर चलने वाले ऑटोनॉमस एजेंट।

लोकल सर्वर#

सिर्फ़ 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 वीडियो का URL।

mode"captions_only" | "auto" | "transcribe"वैकल्पिक

डिफ़ॉल्ट captions_only (1 क्रेडिट)। auto तब AI ट्रांसक्रिप्शन पर आता है जब वीडियो में कैप्शन न हों; transcribe हमेशा उसी का इस्तेमाल करता है (शुरू हुए हर मिनट पर 2 क्रेडिट, पेड प्लान)।

format"text" | "srt" | "vtt" | "segments"वैकल्पिक

text (डिफ़ॉल्ट) एजेंट के लिए सबसे छोटा रूप है; segments समय वाला JSON लौटाता है।

timeout_secondsintegerवैकल्पिक

डिफ़ॉल्ट 120। टाइमआउट होने पर इसकी जगह जॉब की स्थिति और id लौटती है।

{ "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, चैनल 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 सर्वर तक पहुंच नहीं हुई (Couldn't reach the MCP server): ठीक यही URL https://www.transcriptdock.com/mcp इस्तेमाल करें, www समेत।
• टूल नहीं मिला: कॉन्फ़िग बदलने के बाद क्लाइंट को रीस्टार्ट करें।
• लोकल सर्वर शुरू नहीं होता: Node.js 22.15 या उससे नया वर्ज़न इंस्टॉल करें और TRANSCRIPTDOCK_API_KEY व TRANSCRIPTDOCK_BASE_URL दोनों सेट करें।
• NO_CAPTIONS: वीडियो में कैप्शन नहीं हैं। पेड प्लान पर mode: "auto" मांगें।