Docs / MCP server / Connect Codex
Connect Codex
The Codex CLI and the IDE extension read the same config.toml. Use --url for hosted, npx for local.
Steps
- Run one of the commands. Codex writes the configuration to
~/.codex/config.toml. - To edit by hand, add a
[mcp_servers.thefaceanalysis]table to that file. For a per-project setup, put the table in.codex/config.tomlat the root of a trusted project. - Restart Codex and try the check prompt below.
Configuration
Hosted (recommended)
codex mcp add thefaceanalysis --url https://mcp.thefaceanalysis.com/mcpLocal (npx)
codex mcp add thefaceanalysis -- npx -y thefaceanalysis-mcpconfig.toml (hosted)
[mcp_servers.thefaceanalysis]
url = "https://mcp.thefaceanalysis.com/mcp"config.toml (local)
[mcp_servers.thefaceanalysis]
command = "npx"
args = ["-y", "thefaceanalysis-mcp"]Check it works
Ask: “Using The Face Analysis, what is the median fWHR across your 102 reference faces?” The answer should be 1.78.
Source for the Codex syntax: Codex: MCP. Client menus and file locations change; if a step no longer matches, follow that page and tell us on GitHub.
See also the tool reference and troubleshooting.