Taption MCP
将 Taption 连接至兼容 MCP 的客户端，即可在对话中转录及翻译影音、阅读完成的转录稿与翻译，并浏览最近的工作。
模型上下文协定（MCP）让助理代表您呼叫 Taption 工具。此自定义连接支持读取转录稿，以及建立转录与翻译工作。
服务器网址
https://api.taption.com/mcp-custom新增 Taption 远端 MCP 服务器时，请使用完整网址。
- 传输方式
- Streamable HTTP
- 验证方式
- OAuth 2.1
使用条件
- Taption 账号，无需付费订阅。若使用电子邮件与密码登录，连接前须先验证电子邮件。
- 建立转录与翻译工作需有可用的分钟数，并受账号方案与使用限制约束。
- 支持远端 Streamable HTTP 及 OAuth 登录的客户端。客户端方案及工作区政策可能影响访问。
支持的媒体来源
可使用影音文件直连网址、公开的 Google Drive 文件或 YouTube 影片。自定义端点也支持 Facebook、Instagram、TikTok、X、Threads、Vimeo、Dailymotion、Bilibili（bilibili.tv）的公开贴文，以及 Twitch 影片与剪辑。
ChatGPT 的文件整合可用时，也能提供已上传的影音文件。其他客户端可使用可下载的媒体网址。
Taption 必须能访问连结。不支持直播，请使用已结束的录影。
设置客户端
选择您的应用，查看完整的分步设置指南。
验证
Taption 使用 OAuth 2.1 与 PKCE。登录 Taption 并核准连接后，客户端会处理授权并自动更新有效期一小时的访问令牌。
MCP 使用 OAuth 访问令牌，无法使用 Taption REST API 金钥验证。
设置全程请使用 /mcp-custom 网址。为 /mcp 核发的令牌无法用于 /mcp-custom。
若要撤销访问，请在 Taption 的「帐户 → 已连接的应用程式」中中断客户端连接。之后可重新连接并授权。
连接权限
transcripts:read- 读取转录稿状态与内容，并列出最近的转录稿。
transcripts:write- 使用账号分钟数建立转录与翻译工作。
支持的工作流程
提供媒体与所需输出，助理会使用 Taption 工具完成以下步骤。
选择媒体与输出
提供连结或支持的上传文件、音频语言与用途：一般转录稿、说话者标记或字幕。开始前，助理会询问缺少的选项。
转录并追踪进度
transcribe 立即返回 ID。get_transcript 会短暂等待即将完成的工作；若仍在处理中，约一分钟后再询问。若在 Taption 开启了电子邮件通知，完成时也会收到邮件。
阅读、摘要与导出
在助理中阅读完成的文字或请助理摘要内容。可用时开启 SRT 下载与编辑器连结，Taption 编辑器另提供其他导出格式。
试着询问助理
请转录这段英语录影，并标记两位说话者：[your media URL]。
请为这段日语影片建立字幕：[your media URL]。每行使用 16 个字符。
请将这段英语访谈转录为字幕，再翻译成日语和西班牙语：[your media URL]。
请将我的“Weekly sync”转录稿翻译成繁体中文。
找出我最近的 Taption 转录稿，并摘要已完成的访谈。如果有字幕下载与编辑器连结，也请附上。
将 [your media URL] 换成您的连结。摘要由助理根据转录稿产生；字幕长度自定义功能依 Taption 方案而定。
transcribe
建立背景转录工作。提供 media_url 或 file，音频语言及用途必须由使用者指定。缺少任何一项时会询问，不会开始工作。加入 translate_to，转录完成后即自动翻译转录稿。
参数
media_urlstring择一媒体来源支持的媒体连结，最多 2,048 个字符。与 file 择一提供。
fileobject择一媒体来源客户端提供的上传文件，需有 download_url 与 file_id；mime_type、file_name 为选填。Taption 必须能下载该网址。
languagestring开始前必须提供音频语言标签，例如 en-US、zh-TW、ja-JP、es-ES。请询问使用者，不可从文件名或对话语言推测。
查看支持的语言标签purposestring开始前必须提供transcript：含标点的文字；speakers：说话者标记；captions：短字幕片段。仅要求「转录」并不代表已选用途。
transcriptspeakerscaptionsspeaker_countintegerspeakers 的预估说话者数：2–10。未提供时默认为 2。
max_charactersinteger符合资格的付费方案可为 captions 设置每行 1–200 个字符。zh/ja/ko/yue 默认为 16，其他语言为 65。
translate_tostring[]选填。转录完成后要翻译的 1–5 种语言，例如 en、ja 或 zh-TW。每个语言另扣除与媒体时长相同的分钟数。
extensionstring无法自动判断上传格式时提供扩展名，连结不需要。支持音讯与部分影片格式，不支持 3gp。
namestring转录稿名称，最多 200 个字符。省略时使用来源文件名。
工具参数示例
{
"media_url": "https://example.com/interview.mp4",
"language": "en-US",
"purpose": "speakers",
"speaker_count": 2,
"translate_to": [
"ja"
],
"name": "Interview"
}以下为示范值，请换成您的媒体网址或转录稿 ID。
返回转录稿 ID 与状态。每次成功建立都会新增工作并消耗转录分钟数；translate_to 的每个语言另扣除与媒体时长相同的分钟数。请用原 ID 查询进度，避免重复提交。
get_transcript
查询进度，或以含时间戳的文字、SRT、VTT 读取已完成的转录稿。传入 language 可读取其中一份翻译。首页会在可用时包含 download_url 与 editing_url，并列出转录稿的翻译及其状态。
参数
idstring必填transcribe 或 list_transcripts 返回的转录稿 ID，包含 1–128 个英文字母、数字、下划线或连字号。
languagestring要读取的翻译语言代码，例如 ja。省略则读取原始转录稿。
formatstring输出格式，默认为 text。
textsrtvttoffsetinteger从 0 开始的短语位置，默认为 0。使用返回的 next_offset 读取下一页。
limitinteger每页最多短语数：1–500，默认为 200。
工具参数示例
{
"id": "TRANSCRIPT_ID",
"format": "text",
"offset": 0,
"limit": 200
}以下为示范值，请换成您的媒体网址或转录稿 ID。
将 next_offset 作为 offset 读取下一页。每页最多 30,000 个字符，MCP 仅能读取前 2,000 个短语；完整内容请至 Taption。完成但无语音的录影会返回 total_phrases: 0。
translate_transcript
将已完成的转录稿翻译成最多五种语言。若您以名称指代转录稿，助理会用 list_transcripts 查找，无法明确对应时会请您选择。目标语言必须由使用者指定。
参数
idstring必填transcribe 或 list_transcripts 返回的转录稿 ID，包含 1–128 个英文字母、数字、下划线或连字号。
target_languagesstring[]必填1–5 个翻译语言代码，例如 en、ja、es 或 zh-TW。转录稿不能翻译成其本身的语言。
overwriteboolean设为 true 以替换既有翻译，包括在 Taption 中的编辑。仅在使用者同意后使用。
工具参数示例
{
"id": "TRANSCRIPT_ID",
"target_languages": [
"ja",
"es"
]
}以下为示范值，请换成您的媒体网址或转录稿 ID。
返回已排入的语言及每个语言扣除的分钟数（与媒体时长相同）。既有翻译可能含有您的编辑，只有在您同意后以 overwrite 才会替换。请用 get_transcript 搭配 language 读取结果。
list_transcripts
依修改时间由新至旧浏览转录稿，返回 ID、名称、状态、语言、翻译与修改时间。传入 query 可按名称查找转录稿。使用 ID 呼叫 get_transcript 读取内容。
参数
limitinteger最多返回转录稿数：1–50，默认为 10。
querystring要在最近 100 份转录稿中查找的名称片段，不区分大小写。
工具参数示例
{
"query": "weekly sync",
"limit": 10
}以下为示范值，请换成您的媒体网址或转录稿 ID。
没有录影时返回空的 transcripts 阵列。此工具限制结果数量，不提供分页。
疑难排解
连接或权限错误
以 OAuth 重新连接并允许要求的权限，确认网址以 /mcp-custom 结尾。
无法下载媒体
确认文件或贴文为公开、格式受支持且非直播。Google Drive 须开启连结访问。
分钟数不足或工作过多
请检查 Taption 可用分钟数。若达速率或同时处理上限，请等待现有工作完成并依指定延迟重试。
仍在处理或转录失败
处理中时约每分钟查询同一 ID。状态为 error 时，请阅读失败讯息并排除原因后再建立工作。
更多导出格式
在 Taption 开启转录稿，可导出 TXT、PDF、SRT、VTT、Final Cut Pro XML、JSON 或内嵌字幕影片。MCP 没有独立导出工具。
阅读 REST API 文档