ToRun MCP 服务器
最后更新于 11 11月 2026
这是什么
ToRun MCP 服务器让编程代理在处理你的项目时使用 ToRun。支持远程 MCP 服务器的代理，例如 Claude Code、Cursor 或 opencode，可以生成图像、语音、音乐和视频，编辑图像，转写音频，运行深度研究和 ToRun 的工作流模板，并把 HTML 页面或浏览器游戏发布为链接，而你无需离开编辑器。代理制作的内容按与应用相同的价格从你的 ToRun 账户付费，并像你在应用中制作的任何内容一样保存在你的 ToRun 账户中。
地址和登录
| 服务器地址 | https://mcp.torun.ai/mcp |
| 传输方式 | HTTP（远程 MCP 服务器） |
| 登录 | Authorization: Bearer <your developer key> |
开发者密钥以 trn_live_ 开头。你可以在 ToRun 账户的开发者页面上创建它：参见开发者密钥。各工具的设置：
工具
| 工具 | 作用 | 付费 |
|---|---|---|
image_generate |
根据提示词生成图像：精灵图、图标、背景、插画。返回图像；如果耗时超过代理选择的等待时间，则返回任务 ID。 | 是 |
image_edit |
按照文字指令修改图像：换新背景、换颜色、添加或移除物体、换风格。图像可以是代理用 ToRun 生成的图像，也可以是指向不超过 20 MB 的 PNG、JPEG 或 WebP 文件的链接；通过链接提供的图像会先保存到你的 ToRun 资源库中。与 image_generate 一样，返回图像或任务 ID。 |
是 |
tts_generate |
把文字转成语音，并返回音频文件及其根据文件测得的播放时长。 | 是 |
stt_transcribe |
把音频或视频文件中的语音转成文字，代理要求时还会提供带时间戳的字幕片段。接受不超过 25 MB 的 mp3、m4a、wav、webm、ogg、opus、flac、aac 和 mp4 文件。 | 是 |
music_generate |
创作一首带或不带人声的音轨，并返回任务 ID。 | 是 |
video_generate |
根据提示词生成一段短片，并返回任务 ID。 | 是 |
job_status |
报告图像、音乐或视频任务的进度，并在文件准备好时返回文件。 | 免费 |
deep_research_start |
针对一个问题启动深度研究：在网络上搜索众多来源，并撰写注明来源的报告。返回任务 ID。 | 是 |
deep_research_status |
报告深度研究的进度，并在报告准备好时返回报告。 | 免费 |
workflow_template_search |
查找 ToRun 的工作流模板（现成的多步骤流程），并显示每个模板输出什么、通常花费多少以及接受哪些输入。 | 免费 |
workflow_run |
使用代理提供的输入运行工作流模板，并返回任务 ID。 | 是 |
workflow_run_status |
报告工作流运行的进度和到目前为止花费的 Runs，并在结果准备好时返回结果。 | 免费 |
canvas_publish |
把单文件 HTML 页面或浏览器游戏发布为链接。 | 免费 |
account_balance |
显示剩余的套餐额度和钱包余额，以及此密钥的每月上限和已花费金额。 | 免费 |
工具返回的文件链接无需登录即可下载，因此代理可以把文件保存到你的项目中。请保留完整链接，包括问号后面的部分。
发布的页面是不公开的：任何拥有链接的人都可以打开，但它不会显示在 ToRun 的探索中，搜索引擎也不会收录它。
长时间任务
音乐、视频、深度研究和工作流运行所需的时间比一次调用更长。工具会返回一个任务 ID，代理会再次查询，直到结果准备好：图像、音乐和视频用 job_status，研究报告用 deep_research_status，工作流运行用 workflow_run_status。在代理选择的等待时间内没有准备好的图像也会以任务 ID 的形式返回。
一次研究需要 1 到 10 分钟，即使与代理的对话结束也会继续进行；报告还会作为一个单独的对话出现在你的 ToRun 聊天列表中。一次工作流运行需要一分钟到几十分钟，运行及其文件会出现在你的 ToRun 账户中。较长的报告或较多的结果会分段返回，代理会请求其余部分。
调用如何付费
- 每次付费调用都以 Runs 按与应用相同的价格计费。
- 先从你的套餐额度中支付，如果你在密钥上允许，再从你的钱包支付。
- 免费额度从不为 API 调用付费。
- 工作流运行在执行过程中逐步计费。
- 每笔费用都会显示在你的账单页面上，归在产生它的密钥下。
超过密钥阈值的调用会先询问
每个密钥都有一个阈值。当单次调用的费用超过该阈值时，工具暂时不会运行它。对于工作流运行，比较的是该运行的估算费用。
- 如果你的工具能在 MCP 服务器提问时显示表单（MCP elicitation），ToRun 会在那里询问你：表单显示价格并询问是否继续。你同意，调用就会运行；你拒绝，则什么都不会运行。
- 否则，工具会回复价格，你的代理会把价格告诉你，只有在你同意后代理重新发起调用，调用才会运行。
询问本身不收取任何费用。
限制
每个密钥都有每月和每日消费上限，以及每分钟调用次数限制。每个账户每天发布的页面数量也有限制。密钥的每月上限和阈值在创建时设置；默认值列在 torun.ai/developers 上。要更改它们，请用你想要的设置创建一个新密钥，并撤销旧密钥。
调用被拒绝时
| 代理收到的提示 | 怎么做 |
|---|---|
| 此调用需要开发者密钥 | 检查 TORUN_API_KEY 是否包含完整的密钥，以及密钥是否未被撤销。 |
| 套餐额度已用完，且此密钥不允许从钱包消费 | 等待额度更新，或创建一个允许从钱包消费的密钥。 |
| 开发者密钥只消费付费套餐的额度或钱包 | 充值或订阅。 |
| 此密钥已达到每月或每日消费上限 | 等到第二天或下个月，或创建一个上限更高的密钥。 |
| 此密钥一分钟内的调用次数过多 | 稍等片刻再试。 |
| 此密钥没有工具所需的范围 | 密钥的范围无法更改。创建一个新密钥：新密钥拥有所有范围。 |
| 文件必须以 ToRun 资源库 ID 或 https 链接指定，二者只能选其一 | 只提供其中一个。 |
| 此账户的 ToRun 资源库中没有这个文件 | 使用此账户的文件。指向另一个账户文件的 ToRun 链接同样会被拒绝。 |
| 文件太大、格式不受工具支持，或无法下载 | image_edit 的图像：PNG、JPEG 或 WebP，不超过 20 MB。stt_transcribe 的文件：mp3、m4a、wav、webm、ogg、opus、flac、aac 或 mp4，不超过 25 MB。链接必须无需登录即可下载。 |