openai/codex
1
0
Fork 0
mirror of https://github.com/openai/codex.git synced 2026-10-23 18:08:45 +00:00
Code Issues Packages Projects Releases Wiki Activity

fix: separate codex mcp into codex mcp-server and codex app-server

Browse Source
This commit is contained in:
Michael Bolin
2025-09-29 22:05:28 -07:00
parent 27c6c5d7a7
commit 32e0d6e73e
50 changed files with 1526 additions and 415 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/advanced.md
+3 -3
View File
@@ -74,13 +74,13 @@ env = { "API_KEY" = "value" }
## Using Codex as an MCP Server
The Codex CLI can also be run as an MCP _server_ via `codex mcp`. For example, you can use `codex mcp` to make Codex available as a tool inside of a multi-agent framework like the OpenAI [Agents SDK](https://platform.openai.com/docs/guides/agents).
The Codex CLI can also be run as an MCP _server_ via `codex mcp-server`. For example, you can use `codex mcp-server` to make Codex available as a tool inside of a multi-agent framework like the OpenAI [Agents SDK](https://platform.openai.com/docs/guides/agents). Use `codex mcp` separately to add/list/get/remove MCP server launchers in your configuration.
### Codex MCP Server Quickstart
You can launch a Codex MCP server with the [Model Context Protocol Inspector](https://modelcontextprotocol.io/legacy/tools/inspector):
``` bash
npx @modelcontextprotocol/inspector codex mcp
npx @modelcontextprotocol/inspector codex mcp-server
```
Send a `tools/list` request and you will see that there are two tools available:
@@ -109,7 +109,7 @@ Property | Type | Description
> [!TIP]
> Codex often takes a few minutes to run. To accommodate this, adjust the MCP inspector's Request and Total timeouts to 600000ms (10 minutes) under ⛭ Configuration.
Use the MCP inspector and `codex mcp` to build a simple tic-tac-toe game with the following settings:
Use the MCP inspector and `codex mcp-server` to build a simple tic-tac-toe game with the following settings:
**approval-policy:** never
docs/config.md
+1 -1
View File
@@ -375,7 +375,7 @@ startup_timeout_sec = 20
tool_timeout_sec = 30
```
You can also manage these entries from the CLI [experimental]:
You can also manage these entries from the CLI [experimental]. Use `codex mcp-server` when you want to launch the built-in server; the `codex mcp` command shown below only manages configured launchers:
```shell
# Add a server (env can be repeated; `--` separates the launcher command)