HomeBlogTranscribePlansAPI Keys

Claude API YouTube文字起こし (mcp_servers経由)

Claude Messages APIリクエストはmcp_serversブロックでYouTube文字起こしを取得

Claude APIはリクエストでMCPサーバーを渡された場合、それ自体でYouTube文字起こしを取得できます。AnthropicのMCPコネクタはMessages APIが遠隔サーバーにダイアルアウトし、そのツールを検出し、完成中に呼び出すことができます―あなたの側でツール実行ループはありません。今日、youtube2text.orgのホストされたMCPサーバーに対してブロックを確認しました。

リクエスト

MCPコネクタはベータ機能なので、anthropic-beta: mcp-client-2025-11-20ヘッダーが必要で、互いに参照する必要がある2つの半分を取ります: mcp_serversエントリは接続を宣言し、tools内のmcp_toolsetエントリは名前でアクセスを許可します。ツールセットを省略すると、APIは検証エラーでリクエストを拒否します。

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 16000,
    "mcp_servers": [{
      "type": "url",
      "url": "https://youtube2text.org/mcp",
      "name": "youtube2text",
      "authorization_token": "YOUR_API_KEY"
    }],
    "tools": [{"type": "mcp_toolset", "mcp_server_name": "youtube2text"}],
    "messages": [{
      "role": "user",
      "content": "Summarize https://www.youtube.com/watch?v=dQw4w9WgXcQ in five bullets."
    }]
  }'

2つのキーが関係していて、それらは相互交換可能ではありません。ヘッダーのx-api-keyはあなたのAnthropicキーです。mcp_servers内のauthorization_tokenはあなたのyoutube2textキーです―トランスクリプトサーバーにベアラートークンとして転送されます。youtube2text.org/app/keysでGoogleサインインを通じて1つを取得するか、GET https://youtube2text.org/api/demo-keyから共有デモキーを取得します（月5ビデオあたりIP）。

戻ってくるもの

レスポンスcontent配列は、ツール活動と答えをインターリーブします: mcp_tool_useブロックがClaudeがプロンプトから抽出したURLでtranscribe_videoを呼び出すことを示し、mcp_tool_resultブロックは{title, content, contentSize, videoId, pubDate, truncated}を運び、textブロックは実際の概要です。Anthropicはツールの往復全体をサーバー側で実行します―コードは1つのHTTPリクエストを行い、最終メッセージを読みます。

コネクタはベータであるため、それに応じてそれを処理します: ヘッダーは必須であり、リクエスト形状は既に1回変更されています（古い書き込みはmcp_serversなしでmcp_toolsetエントリを示します―その形式は現在のヘッダーより前です）。ベータ文字列をピンし、トランスクリプトが到着したと仮定する前にmcp_tool_resultブロックのレスポンスをチェックします。

ノーコードパス

APIに対して構築していない場合? 2行: claude.aiで設定→コネクタ→カスタムコネクタを追加に移動し、https://youtube2text.org/mcpを貼り付け、Googleサインインを完了し、許可をクリックします。サーバーはOAuth 2.1を動的クライアント登録とPKCEで話すため、claude.aiは全体のハンドシェイクを処理します―詳細およびそれで何をするかについてはClaude での無料YouTube文字起こしを参照してください。

Claude Codeユーザーは同じツールを取得します:

claude mcp add --transport http youtube2text https://youtube2text.org/mcp

その後、サインインするセッション内で/mcpを実行します。

どれを使用するか

Messages APIで製品を構築する場合はmcp_serversブロックを使用し、既存のエージェントループ内でトランスクリプトアクセスが必要な場合。テキストだけが必要な場合はRESTエンドポイントを直接使用します―Claudeを通じてトランスクリプトをパイプしてそれを抽出して戻す場合は、高価なアイデンティティ関数です。スタックがOpenAI側にある場合、Responses APIは同じMCPサーバーを取得し、ほぼ同じブロックがあります。

使用はyoutube2textプランに対して測定されます: 無料は月5ビデオ、基本は$5.99/50、プロは$9.99/500、無制限は$19.99。キーはyoutube2text.org/app/keysにあります。