ScribeToAny 开发者文档

ScribeToAny 提供远程 MCP 服务器。把它接入 ChatGPT、Claude、Cursor 或其他 MCP 客户端后,AI 应用就能以你登录的账号列出转录稿、以文本或字幕读取,并从链接发起新的转录。

服务器地址

https://scribetoany.com/api/mcp

Streamable HTTP 传输,无状态 JSON-RPC,返回 JSON(没有 SSE 流,也没有 session id)。不需要 API key:客户端首次连接时会通过 OAuth 让你登录。

连接

ChatGPT

ScribeToAny 已上架 ChatGPT 插件目录:添加到 ChatGPT。详见 ChatGPT 页面。

Claude

添加为自定义连接器(或进入 Settings → Connectors → Add custom connector,粘贴服务器地址)。详见 Claude 页面。

Claude Code

运行下面的命令,然后用 /mcp 登录:

claude mcp add --transport http scribetoany https://scribetoany.com/api/mcp

Cursor

添加到 Cursor 一键安装,或把下面的配置写入 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "scribetoany": {
      "url": "https://scribetoany.com/api/mcp"
    }
  }
}

Codex CLI

codex mcp add scribetoany --url https://scribetoany.com/api/mcp
codex mcp login scribetoany

Gemini CLI

运行下面的命令,然后用 /mcp auth scribetoany 登录:

gemini mcp add --transport http --scope user scribetoany https://scribetoany.com/api/mcp

VS Code

写入 .vscode/mcp.json:

{
  "servers": {
    "scribetoany": {
      "type": "http",
      "url": "https://scribetoany.com/api/mcp"
    }
  }
}

应用打开 ScribeToAny 时,登录并选择「允许访问」。要断开连接,在 AI 应用的设置中移除 ScribeToAny。不用 AI 应用也能试用:运行 npx @modelcontextprotocol/inspector,选择 Streamable HTTP 并填入上面的地址。

让你的 agent 自己配置

在用编程 agent(Claude Code、Codex、Gemini CLI、Cursor)?把下面这段粘贴给它,它会替你添加服务器。

帮我配置 ScribeToAny,让我能在这里转写音视频并读取我的转录稿。

1. 添加远程 MCP 服务器 https://scribetoany.com/api/mcp(Streamable HTTP,OAuth,不需要 API key),名称为 "scribetoany"。用你自己的命令添加,例如 Claude Code 中用 `claude mcp add --transport http scribetoany https://scribetoany.com/api/mcp`,Codex 中用 `codex mcp add scribetoany --url https://scribetoany.com/api/mcp`,Gemini CLI 中用 `gemini mcp add --transport http --scope user scribetoany https://scribetoany.com/api/mcp`。
2. 开始登录。它会在我的浏览器中打开 ScribeToAny,我在那里登录并选择「允许访问」。
3. 连接成功后,列出我最近的转录稿,确认可以正常使用。

转录你电脑上的文件(CLI)

除了 ChatGPT,其他 MCP 客户端都没法传你电脑上的文件。ScribeToAny 命令行工具可以:它把文件上传到你的账号,等转录完成,再保存成文本、SRT 或 VTT。编程 agent(Claude Code、Codex、Gemini CLI、Cursor)可以像运行其他命令一样运行它。需要 Node.js 20 或更高版本。

npm i -g scribetoany
scribetoany auth login
scribetoany transcribe meeting.m4a --format srt --speakers

再装上 agent skill,你的 agent 就知道有哪些命令和选项:

npx skills add scribetoany/skills --skill scribetoany

scribetoany auth login 会在浏览器中打开 ScribeToAny,登录后允许「ScribeToAny CLI」即可,和 AI 应用的授权一样。结果输出到 stdout,进度输出到 stderr;加上 --json 得到机器可读的输出。运行 scribetoany --help 查看全部选项。

工具

工具权限作用
list_transcripts只读列出你的转录稿(最新的在前),包含状态、语言和时长。可选搜索关键词。
get_transcription_status只读查看转录是排队中、转录中、已完成还是失败。
get_transcript只读以文本(可选时间戳和说话人标注)、SRT 或 VTT 读取已完成的转录稿。
transcribe_link写入转录公开链接:X、Twitch、Loom、Google Drive、Dropbox 或音视频直链。不支持 YouTube、TikTok 和 Instagram 链接。
transcribe_file写入仅限 ChatGPT:转录对话中附上的音频或视频文件。
get_upload_link只读适用于无法传文件的应用:获取一个链接,在浏览器中打开 ScribeToAny 上传本地文件。
get_usage只读查看套餐和剩余的转录额度。

每个结果都附有回到 ScribeToAny 控制台中该转录稿的链接。应用不能编辑或删除任何内容,也看不到付款信息。

认证

  • OAuth 2.1 授权码流程,带 PKCE(仅 S256)和动态客户端注册,客户端会自行注册。访问令牌有效期 1 小时,刷新令牌 30 天。
  • 未认证的请求会返回 401,其 WWW-Authenticate 头指向受保护资源元数据,客户端据此找到授权服务器:
https://scribetoany.com/.well-known/oauth-protected-resource/api/mcp
https://scribetoany.com/.well-known/oauth-authorization-server

只有你在 ScribeToAny 授权页面批准该客户端后才会授予访问权限,且只有已验证邮箱的账号可以连接。

限制

  • 从 AI 应用发起的转录和其他转录一样计入你的套餐。免费版每天 2 次转录、每月 100 分钟;付费套餐两者都更高。
  • get_transcript 最多返回 120,000 个字符;更长的转录稿会被截断,并附上完整版的链接。
  • 一个 JSON-RPC 批量请求最多包含 10 条消息。
  • 不支持 YouTube、TikTok 和 Instagram 链接。请下载文件后在 ScribeToAny 上传。

更多

连接后可以问哪些问题,见 帮助中心。给 AI 助手看的全站纯文本指南在 /llms.txt。已连接的应用能读取哪些内容,见 隐私政策。遇到问题?联系我们。