YouTube Transcript MCP Server: Setup Guide for Claude and Other AI Tools

How the Model Context Protocol works, how to connect the GetYouTubeTranscript MCP server to Claude Desktop, Claude Code, Cursor, Windsurf, or ChatGPT, and how to troubleshoot the connection.

00:08:00 · SEP 13, 2026

त्वरित उत्तर

सर्वर URL और अपनी API key को बियरर टोकन के रूप में अपने MCP क्लाइंट के कॉन्फिग में जोड़ें (नीचे सटीक JSON), क्लाइंट रीस्टार्ट करें, और उसे URL से ट्रांसक्रिप्ट लाने के लिए कहें - कोई कॉपी-पेस्ट जरूरी नहीं।

MCP असल में क्या है

Model Context Protocol यह मानकीकृत करता है कि कोई AI क्लाइंट बाहरी टूल्स को कैसे डिस्कवर और कॉल करता है। इसके पीछे यह JSON-RPC 2.0 है - क्लाइंट सर्वर से पूछता है कि कौन से टूल्स मौजूद हैं और उनके इनपुट स्कीमा क्या हैं, फिर स्ट्रक्चर्ड आर्ग्युमेंट्स के साथ नाम से उन्हें इनवोक करता है और उसी बातचीत के भीतर एक स्ट्रक्चर्ड रिजल्ट पाता है।

MCP सर्वर दो ट्रांसपोर्ट में से किसी एक पर चलते हैं: stdio, जहां क्लाइंट सर्वर को एक लोकल सबप्रोसेस के रूप में लॉन्च करता है (उन टूल्स के लिए सामान्य जिन्हें लोकल फाइलसिस्टम एक्सेस चाहिए), या Streamable HTTP, जहां सर्वर रिमोट है और एक साथ किसी भी संख्या में क्लाइंट्स द्वारा HTTPS पर पहुंचा जा सकता है - यही इस सर्वर का ट्रांसपोर्ट है। (कुछ डॉक्यूमेंटेशन में एक पुराना HTTP+SSE ट्रांसपोर्ट मिलता है लेकिन वह Streamable HTTP के पक्ष में डेप्रिकेटेड है।) व्यवहार में, इसका मतलब है कि इस सर्वर को इस्तेमाल करने के लिए आपको लोकली कुछ भी चलाने की जरूरत नहीं - बस अपने क्लाइंट को URL पर पॉइंट करें।

उपलब्ध टूल्स

टूल	यह क्या करता है	कीमत
`get_youtube_transcript`	पूरा ट्रांसक्रिप्ट प्लस title, author, और thumbnail मेटाडेटा	1 क्रेडिट
`search_youtube`	YouTube पर वीडियो या चैनल सर्च करें, पेजिनेटेड	1 क्रेडिट
`get_channel_latest_videos`	किसी चैनल का मेटाडेटा प्लस उसके हाल के अपलोड्स	Free
`search_channel_videos`	एक चैनल के अंदर किसी क्वेरी के लिए सर्च करें, पेजिनेटेड	1 क्रेडिट
`list_channel_videos`	किसी चैनल के अपलोड किए गए हर वीडियो को लिस्ट करें, पेजिनेटेड	1 क्रेडिट
`list_playlist_videos`	किसी प्लेलिस्ट का हर वीडियो पाएं, पेजिनेटेड	1 क्रेडिट

पेजिनेटेड टूल्स (search, list-channel, list-playlist) सभी ऑफसेट/लिमिट जोड़े के बजाय, अगला पेज लाने के लिए पिछले रिस्पॉन्स से एक continuation टोकन स्वीकार करते हैं।

एक API key लें

dashboard से साइन अप करें और एक API key बनाएं - 100 क्रेडिट्स फ्री शामिल हैं, कार्ड की जरूरत नहीं। यह key ज्यादातर क्लाइंट्स के लिए वह बियरर टोकन है जिससे MCP सर्वर ऑथेंटिकेट करता है।

Claude Desktop या Claude Code में सर्वर जोड़ें

इसे अपने MCP क्लाइंट के कॉन्फिग में जोड़ें (जैसे claude_desktop_config.json, या Claude Code के लिए claude mcp add के जरिए):

{
  "mcpServers": {
    "getyoutubetranscript": {
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

sk_live_... को अपनी खुद की API key से बदलें। क्लाइंट को पूरी तरह रीस्टार्ट करें और ऊपर दिए गए 6 टूल्स अपने आप दिखने लगेंगे - ज्यादातर क्लाइंट यह कॉन्फिग केवल स्टार्टअप पर पढ़ते हैं, हॉट रीलोड पर नहीं।

अन्य क्लाइंट्स: Cursor, Windsurf, और कस्टम एजेंट्स

कोई भी क्लाइंट जो कस्टम हेडर्स के साथ Streamable HTTP पर एक रिमोट MCP सर्वर सपोर्ट करता है, वही कॉन्फिग शेप इस्तेमाल करता है - बस आसपास की फाइल और फील्ड नाम अलग होते हैं (जैसे Cursor का .cursor/mcp.json, Windsurf का MCP सेटिंग्स पैनल)। अगर कोई क्लाइंट स्टैटिक बियरर हेडर के बजाय केवल OAuth-आधारित सर्वर सपोर्ट करता है, तो इसके बजाय आगे बताए गए OAuth फ्लो का उपयोग करें।

ChatGPT कनेक्टर्स और OAuth-only क्लाइंट्स

उन क्लाइंट्स के लिए जो पेस्ट की गई API key के बजाय OAuth के जरिए MCP सर्वर ऑथेंटिकेट करते हैं (उदाहरण के लिए, ChatGPT के कस्टम कनेक्टर्स), यह सर्वर Dynamic Client Registration के साथ OAuth 2.1 भी सपोर्ट करता है - क्लाइंट को उसी सर्वर URL पर पॉइंट करें और यह OAuth मेटाडेटा डिस्कवर कर लेगा और सीधे बियरर टोकन मांगने के बजाय आपको एक ऑथराइज़ेशन फ्लो से गुज़ारेगा।

इससे कोई टूल इस्तेमाल करने को कहें

कनेक्ट होने के बाद, सामान्य प्रॉम्प्ट काफी हैं - कौन सा टूल कॉल करना है यह मॉडल तय करता है:

"youtube.com/watch?v=dQw4w9WgXcQ का ट्रांसक्रिप्ट लाओ और इसे 3 बुलेट्स में सारांशित करो।"
"YouTube पर 'Next.js server actions' सर्च करो और टॉप 5 रिजल्ट लिस्ट करो।"
"@mkbhd ने अपलोड किए गए हर वीडियो को लिस्ट करो और 'battery' का जिक्र करने वालों को ढूंढो।"

समस्या निवारण

MCP सर्वर से 401 का मतलब है बियरर टोकन गायब है, एक्सपायर हो गया है, या मैलफॉर्म्ड है - जांचें कि यह आपके डैशबोर्ड पर किसी सक्रिय key से मेल खाता है। अगर कॉन्फिग जोड़ने के बाद टूल्स बिल्कुल नहीं दिखते, तो क्लाइंट को लगभग हमेशा एक पूरे रीस्टार्ट की जरूरत होती है, रीलोड की नहीं।

चैट क्लाइंट इस्तेमाल करने के बजाय एक कस्टम एजेंट बना रहे हैं? यही सर्वर किसी भी MCP-कंपैटिबल क्लाइंट के साथ Streamable HTTP पर काम करता है। पूरा REST endpoint रेफरेंस, क्रेडिट्स, और रेट लिमिट्स API docs में हैं।

MCP सर्वर FAQs

Q01

MCP सर्वर क्या है, और YouTube ट्रांसक्रिप्ट के लिए मैं इसे क्यों इस्तेमाल करूं?

MCP (Model Context Protocol) किसी AI असिस्टेंट जैसे Claude को बातचीत के दौरान सीधे बाहरी टूल्स कॉल करने देता है। ट्रांसक्रिप्ट को चैट में पेस्ट करने के बजाय, आप Claude से इसे लाने को कहते हैं - यह टूल कॉल करता है, ट्रांसक्रिप्ट वापस पाता है, और उसी बातचीत में इसे सारांशित, अनुवादित, या सर्च कर सकता है।

Q02

क्या MCP एक सादे REST API रैपर के समान है?

नहीं। MCP किसी भी कंप्लायंट क्लाइंट में टूल डिस्कवरी और इनवोकेशन को मानकीकृत करता है - वही सर्वर Claude Desktop, Claude Code, Cursor, Windsurf, या किसी कस्टम एजेंट के साथ बिना क्लाइंट-स्पेसिफिक ग्लू कोड लिखे काम करता है। एक REST API के लिए अब भी आपको (या मॉडल को) सटीक endpoint शेप जाननी होगी; MCP टूल्स सेल्फ-डिस्क्राइबिंग होते हैं, इसलिए क्लाइंट उन्हें और उनके इनपुट स्कीमा को अपने आप लिस्ट करता है।

Q03

यह MCP सर्वर किस ट्रांसपोर्ट का उपयोग करता है?

Streamable HTTP - रिमोट, मल्टी-क्लाइंट MCP सर्वर के लिए मौजूदा ट्रांसपोर्ट (पुराना HTTP+SSE ट्रांसपोर्ट डेप्रिकेटेड है)। इसके पीछे, MCP मैसेज JSON-RPC 2.0 हैं, और ट्रांसपोर्ट लेयर बस उन मैसेज को सर्वर तक और वहां से लाने-ले जाने का काम करती है; इसे इस्तेमाल करने के लिए आपको JSON-RPC जानने की जरूरत नहीं, सिर्फ नीचे दिया गया कॉन्फिग चाहिए।

Q04

क्या MCP सर्वर इस्तेमाल करने के लिए मुझे एक API key चाहिए?

ज्यादातर टूल्स के लिए हां। रिक्वेस्ट एक बियरर टोकन से ऑथेंटिकेट होती हैं - वही API key जो आप REST API के लिए इस्तेमाल करेंगे। डैशबोर्ड से 100 फ्री क्रेडिट्स के लिए साइन अप करें, कार्ड की जरूरत नहीं। यह सर्वर ChatGPT कनेक्टर्स जैसे क्लाइंट्स के लिए भी OAuth 2.1 (Dynamic Client Registration) सपोर्ट करता है जो एक स्टैटिक हेडर के बजाय OAuth फ्लो से ऑथेंटिकेट करते हैं।

Q05

क्या इसमें REST API जितने ही क्रेडिट्स लगते हैं?

हां - हर सफल मीटर्ड टूल कॉल की कीमत 1 क्रेडिट है, REST API जैसा ही अकाउंटिंग। get_channel_latest_videos फ्री है और कभी क्रेडिट चार्ज नहीं करता। फेल्ड कॉल्स के लिए कभी चार्ज नहीं किया जाता।

Q06

कॉन्फिग जोड़ने के बाद टूल्स नहीं दिख रहे - मैं क्या जांचूं?

क्लाइंट को पूरी तरह रीस्टार्ट करें (सिर्फ विंडो रीलोड नहीं) - ज्यादातर क्लाइंट MCP सर्वर कॉन्फिग केवल स्टार्टअप पर पढ़ते हैं। फिर जांचें कि बियरर टोकन वैलिड है (एक एक्सपायर्ड या मैलफॉर्म्ड key 401 देती है, टूल्स न दिखने का लक्षण नहीं) और URL में कोई टाइपो नहीं है - एक गलत पाथ ऑथेंटिकेशन जांचे जाने से पहले ही 404 लौटाता है।

Q07

क्या अपनी API key को एक कॉन्फिग फाइल में रखना सुरक्षित है?

एक MCP कॉन्फिग फाइल को किसी अन्य क्रेडेंशियल फाइल की तरह ट्रीट करें - इसे किसी पब्लिक रिपो में कमिट न करें, और अगर आपके क्लाइंट में सीक्रेट्स/एनवायरनमेंट-वेरिएबल सपोर्ट है तो हार्डकोडेड key के बजाय उसे प्राथमिकता दें। कनेक्शन खुद HTTPS पर चलता है, इसलिए टोकन ट्रांजिट में उजागर नहीं होता।