> ## Documentation Index
> Fetch the complete documentation index at: https://metatronscribe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> Connect OpenAI Codex to the public Metatron documentation MCP with codex mcp add --url or config.toml.

**Syntax source:** the public Codex MCP documentation at `developers.openai.com/codex/mcp` (retrieved 2026-10-10). The command `codex mcp add <name> --url <url>` and the `[mcp_servers.<name>]` table are both documented there. **Live connection: NOT TESTED** against the published endpoint, which is not deployed yet.

Codex stores MCP configuration in `~/.codex/config.toml` by default. The ChatGPT desktop app, the Codex CLI, and the IDE extension share that file.

## Add the server

```bash theme={null}
codex mcp add metatron-docs --url https://docs.metatronscribe.com/mcp
```

Or add the same table by hand:

```toml theme={null}
[mcp_servers.metatron-docs]
url = "https://docs.metatronscribe.com/mcp"
startup_timeout_sec = 10
tool_timeout_sec = 60
```

Public pages need no credentials, so no authentication field is set. Do not add a token to this file.

## Restrict the tools (recommended)

Codex supports an allow-list through `enabled_tools`. Use the tool names your session reports, because the live endpoint decides them. The placeholder below must be replaced before use:

```toml theme={null}
[mcp_servers.metatron-docs]
url = "https://docs.metatronscribe.com/mcp"
enabled_tools = ["<search-tool-name>"]
```

`disabled_tools` is applied after `enabled_tools` and works as a deny-list.

## Verify

```bash theme={null}
codex mcp list
```

In the Codex terminal UI, run `/mcp` to see the active servers. Then ask Codex a question the documentation answers.

## Troubleshooting

* **Server not listed:** check the table name, including the hyphen, and that the file is the one Codex reads.
* **Startup fails:** the default startup timeout is 10 seconds. Raise `startup_timeout_sec` if the site is slow.
* **Unexpected tools:** add `enabled_tools`.

## Remove

Delete the `[mcp_servers.metatron-docs]` table from `config.toml`, then start a new session. The public Codex documentation does not list a remove subcommand.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.