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

# Conectar o OpenAI Codex ao servidor MCP da Didit

> Adicione o servidor MCP da Didit ao Codex com um comando: codex mcp add didit --url https://mcp.didit.me/mcp. Depois, faça login. Sem chave de API.

O OpenAI Codex se conecta ao servidor MCP hospedado da Didit (`https://mcp.didit.me/mcp`) com um único comando. Depois, o Codex abre **Log in with Didit** no seu navegador e guarda o login para você; não há chave de API para copiar. A mesma configuração serve à CLI do Codex e à extensão do Codex para IDE.

```bash theme={null}
codex mcp add didit --url https://mcp.didit.me/mcp
```

***

## Configuração

**1. Adicionar o servidor**

```bash theme={null}
codex mcp add didit --url https://mcp.didit.me/mcp
```

O Codex grava o servidor em `~/.codex/config.toml`, identifica que ele exige OAuth e inicia o login imediatamente. Se você cancelar, execute `codex mcp login didit` depois.

**2. Fazer login com Didit**

Seu navegador abre **O Codex quer acessar sua conta da Didit**. Escolha as organizações que deseja conectar, revise as permissões e clique em **Aprovar**. O terminal exibe `Successfully logged in to MCP server 'didit'.`

**3. Confirmar**

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

A linha `didit` mostra o status `enabled` e a autenticação `OAuth`.

Prefere editar o arquivo manualmente? Esta é a entrada completa em `~/.codex/config.toml`:

```toml theme={null}
[mcp_servers.didit]
url = "https://mcp.didit.me/mcp"
```

Depois, execute `codex mcp login didit` para fazer login.

> [!NOTE]
>
> **Nenhuma chave de API na configuração.** O servidor usa OAuth 2.1 com PKCE e atua **em seu nome**: somente nas organizações que você aprovar no login, com as permissões da sua função. O Codex se identifica com um Client ID Metadata Document. Consulte [Autenticação](https://docs.didit.me/pt-br/integration/mcp/authentication.md).

***

## Verifique se está funcionando

Inicie o Codex e faça uma pergunta, citando o servidor:

```text theme={null}
Use the didit MCP server: call didit_context_get and list my organizations and applications.
```

O Codex carrega as ferramentas MCP sob demanda, então mencione o servidor ou a ferramenta da Didit no seu primeiro prompt. Ele chama `didit_context_get` e lista suas organizações com as respectivas aplicações.

Para manter a sessão focada, limite o Codex às ferramentas de que você precisa com `enabled_tools`:

```toml theme={null}
[mcp_servers.didit]
url = "https://mcp.didit.me/mcp"
enabled_tools = ["didit_context_get", "didit_session_create", "didit_session_list", "didit_session_get_decision"]
```

`disabled_tools` faz o oposto. Os nomes das ferramentas estão na [referência de ferramentas](https://docs.didit.me/pt-br/integration/mcp/tools.md).

***

## Solução de problemas

* **`Not logged in` em `codex mcp list`.** Execute `codex mcp login didit` e conclua o login no navegador.
* **Em uma máquina remota sem navegador.** Execute `codex mcp login didit`, abra a URL exibida no seu próprio computador e mantenha o terminal aberto até o login ser concluído. O callback vai para uma porta local na máquina que executa o Codex, então encaminhe essa porta, se necessário.
* **Uma ferramenta responde com `missing_scope`.** Sua função nessa organização não tem a permissão necessária. Consulte [papéis e permissões](https://docs.didit.me/pt-br/integration/mcp/authentication.md#funções-e-permissões).
* **Para sair:** `codex mcp logout didit`.

***

## Próximos passos

> [card] [Conectar ao ChatGPT](https://docs.didit.me/pt-br/integration/mcp/chatgpt.md)
>
> O plugin da Didit no diretório do ChatGPT, ou o servidor completo como servidor MCP personalizado.

> [card] [Conectar ao Claude](https://docs.didit.me/pt-br/integration/mcp/claude.md)
>
> Link de conector com um clique para o Claude na web, no Desktop e no Code.

> [card] [Referência de ferramentas](https://docs.didit.me/pt-br/integration/mcp/tools.md)
>
> Tudo que o agente pode chamar, ferramenta por ferramenta.

> [card] [Exemplos de prompts](https://docs.didit.me/pt-br/integration/mcp/examples.md)
>
> Exemplos práticos mais longos, com payloads reais.


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