> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# EvoLink MCP
> 远程与本地 MCP、客户端接入、工具流程、素材与结果交付
[CLI/MCP 总览](/docs/cn/cli-mcp/overview)可以按客户端选择入口；模型费用、任务素材和 Agent 资料集中在同一栏目的共用资料。
EvoLink MCP 把模型查询、估价、三媒体生成、素材上传、任务和余额作为原生工具提供给 Agent。本栏目只讲 MCP；终端命令与 evolink-cli 技能见[独立 CLI 栏目](/docs/cn/cli/overview)。
以已发布 **MCP 1.6.1** 为参考。远程有 15 个工具，浏览器 OAuth 登录；本地 stdio 有 13 个工具，使用个人 API Key。当前账户模型与参数仍须实际查询。
## 选择您的助手
远程连接地址为 `https://mcp.evolink.ai/mcp`，传输是 Streamable HTTP。按客户端自己的入口完成授权，不把文档 URL 当作服务地址。
添加远程连接器，在浏览器授权。
注册远程服务器并完成独立 MCP OAuth。
添加 HTTP MCP，通过 /mcp 完成授权。
添加自定义 MCP 连接，登录并启用工具。
配置服务器 URL，并通过客户端授权。
在支持 OAuth 的 Gateway 版本配置连接。
合并 MCP 配置，登录并重载工具。
通用 Streamable HTTP 与 OAuth 分步设置。
npx 启动 stdio 服务，用个人 API Key 验证。
## 快速开始：远程 MCP
在 MCP/连接器设置选择自定义服务器，名称 EvoLink，URL 填 `https://mcp.evolink.ai/mcp`。按上方客户端指南操作，不需要安装本地 MCP 包。
选择 OAuth，在浏览器登录 EvoLink，核对账户和权限并允许，回到客户端。确认连接与工具已启用；CLI 登录不替代宿主 MCP 授权。
发送下面提示词，确认实际获得余额和可用模型：
```text theme={null}
请使用 EvoLink 查询账户余额，并搜索可用图片模型，先不要生成任何内容。
```
成功标志是 check\_balance 和 search\_models 的真实返回结果，不只是有工具列表。此验证不创建付费媒体任务。
仅支持 stdio 的客户端请按[本地 MCP 安装](/docs/cn/mcp/other-clients#local-mcp)，两种认证和启动方式分别完成。
## 第一次生成
连接成功后，直接描述需求：
```text theme={null}
用 EvoLink 做一张咖啡品牌广告图：暖色、奶油白陶瓷杯、晨光，上方预留品牌文案。
先比较适合的模型，展示输出规格、本次估价与限制，等我确认后生成。
完成后返回原图链接和实际扣费，不要自动重做或另行修改原结果。
```
```text theme={null}
用 EvoLink 做一段海边日落短视频。先给我可用模型、支持的时长与画质、声音选项和报价。
确认后再提交，保存任务 ID，查询到完成后给我原视频链接和实际扣费。
```
```text theme={null}
用 EvoLink 生成中文欢迎语音，内容是“欢迎来到我们的咖啡店”。
先选语音模型，核对声音、输入参数和计费方式，等我确认后生成并返回原音频。
```
生成使用 EvoLink 积分。提示词要求智能体等批准；账户登录、宿主工具许可、单次费用批准是不同步骤。MCP 不提供会话级服务端批准按钮，需由智能体取得本次明确批准。预算范围见[费用与授权](/docs/cn/mcp/billing)。
## 怎么接入
远程 MCP：`您的助手 → EvoLink MCP → 平台 API`。助手管理 OAuth 登录，远程服务管理工具执行。浏览器聊天客户端不需要安装 Node.js 或 EvoLink CLI。
本地 stdio：`您的助手 → 本地 MCP 进程 → 平台 API`。需要在助手实际运行的机器安装 Node.js 18+，由助手启动 MCP 进程，并向进程提供平台 API Key。详细配置见[其他 MCP 客户端](/docs/cn/mcp/other-clients#local-mcp)。
两种模式使用相同的主要模型、报价、生成和任务工具；远程额外提供 `prepare_upload`、`get_upload`。技能与插件是可选的操作说明，不能代替服务配置、账户授权或宿主工具权限。
| 要完成的事情 | 使用的工具 |
| - | - |
| 查询账户余额和权限 | `check_balance` |
| 找模型、核对参数、查模型文档 | `search_models`、`get_model`、`search_docs` |
| 按需求比较候选模型 | `recommend_models` |
| 计算预计费用 | `estimate_cost` |
| 生成图片、视频、音频 | `generate_image`、`generate_video`、`generate_audio` |
| 查询与等待任务、查询历史 | `get_task`、`list_tasks` |
| 查看账户用量 | `get_task_usage` |
| 上传参考素材 | `upload_file`；远程另有 `prepare_upload`、`get_upload` |
工具不会提供代码开发、本地剪辑或网页搭建能力。宿主 Agent 自己可能有这些能力，介绍 EvoLink 时应明确它们属于宿主。
## 第一步：选模型并核对输入
先用 `search_models` 或 `recommend_models` 获取当前可用候选，再用 `get_model` 核对准确 ID、能力、必填字段和限制。需要更多说明时使用 `search_docs`。不要把模型系列名称当成可直接提交的模型 ID。
推荐顺序、可比较的新款系列和费用规则统一见[模型、费用与额度](/docs/cn/cli-mcp/models-and-billing#models)。先核对本次账户目录和输入，不把示例型号当成默认推荐。
下面的示例使用 `z-image-turbo`。正式使用任何模型之前都应查参数：
```json theme={null}
{"name":"get_model","arguments":{"model":"z-image-turbo"}}
```
## 第二步：准备参考素材
纯文字生成可以跳过上传。需要参考图、视频或音频时，先确认模型支持该素材类型、数量与大小，再上传。
1. **已有可访问 URL**：通过 `upload_file` 的 `file_url` 上传。URL 需要能由服务端读取；用户电脑的文件路径不是公开 URL。
2. **较小的内联文件**：远程 `upload_file` 的 base64 内容上限为 1 MiB；必须提供匹配的 MIME。不要将大文件放进工具消息。
3. **远程本地文件**：先调用 `prepare_upload`，让具备文件读取与 HTTP 能力的环境上传文件，再调用 `get_upload` 核对回执。单次上传上限为 95 MiB，还需遵守模型限制。上传授权约 15 分钟过期、一次性使用，状态地址约保留 1 小时。
4. **本地 stdio**：`upload_file` 支持本地 `file_path`。这是 MCP 进程所在机器的绝对路径，不是聊天用户电脑的路径。实际限制以文件服务和模型为准。
```json theme={null}
{"name":"prepare_upload","arguments":{"file_name":"reference.png"}}
```
```json theme={null}
{"name":"get_upload","arguments":{"upload_id":"UPLOAD_ID"}}
```
聊天附件不会自动变成模型可用链接。如果助手没有读取或上传本地文件的能力，应让用户提供可访问 URL。上传结果不确定时保留原 `upload_id` 查询，不要立刻重复上传；回执兼容取决于文件服务部署。参考文件通常保留 72 小时，过期需要重新上传并更新输入。
## 第三步：图片报价、批准和生成
先整理最终输入，再计算报价；向用户展示模型、图片数量、尺寸、内容和预计费用。报价不是实际结算保证。当前发布版本的价格覆盖与限制见[费用说明](/docs/cn/mcp/billing#pricing)。
```json theme={null}
{"name":"estimate_cost","arguments":{"model":"z-image-turbo","input":{"prompt":"A minimalist coffee advertisement with a ceramic cup"}}}
```
只有用户批准本次方案与预计费用之后，才调用生成工具。`client_request_id` 是 16–96 字符的稳定请求编号；同一次提交重试必须沿用原编号和原输入。下面的预算值仅是参数示例，实际按用户明确的预算设置：
```json theme={null}
{"name":"generate_image","arguments":{"model":"z-image-turbo","input":{"prompt":"A minimalist coffee advertisement with a ceramic cup"},"client_request_id":"coffee-image-demo-001","max_cost_usd":1}}
```
`max_cost_usd` 只用于提交前检查，不能保证最终扣费不超出它；`estimate_cost` 本身不接受这个参数。不要把宿主允许调用工具当成用户批准这笔费用。
## 视频：先核对时长、分辨率、声音和参考输入
使用 `get_model` 查准确的文生／图生视频模型 ID。时长、分辨率、音频开关、参考视频等都可能影响价格，不能沿用另一组参数的报价。相同系列的不同任务类型也可能使用不同模型 ID。
依次执行：核对参数 → 上传参考素材 → 用最终输入调用 `estimate_cost` → 展示方案并取得本次批准 → 用同一输入调用 `generate_video` → 查询原任务 → 交付原视频。
需要 `media_seconds` 的报价以输入素材实际时长为依据；无法核实、报价不完整或预算无法比较时先停下询问。不要为解决灰色缩略图自动启动本地剪辑、重复生成或改动完成的视频。
## 音频：区分音乐和语音
音乐需求可比较当前可用的 Suno v6；旁白和配音用适合的语音模型。先查模型参数，确定文字、语言、声音、歌词、时长或参考音频，再用最终输入估价并确认，最后调用 `generate_audio`。
不完整的音频计费信息不能写成免费。输出以完成任务的原始音频地址为准，多个结果都应保留，并说明实际格式与保存方法。
## 第四步：等待、查询和恢复原任务
生成调用可能直接返回结果，也可能返回 `task_id`。查询原任务，不重复提交生成。`get_task.wait_seconds` 可以在一次调用中等待，范围 0–45 秒；等待超时表示本次等待结束。
```json theme={null}
{"name":"get_task","arguments":{"task_id":"TASK_ID","wait_seconds":30}}
```
多个任务使用 `list_tasks` 的 `task_ids` 批量查询；历史列表也由该工具提供。提交超时而没有拿到任务编号时，保存原请求编号、输入、凭据与错误信息，按原请求恢复。不能换身份或新编号再生成来排错。
当前没有可用的公开取消排队工具。停止 Agent 等待、关闭页面或断开 MCP 不会取消服务端任务，也不证明没有扣费或已经退款。
## 第五步：交付原始结果
任务完成后返回可打开的原始链接，并说明模型、输出数量、已知费用及链接有效期。原始生成文件通常保留 24 小时，应及时保存。宿主支持预览时可同时显示；只显示链接或灰色缩略图时先验证原始链接。
下载前检查 HTTP 状态、内容类型和实际文件格式；错误页面不是媒体文件。Python 默认请求被拦截时可给受控下载代码设置产品 User-Agent，具体示例见[下载排错](/docs/cn/mcp/billing#download)。
结果交付与预览问题不能通过未经批准的再生成修复。用户另行要求剪辑或改图时，再按对应宿主能力与费用确认执行。
需要按工具名称查参数与返回值，请看[MCP 工具参考](/docs/cn/mcp/tools)。需要让 Agent 阅读完整规则，请看[技能与可读资料](/docs/cn/cli-mcp/agent-resources)。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.