# 让AI助手用MCP转录视频和录音

> 通过MCP 转录，在Claude、ChatGPT或代码编辑器中获取社交媒体视频及文件的转录文本。用OAuth或API密钥连接，读取带时间戳的文字。

Canonical: https://transcript1.com/zh/features/mcp-zhuanlu
Language: zh-Hans
Last updated: 2026-10-19

通过MCP 转录，AI助手可以读取视频或录音里的话。支持YouTube、X、TikTok、Instagram、Facebook、Bluesky，以及Twitch剪辑和已结束的VOD、Dailymotion视频、Pinterest视频Pin、LinkedIn视频帖子、Snapchat Spotlight视频和上传的录音。Claude、ChatGPT用OAuth连接；Cursor、VS Code和Claude Code使用API密钥。

- 支持Claude、ChatGPT、Cursor、VS Code和Claude Code
- 与REST API共用分钟额度和限制
- 完整视频链接可复用24小时内的匹配转录

## 连接一次，后续在对话里提交录音和视频

### 不用安装本地服务

客户端通过streamable HTTP连接https://api.transcript1.com/mcp，转录服务由transcript1托管。

### 按客户端选择连接方式

Claude和ChatGPT的自定义连接器使用OAuth登录。Cursor、VS Code、Claude Code及其他智能体使用API密钥，以Bearer Token发送。

### 创建、读取和管理转录

提供8个工具：transcribe、get_transcription、list_transcriptions、create_upload、get_upload_status、complete_upload、delete_transcription和get_account。

### 长录音分段读取

默认返回带时间戳的文字，每行对应一段。较长的转录会在段落边界分页，助手可以继续读取后面的内容。

### 已有任务不必重复创建

transcribe可为完整视频链接复用24小时内的匹配转录，短分享链接不支持这种复用。已知任务ID时，直接用get_transcription读取。

## 配置Cursor MCP 视频转录

Cursor把服务地址和API密钥写入.cursor/mcp.json；VS Code在.vscode/mcp.json里使用同一地址。[MCP配置文档](https://transcript1.com/zh/docs/mcp)也提供这两个客户端的一键安装入口。

客户端需要支持远程MCP，并在请求中发送Authorization头。Cursor和VS Code的配置结构不同，请复制对应客户端的配置，不要只改文件名。

配置好后，先让助手调用get_account或list_transcriptions。这能验证连接和认证，不会创建付费转录任务。

看不到工具时，检查客户端是否加载了配置、是否启用服务。调用提示未授权时，检查客户端保存的API密钥。

### .cursor/mcp.json

```
{
  "mcpServers": {
    "transcript1": {
      "url": "https://api.transcript1.com/mcp",
      "headers": {
        "Authorization": "Bearer t1_YOURKEY"
      }
    }
  }
}
```

## Claude Code用命令连接，Claude和ChatGPT用OAuth

Claude Code通过claude mcp add添加服务地址和API密钥。Claude添加自定义连接器后登录，ChatGPT连接器也使用同一地址。操作步骤见[客户端连接说明](https://transcript1.com/zh/docs/mcp#claude)。

Claude和ChatGPT的自定义连接器走OAuth登录，能否使用取决于助手的套餐和工作区设置。代码客户端使用API密钥，是另一种配置方式，按实际使用的客户端操作即可。

工具可用后，给助手一个公开视频链接和明确任务。比如先获取Instagram Reel的转录文本，再整理里面口述的操作步骤。

transcript1提供的是音频中的文字。助手没有看过画面，就不能把转录文本当成对画面内容的观察。

### Claude Code

```
claude mcp add --transport http transcript1 https://api.transcript1.com/mcp --header "Authorization: Bearer t1_YOURKEY"
```

## 让助手读完相关内容，再分析视频

助手先调用transcribe，等待完成后读取第一页；尚未完成时，会拿到ID，再用get_transcription查询。参数见[MCP工具文档](https://transcript1.com/zh/docs/mcp#tools)，分页和复用方式见[智能体工作流](https://transcript1.com/zh/use-cases/ai-zhinengti-shipin-zhuanlu)。

默认输出是带时间戳的文字。长转录会返回next_from_seconds，把它作为下一次的from_seconds就能继续读取。第一页不代表全文，助手应读完相关页面再总结整段录音。

完整视频链接可匹配过去24小时内的同选项转录，短分享链接在提交时无法匹配。不管原先用了哪种链接，已知ID后都应读取原任务，而不是再次创建。

下面的调用使用占位链接，实际使用时要换成真实、公开的TikTok视频地址。

### 助手调用示例

```
transcribe(url="[public TikTok video URL]")

get_transcription(id="tr_8fK2Lm0PqRsTuVwXyZaBcD", format="srt")
```

## 本地文件能不能上传，要看助手的运行环境

MCP传递的是工具请求和响应，不负责传输录音的二进制内容。create_upload先创建上传任务并返回分块方案；能读取本地文件、发送HTTP请求的智能体，再通过普通HTTP请求上传分块，最后调用complete_upload。文件内容不经过MCP，详见[文件上传说明](https://transcript1.com/zh/docs/mcp#files)。

有些助手能调用远程工具，却不能读取电脑上的路径或发送二进制数据。这时先在控制台上传录音，再把已完成的任务ID交给助手。只在聊天里写一个文件名，并不会把文件传给transcript1。

MCP工具不提供Webhook参数，需要回调时使用REST API。对话场景可以短暂等待，再用get_transcription继续查询。连接断开后，先按已知ID读取或列出近期任务，不能凭断线就认定任务没有创建。

同一连接既能获取[Bluesky视频文字](https://transcript1.com/zh/features/bluesky-shipin-zhuan-wenzi)，也能让助手检查[TikTok脚本](https://transcript1.com/zh/features/tiktok-shipin-zhuan-wenzi)。平台访问限制仍然适用：帖子须公开，文字只反映音频，不包含未经查看的画面信息。

## 常见问题

### 哪些AI助手可以连接？

Claude和ChatGPT可用自定义连接器；Cursor和VS Code有一键安装；Claude Code用一条命令配置。其他支持远程MCP服务器的客户端也可以连接。

### 一定要API密钥吗？

Claude和ChatGPT用OAuth登录，不必手动填写API密钥。其他客户端在Authorization头发送以t1_开头的API密钥，可在控制台“API keys”页面创建。

### 能让助手直接转录电脑里的录音吗？

可以，前提是助手能读取本地文件并发送二进制HTTP请求。先用create_upload创建上传任务，再通过普通HTTP请求发送分块，文件内容不经过MCP；最后调用complete_upload开始转录。

### MCP会单独扣一份分钟数吗？

不会。MCP工具使用当前凭证调用同一个API，与REST API共用分钟额度，计费、速率限制和错误码也相同。

## 相关内容

- [AI智能体与LLM](https://transcript1.com/zh/use-cases/ai-zhinengti-shipin-zhuanlu)
- [MCP服务器接入指南 （文档）](https://transcript1.com/zh/docs/mcp)
- [TikTok转文字](https://transcript1.com/zh/features/tiktok-shipin-zhuan-wenzi)
- [音视频文件API](https://transcript1.com/zh/features/yinpin-zhuan-wenzi-api)