配置Cursor MCP 视频转录
Cursor把服务地址和API密钥写入.cursor/mcp.json;VS Code在.vscode/mcp.json里使用同一地址。MCP配置文档也提供这两个客户端的一键安装入口。
客户端需要支持远程MCP,并在请求中发送Authorization头。Cursor和VS Code的配置结构不同,请复制对应客户端的配置,不要只改文件名。
配置好后,先让助手调用get_account或list_transcriptions。这能验证连接和认证,不会创建付费转录任务。
看不到工具时,检查客户端是否加载了配置、是否启用服务。调用提示未授权时,检查客户端保存的API密钥。
{
"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连接器也使用同一地址。操作步骤见客户端连接说明。
Claude和ChatGPT的自定义连接器走OAuth登录,能否使用取决于助手的套餐和工作区设置。代码客户端使用API密钥,是另一种配置方式,按实际使用的客户端操作即可。
工具可用后,给助手一个公开视频链接和明确任务。比如先获取Instagram Reel的转录文本,再整理里面口述的操作步骤。
transcript1提供的是音频中的文字。助手没有看过画面,就不能把转录文本当成对画面内容的观察。
claude mcp add --transport http transcript1 https://api.transcript1.com/mcp --header "Authorization: Bearer t1_YOURKEY"让助手读完相关内容,再分析视频
助手先调用transcribe,等待完成后读取第一页;尚未完成时,会拿到ID,再用get_transcription查询。参数见MCP工具文档,分页和复用方式见智能体工作流。
默认输出是带时间戳的文字。长转录会返回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,详见文件上传说明。
有些助手能调用远程工具,却不能读取电脑上的路径或发送二进制数据。这时先在控制台上传录音,再把已完成的任务ID交给助手。只在聊天里写一个文件名,并不会把文件传给transcript1。
MCP工具不提供Webhook参数,需要回调时使用REST API。对话场景可以短暂等待,再用get_transcription继续查询。连接断开后,先按已知ID读取或列出近期任务,不能凭断线就认定任务没有创建。
同一连接既能获取Bluesky视频文字,也能让助手检查TikTok脚本。平台访问限制仍然适用:帖子须公开,文字只反映音频,不包含未经查看的画面信息。