MCP 服务器
面向 AI 代理的 transcript.im MCP 服务器
transcript.im MCP 服务器为 AI 客户端提供一个可直接调用的转录工具。把 Claude、ChatGPT、Cursor 或 OpenAI Agent Builder 指向服务器并提供 API 密钥，模型就能从公开链接获取转录、启动批量任务、导出字幕或检索 YouTube，无需浏览器，也无需定制集成。它是远程 HTTP 端点，因此托管客户端只需要 URL 和密钥，而不需要本地安装。
- 一个远程端点
https://mcp.transcript.im/mcp，用你的 API 密钥认证，无需安装。 - 11 个工具，覆盖转录、批量、导出、YouTube 检索和用量。
- 不含 AI 工具——模型已在你的客户端中运行；服务器只提供转录和平台数据。
- 与 REST API 相同的账户、相同的抽取流水线。
- 长转录按分页令牌切分，单个结果不会淹没上下文窗口。
transcript.im MCP 服务器做什么
Model Context Protocol 让客户端发现并调用服务器发布的工具。transcript.im MCP 服务器把这套接口用于一件事：把公开的视频或音频链接变成转录，并回答围绕它的平台问题。客户端带上 URL 调用 get_transcript；服务器接入 transcript.im 抽取流水线，有创作者字幕时优先使用，没有时回退到 AI 转录。
- 把转录抽取当作工具——一次调用就把链接变成带时间戳的文本。
- 还有 YouTube 检索——搜索视频、解析频道、列出上传和播放列表条目，并读取字幕元数据。
- 批量与导出——把许多链接排队，然后导出完成的结果集。
- 内部不含模型——服务器返回数据，由客户端决定如何使用。
你的代理可以调用的工具
转录
get_transcript 从 URL 抽取转录，或读取长转录的下一段；get_transcript_info 在你决定抽取前返回视频元数据以及 API 能解析到的字幕轨道。两者配合，代理可以判断某个视频是否值得转录、请求真正需要的语言优先级，然后获取带或不带时间戳的文本。
批量与导出
create_batch 从 URL 列表、播放列表或频道启动一次执行；get_batch 报告状态、计数和下一页条目；export_batch 把完成的批量转成文本或字幕。代理因此可以处理某位创作者的全部内容，而不是一次一个片段；单个链接失败会被单独报告，而不会丢弃其余结果。
YouTube 检索
search_video 按主题查找视频或频道，get_channel 解析 handle 或 URL，list_channel_video 列出频道上传，list_playlist_item 遍历播放列表，list_caption 读取视频的字幕元数据和转录文本。代理用这些工具调研细分领域、查看创作者发布过什么，并在转录之前选对来源。
账户
get_usage 报告账户的用量摘要，让代理在投入大批量或长频道前看到账户已经用了多少，而不是在执行到一半才发现限制。
连接你已经在用的客户端
Claude
把远程服务器添加为自定义连接器，或从命令行注册。Claude 会与 MCP 服务器协商，把其工具暴露到对话中，并在多轮之间保持可用，因此你可以用自然语言要一份转录，紧接着再要一份总结，而不必重复链接。
ChatGPT
添加 MCP 连接器并选择 API 密钥认证。ChatGPT 随后会像调用其他已连接应用一样调用转录工具，这意味着聊天中粘贴的视频链接可以变成模型能够引用、翻译或分析的文本。
Cursor 及其他编辑器
把编辑器的 mcpServers 配置连同 API 密钥指向远程 URL。编辑器的代理就能转录链接，并把结果直接写进你的项目或笔记。
OpenAI Agent Builder
用服务器 URL 和 Bearer 凭证添加一个 MCP 工具，代理就能把转录当作更大工作流中的一步，把文本交给后续环节，而无需定制连接器。
连接与认证
服务器是远程 HTTP 端点，因此连接客户端只需 URL 和密钥，而不是安装。
- 远程 HTTP——把
https://mcp.transcript.im/mcp加入你的 MCP 客户端；你的机器上无需运行任何东西。 - API 密钥——把密钥作为
Authorization: Bearer <key>或x-api-key发送；服务器会把它转发给 REST API，因此适用同一个账户和同一套权限。 - 工具发现——端点会响应 MCP 发现请求，客户端可以在调用之前枚举它暴露的工具。
- 结果一致——工具、分块和错误与同一账户从 REST API 得到的一致，因此行为不取决于客户端。
长转录依然可控
两小时的录音可能产生远超模型单个工具结果应接收的文本，因此服务器把长转录按有界分块返回。每个分块会报告 truncated: true 和不透明的 nextPageToken；只带该令牌再次调用 get_transcript 会返回下一段，代理重复此过程直到转录取完。
- 结果有界——每个分块都有上限，单个结果不会淹没上下文窗口，也不会挤掉先前的推理。
- 无状态分页——令牌携带位置，调用之间不保留服务器会话，因此任何副本都能提供下一段。
- JSON 分页——JSON 转录按段分页，结构化消费方可以在遍历文本时保持自己期望的 schema。
- 任务轮询——没有字幕的视频会返回一个任务 ID，代理轮询它直到转录就绪。
- 开头可读——第一段就足以回答关于开头的问题，简短的追问不必拉取整份转录。
你的代理能据此行动的错误
当工具调用失败时，服务器返回带有可读文本的 MCP 错误，而不是堆栈跟踪。结构化细节随结果一同返回，让代理可以恢复而不是猜测：code、HTTP status、达到限制时的 upgradeUrl，以及请求的语言不可用时的 availableLanguages。这把死路变成下一步动作——换一种语言、换一个链接，或把限制告诉对话中的人。能读懂失败原因的模型可以修正自己的下一次尝试，这正是能有效重试的代理和卡在同一个坏调用上的代理之间的差别。
相关
MCP 服务器常见问题
transcript.im MCP 服务器是什么？
transcript.im MCP 服务器是一个 Model Context Protocol 接口，把转录抽取、批量任务、导出和 YouTube 检索作为 AI 客户端可调用的工具暴露出来。
哪些客户端可以连接 transcript.im MCP 服务器？
Claude、ChatGPT、Cursor、OpenAI Agent Builder 以及任何其他 MCP 客户端都可以用 API 密钥连接远程 HTTP 端点。
transcript.im MCP 服务器包含 AI 工具吗？
不包含。服务器有意只暴露数据和抽取工具，因为负责总结或改写的模型已经由客户端运行。
代理如何从视频链接获取转录？
它带上链接调用转录工具；服务器优先使用已有字幕，没有时回退到 AI 转录，并返回带时间戳的文本。
MCP 服务器如何处理长转录？
长转录按有界分块返回。每个结果带有截断标志和分页令牌，代理用该令牌再次调用工具读取下一段。
代理可以通过 transcript.im MCP 服务器运行批量吗？
可以。批量工具接受 URL 列表、播放列表或频道，报告状态和计数，并把完成的结果集导出为文本或字幕。
transcript.im MCP 服务器支持 YouTube 搜索和频道吗？
支持。专用工具覆盖视频和频道搜索、频道解析、频道上传、播放列表条目和字幕元数据。
MCP 服务器如何认证客户端？
它接受作为 Bearer 令牌或 x-api-key 请求头的 API 密钥，并转发给 REST API，因此其调用与直接 API 请求落在同一个账户上。