参考

文稿 MCP 服务器

为 Claude、Cursor、Windsurf 或你自己的智能体提供搜索 YouTube、列出 TikTok 个人主页和读取视频文稿的工具。支持 OAuth 登录的远程服务器，也可以用 npx 在本地运行。

更新于 2026年10月9日

MCP 服务器为 AI 智能体提供与你的 API 密钥相同的 API：它可以在对话过程中查找视频、转录视频并读取结果。它会消耗你的点数。无需安装任何东西：让客户端指向远程服务器 https://www.transcriptdock.com/mcp 即可。

连接#

Claude（claude.ai、桌面版、移动版）#

打开自定义，连接器，然后选择 添加自定义连接器。
把它命名为 Transcript Dock，并把 https://www.transcriptdock.com/mcp 粘贴为服务器 URL。高级设置保持为空。
选择添加，再选择连接。登录 Transcript Dock，然后选择允许访问。

整个过程不涉及 API 密钥：连接器使用你的账户登录，可以读取和提交任务、读取文稿，但永远无法访问密钥、账单或账户设置。在 Team 和 Enterprise 套餐中，由所有者在“组织设置，连接器”中添加一次，然后每位成员各自连接。

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 和其他客户端#

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "transcriptdock": {
      "url": "https://www.transcriptdock.com/mcp",
      "headers": { "Authorization": "Bearer td_live_YOUR_KEY" }
    }
  }
}

Windsurf 使用 serverUrl 而不是 url，VS Code 则把服务器列在 servers 下，并带有 "type": "http"。下面的各个客户端页面提供了完整的文件内容。

本地服务器#

对于只支持 stdio 的客户端，例如 OpenClaw，请在本地运行同一个服务器，需要 Node.js 22.15 或更高版本。两个变量都是必需的。

MCP 配置

{
  "mcpServers": {
    "transcriptdock": {
      "command": "npx",
      "args": ["-y", "@transcriptdock/mcp"],
      "env": {
        "TRANSCRIPTDOCK_API_KEY": "td_live_YOUR_KEY",
        "TRANSCRIPTDOCK_BASE_URL": "https://www.transcriptdock.com"
      }
    }
  }
}

远程服务器把每次工具调用限制在大约 40 秒内。超过这个时间仍在运行的任务会连同它的 ID 一起返回，智能体可以再次调用 wait_for_job。

工具#

工具	作用	点数
`get_video_transcript`	传入 URL，返回文稿。负责提交、等待，并返回文本（或 srt、vtt、分段）。	1 个，使用 AI 转录时每分钟 2 个
`transcribe`	提交任务并直接返回，不等待。	相同
`wait_for_job`	等待任务完成。	免费
`get_job`	任务状态、错误和计费信息。	免费
`get_transcript`	按 ID 读取文稿，格式为分段、文本、srt 或 vtt。	免费
`list_jobs`	最近的任务。	免费
`search_youtube`	搜索 YouTube。	每页 1 个
`list_channel_videos`	某个频道的视频，按从新到旧排序，支持分页。	每页 1 个
`get_channel_latest_videos`	某个频道最新的 10 个视频。	1 个
`search_channel_videos`	在单个频道内搜索。	每页 1 个
`list_playlist_videos`	某个播放列表的视频。	每页 1 个
`list_tiktok_user_videos`	TikTok 个人主页最新的视频（最多 10 个）以及主页统计数据。	1 个
`get_video_discovery`	按 ID 读取视频发现结果，例如在超时之后。	免费

get_video_transcript#

当被问到某个视频说了什么时，智能体应该使用的工具。

urlstring必填: YouTube 或 TikTok 视频 URL。
mode"captions_only" | "auto" | "transcribe"可选: 默认 captions_only（1 个点数）。auto 在视频没有字幕时改用 AI 转录；transcribe 始终使用 AI 转录（按已开始的分钟数计费，每分钟 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 中，移除连接器后重新添加，以重新登录。使用密钥时，密钥要放在服务器配置中（请求头或环境变量），而不是放在你的 shell 里；也请确认它没有被撤销。
无法连接到 MCP 服务器（Couldn't reach the MCP server）：请使用准确的 URL https://www.transcriptdock.com/mcp，包括 www。
找不到工具（Tool not found）：修改配置后请重启客户端。
本地服务器无法启动：请安装 Node.js 22.15 或更高版本，并同时设置 TRANSCRIPTDOCK_API_KEY 和 TRANSCRIPTDOCK_BASE_URL。
NO_CAPTIONS：视频没有字幕。在付费套餐中，请使用 mode: "auto"。

站点菜单

文档