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

# OpenAI Codex

> Servidor MCP e orientação via AGENTS.md para o Codex

O Codex não tem um mecanismo multiplataforma de hooks de ciclo de vida, então
a integração usa duas peças: o servidor MCP (ferramentas de varredura) e a
orientação no `AGENTS.md` (quando usá-las). Não há aplicação determinística
via stop hook para o Codex — se você precisa dessa garantia, combine o Codex
com a varredura de PRs do ZeroPath para que o diff seja capturado no momento
da revisão.

<h2 id="what-the-installer-writes">
  O que o instalador grava
</h2>

| Arquivo                                           | O quê                                                                                                                                                                                 |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `~/.codex/config.toml` → `[mcp_servers.zeropath]` | Servidor MCP do ZeroPath                                                                                                                                                              |
| `~/.codex/AGENTS.md`                              | Bloco de orientação gerenciado (entre os marcadores `<!-- BEGIN/END ZEROPATH AGENT INTEGRATION -->`) instruindo o Codex a escanear o código que escreve antes de finalizar uma tarefa |

<h2 id="manual-mcp-setup">
  Configuração manual do MCP
</h2>

Acrescente ao `~/.codex/config.toml`:

```toml theme={null}
[mcp_servers.zeropath]
command = "uvx"
args = ["--from", "git+https://github.com/ZeroPathAI/zeropath-mcp-server", "zeropath-mcp-server"]

[mcp_servers.zeropath.env]
ZEROPATH_TOKEN_ID = "your_token_id"
ZEROPATH_TOKEN_SECRET = "your_token_secret"
# ZEROPATH_ORG_ID = "..."        # multi-org accounts
# ZEROPATH_BASE_URL = "..."      # self-hosted
```

<h2 id="notes">
  Notas
</h2>

* Se a sua implantação do Codex restringe servidores MCP (configuração
  gerenciada/na nuvem ou uma allowlist de `mcp_servers`), o `zeropath` precisa
  estar incluído nessa allowlist; a configuração gerenciada na nuvem tem
  precedência sobre `~/.codex/config.toml`.
* A CLI `zeropath` é instalada em `~/.zeropath/bin/zeropath`, então o Codex
  também pode escanear pelo shell:
  `~/.zeropath/bin/zeropath scan-code --diff --base-ref HEAD --caller agent --json`.
  A orientação do `AGENTS.md` menciona isso como o fallback quando o MCP está
  indisponível.

<h2 id="verify">
  Verificar
</h2>

Execute `/mcp` na TUI do Codex e confirme que `zeropath` está listado, ou:

```bash theme={null}
grep -A3 'mcp_servers.zeropath' ~/.codex/config.toml
```

Depois, peça ao Codex para "escanear minhas alterações não commitadas com o
ZeroPath" — ele deve chamar `asyncCodeScans.submit`, consultar
`asyncCodeScans.status` e reportar os achados de `asyncCodeScans.results`.