Docs MCP

You can connect Codex to MCP servers in the CLI or IDE extension. The configuration is shared between both so you only have to set it up once.

Add the server using the Codex CLI:

codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp

Verify it’s configured:

codex mcp list

Alternatively, you can add it in ~/.codex/config.toml directly:

[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"

To have Codex reliably use the MCP server, add this snippet to your AGENTS.md:

Always use the OpenAI developer documentation MCP server if you need to work with the OpenAI API, ChatGPT Apps SDK, Codex,… without me having to explicitly ask.

VS Code supports MCP servers when using GitHub Copilot in Agent mode.

Click the following link to add the Docs MCP to VS Code:

Alternatively, you can manually add a .vscode/mcp.json in your project root:

{
  "servers": {
    "openaiDeveloperDocs": {
      "type": "http",
      "url": "https://developers.openai.com/mcp"
    }
  }
}

To have VS Code reliably use the MCP server, add this snippet to your AGENTS.md:

Always use the OpenAI developer documentation MCP server if you need to work with the OpenAI API, ChatGPT Apps SDK, Codex,… without me having to explicitly ask.

Open Copilot Chat, switch to Agent mode, enable the server in the tools picker, and ask an OpenAI-related question like:

Look up the request schema for Responses API tools in the OpenAI developer docs and summarize the required fields.

Cursor has native MCP support and reads configuration from mcp.json.

Install with Cursor:

Alternatively, create a ~/.cursor/mcp.json (macOS/Linux) and add:

{
  "mcpServers": {
    "openaiDeveloperDocs": {
      "url": "https://developers.openai.com/mcp"
    }
  }
}

To have Cursor reliably use the MCP server, add this snippet to your AGENTS.md:

Always use the OpenAI developer documentation MCP server if you need to work with the OpenAI API, ChatGPT Apps SDK, Codex,… without me having to explicitly ask.

Restart Cursor and ask Cursor’s agent an OpenAI-related question like:

Look up the request schema for Responses API tools in the OpenAI developer docs and summarize the required fields.