---
title: "面向 AI 代理的 transcript.im MCP 服务器"
description: "将 Claude、ChatGPT、Cursor 或 OpenAI Agent Builder 连接到 transcript.im MCP 服务器，把转录、批量和 YouTube 检索作为工具交给你的代理。"
canonical: "https://transcript.im/zh-hans/mcp"
markdown: "https://transcript.im/zh-hans/mcp.md"
---

# 面向 AI 代理的 transcript.im MCP 服务器

将 Claude、ChatGPT、Cursor 或 OpenAI Agent Builder 连接到 transcript.im MCP 服务器，把转录、批量和 YouTube 检索作为工具交给你的代理。

## 链接

- [标准 HTML 页面](https://transcript.im/zh-hans/mcp)
- [Markdown](https://transcript.im/zh-hans/mcp.md)


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 转录。

由于繁重的工作在服务器上，客户端不需要下载器、浏览器自动化栈或自己的语音识别模型，只需要一次工具调用。这正是 MCP 转录服务器的意义：模型已经是你在这里的原因，服务器专注于数据。

- 把转录抽取当作工具——一次调用就把链接变成带时间戳的文本。
- 还有 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`。这把死路变成下一步动作——换一种语言、换一个链接，或把限制告诉对话中的人。能读懂失败原因的模型可以修正自己的下一次尝试，这正是能有效重试的代理和卡在同一个坏调用上的代理之间的差别。

## 相关

- [REST API](/zh-hans/api)
- [Agent Skills](/zh-hans/skills)
- [API 文档](/docs)
- [YouTube 字幕提取](/zh-hans/youtube-transcript)
- [YouTube 视频总结](/zh-hans/youtube-video-summarizer)
- [字幕生成器](/zh-hans/youtube-subtitle-generator)
- [YouTube 字幕下载](/zh-hans/youtube-subtitle-downloader)
- [频道转录](/zh-hans/youtube-channel-transcript)
- [播放列表转录](/zh-hans/youtube-playlist-transcript)
## 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 请求落在同一个账户上。

## 连接 transcript.im MCP 服务器

把服务器 URL 加入你的 MCP 客户端，提供 API 密钥，再向你的代理要一份转录。

- [创建 API 密钥](/app/account/api-keys)
- [阅读 API 契约](/docs)