OpenAI 文档 MCP 技能

概述

使用来自 shell 的 OpenAI 开发者文档 MCP 服务器来搜索和获取权威文档。在进行 OpenAI 平台相关工作时，务必使用此方法，而不是依赖记忆或非官方来源。

核心规则

• 对于 OpenAI API/SDK/Apps/Codex 相关问题，或需要精确、最新文档时，始终使用此技能。
• 通过 CLI 包装器查询 MCP 服务器，脚本位于scripts/openai-docs-mcp.sh（不要依赖 Codex MCP 工具）。
• 使用搜索或列出来查找最佳文档页面，然后获取该页面（或锚点）以获取确切文本。
• 在您的回复中注明所使用的文档 URL，以便来源清晰。

快速开始

scripts/openai-docs-mcp.sh search "Responses API" 5
scripts/openai-docs-mcp.sh fetch https://platform.openai.com/docs/guides/migrate-to-responses

工作流程

1. 发现：使用聚焦的查询进行搜索列表浏览。
2. 读取：获取最相关的URL（可选择添加锚点）。
3. 应用：总结和/或引用相关部分；包含URL。

脚本参考

CLI包装器位于scripts/openai-docs-mcp.sh并使用curl+jq针对https://developers.openai.com/mcp。

子命令：

• init：初始化和检查服务器能力。
• tools：列出MCP服务器上可用的工具。
• search <查询> [限制数量] [游标]：从文档索引返回JSON匹配结果。
• list [限制数量] [游标]浏览文档索引。
• fetch <url> [锚点]：返回一个文档页面或部分的 markdown 内容。
• 端点：列出 OpenAPI 端点。
• openapi <端点-url> [语言1,语言2] [仅代码]：获取 OpenAPI 模式或代码示例。

环境变量：

• MCP_URL：覆盖默认的 MCP 端点。