通过 MCP 在 ChatBox/Cherry Studio 中直接调用笑话大全
笑话大全MCPCherryStudioChatBoxAI客户端 # 通过 MCP 在 ChatBox/Cherry Studio 中直接调用笑话大全
> 接口 341-5 · 免费 · MCP 服务 · 适用人群：AI 客户端用户、非开发者 · 阅读时间：约 4 分钟
## 核心要点
- 笑话大全提供接口级 MCP 服务，配置一段 JSON 即可在支持 MCP 的 AI 客户端里直接调用。
- 只需把 `{your_appKey}` 替换成你的真实 AppKey，无需写代码。
- 适合在 ChatBox、Cherry Studio 等客户端里让 AI 帮你"讲个笑话""来段子"。
## Why
你不一定想写代码，但想在 AI 助手里随时调一下笑话大全——比如让助手在聊天中插播一段子、给社群生成每日开心文案。MCP（Model Context Protocol）让 AI 客户端直接"认识"这个接口，你只需要粘贴一段配置，剩下的交给对话。
## What
| 项 | 说明 |
|----|------|
| 集成方式 | MCP 服务（接口级，覆盖全部接入点） |
| 客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
| 配置内容 | 一段 JSON，填 AppKey 即可 |
| 服务地址 | `http://www.showapi.com.cn/mcp/341/{your_appKey}` |
## How
### 步骤 1：拿到 AppKey
从[ShowAPI 控制台](https://www.showapi.com/console#/myApp)复制你的 AppKey。
### 步骤 2：在客户端配置 MCP
在 Cherry Studio / ChatBox 的 MCP 设置里新增一个 Server，粘贴以下配置，将 `{your_appKey}` 换成真实 AppKey：
```json
{
"mcpServers": {
"showapi-mcp-341": {
"url": "http://www.showapi.com.cn/mcp/341/{your_appKey}"
}
}
}
```
### 步骤 3：对话中直接调用
配置保存并连接成功后，在对话里让 AI「讲个笑话」「来一条搞笑段子」，客户端会通过 MCP 调用笑话大全接口并返回 `text` 内容。
## 返回示例与解析
MCP 返回的内容与直接调用接口一致，业务数据在 `showapi_res_body` 内（`text` 为笑话正文）。字段详情见[返回字段全解](https://www.showapi.com/guides/joke-api-response-fields-341)。
## 进阶 / 边界
- **AppKey 安全**：MCP 配置写在本地客户端，AppKey 不会进前端页面，但仍属私有凭证，勿外泄。
- **覆盖全部接入点**：该 MCP 服务覆盖本接口全部接入点（当前仅 341-5）。
- **免费档位**：免费接口有使用档次限制防滥用，AI 高频调用同样会计入，注意频率（见[缓存与档位](https://www.showapi.com/guides/joke-api-cache-tier-341)）。
## FAQ
**Q1：哪些客户端支持这种配置？**
页面示例提到 Cherry Studio、ChatBox 等支持 MCP 的客户端；具体以你所用客户端的 MCP 配置入口为准。
**Q2：配置后连接失败怎么办？**
先确认 AppKey 已正确替换、网络可访问 `showapi.com.cn`；若仍失败，可回到[调用失败排查](https://www.showapi.com/guides/joke-api-error-341)核对。
**Q3：MCP 和直接写代码调用有区别吗？**
能力一致，都是调 341-5；MCP 让你不用写代码、在对话里就能用，适合非开发者与快速体验。
**Q4：能用 MCP 批量拉多条笑话吗？**
接口本身每次只返回一条随机笑话，MCP 调用亦如此；多次调用可拿到不同内容，但要留意档位限制。
**Q5：AppKey 泄露了怎么办？**
尽快在控制台重置 AppKey，避免被他人盗用额度。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger：用 OpenAPI 文档管理笑话大全接口](https://www.showapi.com/guides/joke-api-openapi-341)
- [笑话大全：5 分钟接入，从注册到拿到第一条笑话](https://www.showapi.com/guides/joke-api-quickstart-341)
- [免费接口也要讲边界：笑话大全缓存策略与档位限制应对](https://www.showapi.com/guides/joke-api-cache-tier-341)
- **本系列共 10 篇**：查看[笑话大全 API 指南总目录](https://www.showapi.com/guides/joke-api-guides-341)
