在 Cherry Studio 里通过 MCP 调用精品长文一键写作
精品长文一键写作MCPOpenAPICherry Studio # 在 Cherry Studio 里通过 MCP 调用精品长文一键写作
> 接口：精品长文一键写作（apiCode=3206）· 集成方式：接口级 MCP 服务 / OpenAPI 3.0
> 计费：计次收费（提交 300 厘/次、配图 260 厘/次）· 适用客户端：Cherry Studio、ChatBox 等支持 MCP 的客户端
> 适用人群：不想写代码就想用长文生成能力的使用者、AI Agent 开发者 · 阅读时间：约 6 分钟 · **最后实测核对：2026-09-15**
## 核心要点
- 精品长文一键写作提供**接口级** MCP 服务，一个地址覆盖该接口的全部接入点，配置一次就能在客户端里调提交、查询、配图。
- MCP 地址里要填你自己的 AppKey：`http://www.showapi.com.cn/mcp/3206/{your_appKey}`。
- 该接口同时提供标准 OpenAPI 3.0 文档（YAML 与 JSON 两份），可以导入 Postman 或 Swagger UI。
## 为什么在客户端里用它
写代码调用要处理三件事：提交任务、轮询状态、解析透传返回。这些在你自己的系统里是必要的，但如果只是想试试「给一句主题能出什么样的长文」，或者想在一个已经装好的 AI 客户端里直接用上长文生成能力，MCP 是更短的路。
接口级 MCP 把整个接口（4 个接入点）封装成客户端可以识别的工具。你只要把地址配进去，剩下的在对话里说。
## 配置步骤
### 第一步：准备 AppKey
到 https://www.showapi.com/console#/myApp 复制 AppKey。接口级 MCP 的鉴权放在 URL 路径里，所以这个 Key 会出现在配置文本中。
### 第二步：把配置写进客户端
官方给出的 MCP 配置是：
```json
{
"mcpServers": {
"showapi-mcp-3206": {
"url": "http://www.showapi.com.cn/mcp/3206/{your_appKey}"
}
}
}
```
把 `{your_appKey}`（包含花括号一起）替换成你的真实 AppKey。比如你的 Key 是 `abc123`，地址就写成 `http://www.showapi.com.cn/mcp/3206/abc123`。
在 Cherry Studio 的 MCP 设置里新增一个服务器，把上面这段 JSON 粘进去即可。ChatBox 等同样支持 MCP 的客户端操作方式类似，字段名都是 `mcpServers`。
几条配置时的事实：
| 项目 | 说明 |
|------|------|
| 服务粒度 | 接口级，覆盖本接口全部接入点 |
| 地址协议 | 文档给出的是 `http`，不是 `https`，按原文填写 |
| 鉴权位置 | AppKey 在 URL 路径末段，不在请求头 |
| 服务端 | `www.showapi.com.cn`，与接口调用域名 `route.showapi.com` 不同 |
### 第三步：确认服务已加载
配置保存后重启客户端或刷新 MCP 服务器列表，服务名 `showapi-mcp-3206` 出现在已连接列表里才算生效。如果列表里没有，先检查 AppKey 是否正确替换、有没有把花括号一起删掉。
## 配上之后怎么用
服务连上以后，直接用自然语言描述你要做的事，客户端会把请求转给对应的接入点。
**写一篇文章：**
> 用 showapi 的长文接口写一篇介绍昆明气候特点的短文，三百字左右。
这对应 `3206-1` 提交写作任务，客户端会带着 `topic` 调用接口，拿到 `task_id`。
**看任务写完了没有：**
> 看看刚才那个写作任务的状态。
这对应 `3206-2` 查询任务列表。注意接口只覆盖近 30 天的任务，历史任务不在范围内。
**把正文取回来：**
> 把 xx 任务的正文取出来。
这对应 `3206-3` 查询文章详情。文章还没写完时，这个接入点会返回 HTTP 450，响应体里带着「文章正在生成中，请稍后！」的提示，客户端会把它原样告诉你，等一会儿再问一次即可。生成过程中的完整表现记录在 [返回字段说明](https://www.showapi.com/guides/longform-writing-response-fields-3206)。
**给它配张图：**
> 给这篇文章生成一张配图。
这对应 `3206-5` 生成文案配图，返回体里的 `img` 是图片地址，文档注明目前只返回一张。
有一点需要提前知道：长文生成是长耗时任务。2026-09-15 实测一次短文生成提交后 10 分钟内一直处于生成中，所以在对话里问「写完了吗」可能会连续几次得到「还在生成」的答复，属于正常状态。
## 用 OpenAPI 文档管理这个接口
除了 MCP，接口还提供标准 OpenAPI 3.0 文档，覆盖全部接入点：
| 格式 | 地址 |
|------|------|
| YAML | https://www.showapi.com/openapi/market/3206.yaml |
| JSON | https://www.showapi.com/openapi/market/3206.json |
导入 Postman 或 Swagger UI 之后，可以直接看到 4 个接入点的路径、参数和返回结构，用来生成请求模板或作为团队内的接口说明。
文档里还带了两个对写代码有用的字段：
- `x-read-timeout` / `x-connect-timeout`：`3206-1`、`3206-2`、`3206-3` 都是 60 秒，`3206-5` 是 300 秒。客户端超时按这个值设。
- `securitySchemes.AppKeyAuth`：声明鉴权方式为 query 参数 `appKey`，位置在 `in: query`。
文档中的 `servers.url` 是 `https://route.showapi.com`，与你实际发请求的地址一致。
## 计费与调用方式
MCP 走的还是同一套计费口径，不会因为经过客户端而改变。提交写作任务 300 厘/次，生成文案配图 260 厘/次，查询任务列表与查询文章详情 0 厘/次。调用成功才计费，失败不扣费。
需要提醒的一点：在对话里让客户端「一直问写完了没有」是安全的，因为查询类接入点不产生费用；但每次「重新写一篇」都是新的一次提交，会新建任务并计费一次。档位与费率明细见 https://www.showapi.com/apiGateway/view/3206 的「产品价格」标签。
## FAQ
**Q1：MCP 地址里为什么是 http 而不是 https？**
官方给出的地址就是 `http://www.showapi.com.cn/mcp/3206/{your_appKey}`。按原文填写，不要自行改协议，否则可能连不上。
**Q2：一个 MCP 地址能调几个接入点？**
服务是接口级的，覆盖本接口的全部接入点：提交写作任务、查询任务列表、查询文章详情、生成文案配图。不需要为每个接入点单独配置。
**Q3：AppKey 写在 URL 里安全吗？**
这是官方给出的配置方式。使用时注意不要把带真实 Key 的配置文件提交到代码仓库或公开分享；Key 可以在控制台重置。
**Q4：客户端里拿到的是正文还是任务 id？**
取决于你让它做哪一步。让它「写一篇」拿到的是任务 id 和状态；让它「取出正文」才是 Markdown 全文。因为生成是异步的，通常需要问两次。
**Q5：MCP 和 OpenAPI 该用哪个？**
在 AI 客户端里对话操作用 MCP；要在 Postman 里调试、给团队写接口说明、或者让 Agent 消费结构化文档，用 OpenAPI。
**Q6：同一个 Key 能配多个客户端吗？**
可以。Key 是账号维度的凭证，不绑定客户端实例。多端同时在用要注意总调用量按账号合并计算。
## 下一步阅读
- 完整调用流程：[用 Python 提交第一个写作任务并取回成稿](https://www.showapi.com/guides/longform-writing-quickstart-3206)
- 状态与轮询：[精品长文一键写作：任务写完了没有？看 task_status 三种状态](https://www.showapi.com/guides/longform-writing-task-status-3206)
- 成本口径：[精品长文一键写作计费口径](https://www.showapi.com/guides/longform-writing-billing-3206)
- **本系列共 9 篇**：查看[精品长文一键写作指南总目录](https://www.showapi.com/guides/longform-writing-guides-3206)
