通过 mcp_servers 的 Claude API YouTube 转录文本

如果你在请求中交给 Claude API 一个 MCP 服务器，它可以自己获取 YouTube 转录文本。Anthropic 的 MCP 连接器使 Messages API 拨出到远程服务器、发现其工具并在完成中间调用它们——你这边不需要工具执行循环。我今天针对 youtube2text.org 的托管 MCP 服务器验证了下面的块。

请求

MCP 连接器是一个测试功能，所以它需要 anthropic-beta: mcp-client-2025-11-20 标头，并且它需要两个必须相互引用的部分：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."
    }]
  }'

两个密钥在起作用，它们不可互换。标头中的 x-api-key 是你的 Anthropic 密钥。mcp_servers 内的 authorization_token 是你的 youtube2text 密钥——它作为承载令牌转发到转录文本服务器。通过 youtube2text.org/app/keys 的 Google 登录获得一个，或从 GET https://youtube2text.org/api/demo-key 拉取共享演示密钥（每个 IP 每月 5 个视频）。

返回的内容

响应 content 数组交错工具活动和答案：一个 mcp_tool_use 块显示 Claude 使用它从你的提示中提取的 URL 调用 transcribe_video，一个 mcp_tool_result 块携带 {title, content, contentSize, videoId, pubDate, truncated}，然后是带有实际摘要的 text 块。Anthropic 在服务器端运行整个工具往返——你的代码发送一个 HTTP 请求并读取最终消息。

因为连接器是测试版，要相应对待它：标头是强制的，请求形状已经改变过一次（较早的文章显示 mcp_servers 没有 mcp_toolset 条目——该形式早于当前标头）。固定测试版字符串并在假设转录文本到达之前检查 mcp_tool_result 块的响应。

无代码路径

不针对 API 构建？两行：在 claude.ai 中转到设置 → 连接器 → 添加自定义连接器，粘贴 https://youtube2text.org/mcp，完成 Google 登录，单击允许。服务器用动态客户端注册和 PKCE 说 OAuth 2.1，所以 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。