您可以将算秩文档接入 Claude Code、Codex、Cursor 等 AI 工具,让 AI 基于文档回答模型推理服务相关问题,例如如何选择模型、调用 API、配置 API Key、查看用量或接入开发工具。
选择方式
建议优先使用 MCP。MCP 适合在 IDE、编程智能体或桌面 AI 客户端中长期查询算秩文档,AI 工具可以按需检索文档内容,不需要每次手动复制页面链接或文档正文。
如果您的 AI 工具暂不支持 MCP,可以根据使用场景选择其他读取方式。
MCP 接入
如果您的 AI 工具支持 Model Context Protocol(MCP),可以通过 MCP 连接算秩文档。连接后,AI 工具可以围绕具体问题检索相关文档,并基于文档内容回答问题。
接入地址
在 AI 工具中添加 MCP 服务时,请将以下地址作为算秩文档 MCP 服务入口。
工具能力
接入后,AI 工具可以使用以下文档能力:
典型问题示例
- 我应该选哪个模型?
- 怎么创建 API Key 并调用模型?
- API 请求报错了怎么排查?
- 怎么查看 token 用量和费用?
在 Claude Code 中配置
Claude Code 以命令行工作流为主。建议在需要使用算秩文档的项目目录中,执行以下命令添加 MCP 服务:
配置完成后,可以执行以下命令检查连接状态:
在 Codex 中配置
如果您使用的是支持图形化 MCP 配置的 Codex 客户端,可以在应用内添加 MCP 服务,并将服务地址设置为 https://docs.siflow.cn/mcp。
如果需要在多个项目或 IDE 中复用配置,也可以使用 CLI 或配置文件方式。
配置完成后,可以执行以下命令检查连接状态:
您也可以直接编辑 Codex 配置文件,例如 ~/.codex/config.toml,添加以下配置:
其他读取方式
使用 skill.md
skill.md 用于向 AI Agent 描述文档站和产品能力,适合支持技能或 Agent 上下文的工具读取。
使用 llms.txt
llms.txt 提供文档站的页面索引,适合让 AI 先了解站点中有哪些文档。
使用 llms-full.txt
llms-full.txt 提供更完整的文档内容,适合需要让 AI 一次性读取较多文档上下文的场景。
llms-full.txt 可能包含较多内容。部分 AI 工具存在上下文长度限制,如遇到内容过长,可改用 MCP、llms.txt 或单页 Markdown。
使用单页 Markdown
每篇文档都可以通过 Markdown 格式读取。将页面 URL 后缀改为 .md,即可获得更适合 AI 读取的纯文本内容。
例如:
使用建议
- 查询模型推理服务概念、操作步骤和配置说明时,优先让 AI 基于 MCP 或具体页面 Markdown 回答。
- 涉及模型列表、价格、配额和控制台状态等实时信息时,请同时以控制台页面展示为准。
- 如果 AI 回答与文档内容不一致,请以文档站页面展示的内容为准。