> ## 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.

# Ligar o OpenAI Codex ao servidor MCP da Didit

> Adicione o servidor MCP da Didit ao Codex com codex mcp add didit --url https://mcp.didit.me/mcp e inicie sessão. Sem chave de API.

O OpenAI Codex liga-se ao servidor MCP alojado da Didit (`https://mcp.didit.me/mcp`) com um único comando. Em seguida, o Codex abre **Log in with Didit** no seu navegador e guarda os dados de início de sessão por si; não há nenhuma chave de API para copiar. A mesma configuração serve a CLI do Codex e a extensão do Codex para o IDE.

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

***

## Configurar

**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`, deteta que precisa de OAuth e inicia logo a autenticação. Se a cancelar, execute mais tarde `codex mcp login didit`.

**2. Iniciar sessão com a Didit**

O seu navegador abre **O Codex pretende aceder à sua conta Didit**. Escolha as organizações a ligar, reveja as permissões e clique em **Aprovar**. O terminal mostra `Successfully logged in to MCP server 'didit'.`

**3. Confirmar**

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

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

Prefere editar o ficheiro diretamente? 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 iniciar sessão.

> [!NOTE]
>
> **Sem chave de API na configuração.** O servidor usa OAuth 2.1 com PKCE e atua em **seu nome**: apenas nas organizações que aprovar no início de sessão, com as permissões da sua função. O Codex identifica-se com um documento de metadados do ID do cliente. Consulte [Autenticação](https://docs.didit.me/pt/integration/mcp/authentication.md).

***

## Verificar se funciona

Inicie o Codex e envie um pedido, mencionando 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 a pedido, por isso mencione o servidor Didit ou a ferramenta no primeiro pedido. Chama `didit_context_get` e lista as suas organizações com as respetivas aplicações.

Para manter uma sessão focada, limite o Codex às ferramentas de que 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 inverso. Os nomes das ferramentas estão na [referência das ferramentas](https://docs.didit.me/pt/integration/mcp/tools.md).

***

## Resolução de problemas

* **`Not logged in` em `codex mcp list`.** Execute `codex mcp login didit` e conclua o início de sessão no navegador.
* **Numa máquina remota sem navegador.** Execute `codex mcp login didit`, abra o URL apresentado no seu próprio computador e mantenha o terminal em execução até o início de sessão ser concluído. A chamada de retorno é enviada para uma porta local na máquina onde o Codex está a correr, por isso encaminhe essa porta, se necessário.
* **Uma ferramenta responde com `missing_scope`.** A sua função nessa organização não tem a permissão necessária. Consulte [funções e permissões](https://docs.didit.me/pt/integration/mcp/authentication.md#funções-e-permissões).
* **Para terminar a sessão:** `codex mcp logout didit`.

***

## Próximos passos

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

> [card] [Ligar ao Claude](https://docs.didit.me/pt/integration/mcp/claude.md)
>
> Ligação do conector com um clique para o Claude na web, no Desktop e no Code.

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

> [card] [Exemplos de pedidos](https://docs.didit.me/pt/integration/mcp/examples.md)
>
> Exemplos mais longos e detalhados, com payloads reais.


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