# MCP 文档服务

通过 MCP 让支持的 AI 工具搜索和读取 Kaien API 文档。

支持 MCP 的工具可以通过文档服务搜索页面、读取内容，并结合 API Reference 生成接入代码。

当前 Kaien API 文档采用静态导出自托管。Mintlify 托管版的 `/mcp` 动态服务端点在当前部署方式下不会自动生成；下面的页面用于说明 MCP 接入边界和替代读取入口。

## MCP 地址

文档说明页：

```text
https://kaienapi.com/docs/mcp
```

AI 工具可优先读取：

```text
https://kaienapi.com/docs/skill.md
```

## 使用场景

- 在 Claude Code 中查询 Kaien API 的接口说明。
- 在 Cursor 中让 agent 读取 GPT Image 2 的参数约束。
- 在 Codex 中让 agent 根据 API Reference 生成调用代码。
- 在 n8n 工作流设计时查询图片、音乐和音频接口。

## 使用边界

MCP 只提供文档读取能力：

- 可以搜索文档。
- 可以读取页面内容。
- 可以辅助生成示例代码。

MCP 不直接代替用户调用 API，也不应在没有用户确认的情况下发起会产生费用的请求。

## 使用建议

如果工具支持读取远程 Markdown，优先读取 `skill.md`，再按任务继续读取具体页面。首次接入时先让工具读取“快速开始”或“GPT Image 2”，确认能读取文档后再让它生成代码。