通过 MCP 在 AI 客户端里直接调用脑筋急转弯 API
# 通过 MCP 在 AI 客户端里直接调用脑筋急转弯 API
> 接口/接入点：脑筋急转弯（1618，MCP 服务覆盖全部接入点） · 免费服务 · 返回 JSON · 适用人群：AI Agent / MCP 开发者 · 阅读时间约 6 分钟
## 核心要点
- 接口提供 MCP 服务配置，覆盖 1618-2 与 1618-3 全部接入点，可在支持 MCP 的 AI 客户端直接调用。
- 典型客户端：Cherry Studio、ChatBox 等；配置时把 `{your_appKey}` 替换为真实 AppKey。
- AI Agent 可以直接"出一道脑筋急转弯""随机来 3 题"，无需写代码。
## Why：为什么接 MCP
MCP 让大模型直接"用工具"。把脑筋急转弯接进 AI 客户端，聊天机器人就能实时出题、做互动游戏，不用你预生成题库。蹭上 AI Agent 热点，也扩大了接口的使用场景。
## What：前置与资源
| 项目 | 说明 |
|------|------|
| MCP 服务 | 接口级，覆盖 1618-2 / 1618-3 全部接入点 |
| 客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
| 鉴权 | 真实 AppKey（替换配置中的 `{your_appKey}`） |
| 控制台 | AppKey 管理：`https://www.showapi.com/console#/myApp` |
## How：配置与使用
1. 在控制台拿到 AppKey。
2. 在 AI 客户端的 MCP 配置中，按官方给出的 MCP JSON 添加本接口服务，将 `{your_appKey}` 替换为真实 AppKey。
3. 在对话中直接说"出一道脑筋急转弯""随机来 3 道"，Agent 会调用对应接入点并返回 `question`/`answer`。
配置示意（以官方 MCP JSON 为准，结构示例）：
```json
{
"mcpServers": {
"showapi-brainteaser": {
"url": "https://route.showapi.com/mcp/1618",
"headers": { "appKey": "YOUR_APPKEY" }
}
}
}
```
> 以上为示意结构，请以官网「MCP 服务」卡片给出的真实 JSON 为准；不要把 AppKey 写进会公开的配置文件。
## 返回示例与解析
Agent 调用后拿到的仍是标准返回：1618-2 为 `contentlist`、1618-3 为 `list`（见字段全解）。客户端会把题目自然融入对话。
## 进阶 / 边界
- AppKey 安全：MCP 配置含 AppKey，不要提交到公开仓库或分享给无关方。
- 去重：Agent 多次随机可能重复，可在提示词里要求"避开之前出过的题"，或在应用层做去重（见最佳实践文）。
- MCP 覆盖全部接入点，但字段差异（contentlist vs list）由服务端/MCP 适配，使用时仍建议了解结构以便排查。
## FAQ
**Q1：哪些客户端支持？** 官方示例含 Cherry Studio、ChatBox 等支持 MCP 的客户端。
**Q2：MCP 和直接调 API 有什么区别？** MCP 让 AI Agent 自助调用，无需你写调用代码；底层仍是 1618-2/1618-3。
**Q3：AppKey 泄露怎么办？** 在控制台重置 AppKey，并排查配置文件去向。
**Q4：会重复出题吗？** 可能，建议在提示词或应用层去重。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger：用 OpenAPI 文档管理脑筋急转弯接口](https://www.showapi.com/guides/brainteaser-openapi-1618)
- [直播互动如何接入脑筋急转弯 API？从弹题到观众答题的全链路设计](https://www.showapi.com/guides/brainteaser-live-interaction-1618)
- [脑筋急转弯 API：5 分钟从注册到拿到第一道题](https://www.showapi.com/guides/brainteaser-quickstart-1618)
- **本系列共 12 篇**：查看[脑筋急转弯 API 指南总目录](https://www.showapi.com/guides/brainteaser-guides-1618)
