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
簡単な回答
MCPとは実際には何か
Model Context Protocolは、AIクライアントが外部ツールを検出・呼び出す方法を標準化するものです。内部的にはJSON-RPC 2.0を使用しています - クライアントはサーバーにどのツールが存在し、その入力スキーマが何かを尋ね、その後名前で構造化された引数を渡して呼び出し、構造化された結果を同じ会話ターン内で受け取ります。
MCPサーバーは2種類のトランスポートのいずれかで動作します。stdioはクライアントがサーバーをローカルのサブプロセスとして起動する方式(ローカルファイルシステムへのアクセスが必要なツールに一般的)で、Streamable HTTPはサーバーがリモートに存在し、任意の数のクライアントから同時にHTTPS経由でアクセスできる方式です - 本サーバーはこちらを使用しています。(一部のドキュメントには古いHTTP+SSEトランスポートの記載がありますが、Streamable HTTPへの移行に伴い非推奨となっています。)実用上、これは本サーバーを使うためにローカルで何かを実行する必要が一切なく、クライアントをそのURLに向けるだけでよいことを意味します。
利用可能なツール
| ツール | 機能 | コスト |
|---|---|---|
get_youtube_transcript | 文字起こし全文とタイトル、投稿者、サムネイルのメタデータ | 1クレジット |
search_youtube | YouTubeで動画またはチャンネルを検索(ページネーション対応) | 1クレジット |
get_channel_latest_videos | チャンネルのメタデータと最近のアップロード | 無料 |
search_channel_videos | 1つのチャンネル内でクエリを検索(ページネーション対応) | 1クレジット |
list_channel_videos | チャンネルがアップロードしたすべての動画を一覧表示(ページネーション対応) | 1クレジット |
list_playlist_videos | プレイリスト内のすべての動画を取得(ページネーション対応) | 1クレジット |
ページネーション対応のツール(search、list-channel、list-playlist)はいずれも、オフセット/リミットのペアではなく、前回のレスポンスから得られるcontinuationトークンを受け取って次のページを取得します。
APIキーを取得する
ダッシュボードからサインアップし、APIキーを作成してください - 100クレジットが無料で付与され、カード登録は不要です。このキーは、ほとんどのクライアントで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キーに置き換えてください。クライアントを完全に再起動すると、上記の6つのツールが自動的に表示されます - ほとんどのクライアントは起動時にのみこの設定を読み込み、ホットリロードでは読み込みません。
その他のクライアント: Cursor、Windsurf、カスタムエージェント
Streamable HTTP経由のリモートMCPサーバーをカスタムヘッダー付きでサポートするクライアントであれば、同じ形式の設定を使用できます - 周辺のファイル名やフィールド名が異なるだけです(例: Cursorの.cursor/mcp.json、Windsurfの MCP設定パネル)。静的なベアラーヘッダーではなくOAuthベースのサーバーのみをサポートするクライアントの場合は、次に説明するOAuthフローを使用してください。
ChatGPTコネクタとOAuth専用クライアント
貼り付けたAPIキーではなくOAuth経由でMCPサーバーを認証するクライアント(例: ChatGPTのカスタムコネクタ)向けに、本サーバーはDynamic Client Registrationを使ったOAuth 2.1もサポートしています - クライアントを同じサーバーURLに向けると、OAuthメタデータを検出し、ベアラートークンを直接尋ねる代わりに認可フローへと案内されます。
ツールを使うよう依頼する
接続後は、自然な依頼だけで十分です - どのツールを呼び出すかはモデルが判断します:
- 「youtube.com/watch?v=dQw4w9WgXcQの文字起こしを取得して、3つの箇条書きで要約して。」
- 「YouTubeで『Next.js server actions』を検索して、上位5件を一覧表示して。」
- 「@mkbhdがアップロードしたすべての動画を一覧表示して、『バッテリー』に言及しているものを探して。」
トラブルシューティング
チャットクライアントではなくカスタムエージェントを構築していますか?同じサーバーは、Streamable HTTP経由であらゆるMCP対応クライアントで動作します。完全なRESTエンドポイントリファレンス、クレジット、レート制限はAPIドキュメントに記載されています。
MCPサーバーに関するよくある質問
MCPサーバーとは何ですか?なぜYouTube文字起こしに使うのですか?
MCP(Model Context Protocol)は、Claudeのようなアシスタントが会話中に外部ツールを直接呼び出せるようにする仕組みです。文字起こしをチャットに貼り付ける代わりに、Claudeに取得を依頼するだけで、ツールを呼び出して文字起こしを受け取り、同じターン内で要約、翻訳、検索を行うことができます。
MCPは単純なRESTラッパーと同じですか?
いいえ。MCPは、準拠するあらゆるクライアントでツールの検出と呼び出しを標準化します - 同じサーバーが、クライアント固有のグルーコードを書くことなくClaude Desktop、Claude Code、Cursor、Windsurf、カスタムエージェントで動作します。REST APIでは、依然としてお客様(またはモデル)が正確なエンドポイントの形式を知っている必要がありますが、MCPツールは自己記述的であるため、クライアントが自動的にツールとその入力スキーマを一覧表示します。
このMCPサーバーはどのトランスポートを使用していますか?
Streamable HTTPです - リモートかつマルチクライアント対応のMCPサーバーの現行トランスポートです(古いHTTP+SSEトランスポートは非推奨です)。内部的にはMCPメッセージはJSON-RPC 2.0であり、トランスポート層はそれらのメッセージをサーバーとの間でやり取りするだけです。利用にJSON-RPCの知識は不要で、下記の設定だけで十分です。
MCPサーバーの利用にAPIキーは必要ですか?
ほとんどのツールでは必要です。リクエストはベアラートークン - REST APIで使うのと同じAPIキー - で認証されます。ダッシュボードから100無料クレジットでサインアップでき、カード登録は不要です。本サーバーは、静的なヘッダーの代わりにOAuthフローで認証するChatGPTコネクタのようなクライアント向けに、OAuth 2.1(Dynamic Client Registration)もサポートしています。
これはREST APIと同じようにクレジットがかかりますか?
はい - 成功した従量制ツール呼び出し1回につき1クレジットで、REST APIと同じ課金方式です。get_channel_latest_videosは無料で、クレジットが課金されることはありません。失敗した呼び出しに課金されることはありません。
設定を追加してもツールが表示されません - 何を確認すればよいですか?
クライアントを完全に再起動してください(ウィンドウのリロードだけでは不十分です)- ほとんどのクライアントはMCPサーバーの設定を起動時にのみ読み込みます。次に、ベアラートークンが有効か確認してください(期限切れや形式不正のキーは401を返しますが、ツールが表示されない症状とは異なります)。また、URLにタイプミスがないか確認してください - パスが間違っていると、認証チェックの前に404が返されます。
設定ファイルにAPIキーを書くのは安全ですか?
MCPの設定ファイルは他の認証情報ファイルと同様に扱ってください - 公開リポジトリにコミットせず、ハードコードされたキーよりもクライアントのシークレット/環境変数のサポートを優先してください。接続自体はHTTPS経由で行われるため、通信中にトークンが露出することはありません。
関連記事