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

# Connecta OpenAI Codex al servidor MCP de Didit

> Connecta Didit a OpenAI Codex amb una comanda: codex mcp add didit --url https://mcp.didit.me/mcp. Inicia sessió amb Didit; no cal clau d'API.

OpenAI Codex es connecta al servidor MCP allotjat de Didit (`https://mcp.didit.me/mcp`) amb una sola ordre. Després, Codex obre **Log in with Didit** al navegador i desa l'inici de sessió per a tu; no cal copiar cap clau d'API. La mateixa configuració serveix per a la CLI de Codex i per a l'extensió de Codex per a l'IDE.

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

***

## Configurar

**1. Afegeix el servidor**

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

Codex escriu el servidor a `~/.codex/config.toml`, detecta que necessita OAuth i inicia immediatament el procés d'inici de sessió. Si el cancel·les, executa més tard `codex mcp login didit`.

**2. Inicia sessió amb Didit**

El navegador obre **Codex wants to access your Didit account**. Tria les organitzacions que vols connectar, revisa els permisos i fes clic a **Approve**. El terminal mostra `Successfully logged in to MCP server 'didit'.`

**3. Confirma**

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

La fila `didit` mostra l'estat `enabled` i l'autenticació `OAuth`.

Prefereixes editar tu mateix el fitxer? Aquesta és l'entrada completa de `~/.codex/config.toml`:

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

Després executa `codex mcp login didit` per iniciar la sessió.

> [!NOTE]
>
> **Cap clau d'API a la configuració.** El servidor utilitza OAuth 2.1 amb PKCE i actua en nom teu: només en les organitzacions que aproves en iniciar la sessió, amb els permisos del teu rol. Codex s'identifica amb un document de metadades de l'ID de client. Consulta [Autenticació](https://docs.didit.me/ca/integration/mcp/authentication.md).

***

## Comprova que funciona

Inicia Codex i fes una pregunta esmentant el servidor:

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

Codex carrega les eines MCP sota demanda, així que esmenta el servidor de Didit o l'eina a la primera pregunta. Crida `didit_context_get` i llista les teves organitzacions amb les seves aplicacions.

Per mantenir una sessió centrada, limita Codex a les eines que necessitis amb `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` fa el contrari. Els noms de les eines són a la [referència d'eines](https://docs.didit.me/ca/integration/mcp/tools.md).

***

## Resolució de problemes

* **`Not logged in` a `codex mcp list`.** Executa `codex mcp login didit` i completa l'inici de sessió al navegador.
* **En una màquina remota sense navegador.** Executa `codex mcp login didit`, obre l'URL que s'imprimeix al teu propi ordinador i mantén el terminal en execució fins que es completi l'inici de sessió. El callback va a un port local de la màquina on s'executa Codex, així que reenvia aquest port si cal.
* **Una eina respon amb `missing_scope`.** El teu rol en aquesta organització no té el permís necessari. Consulta [rols i permisos](https://docs.didit.me/ca/integration/mcp/authentication.md#rols-i-permisos).
* **Per tancar la sessió:** `codex mcp logout didit`.

***

## Passos següents

> [card] [Connecta ChatGPT](https://docs.didit.me/ca/integration/mcp/chatgpt.md)
>
> El complement de Didit al directori de ChatGPT, o el servidor complet com a servidor MCP personalitzat.

> [card] [Connecta Claude](https://docs.didit.me/ca/integration/mcp/claude.md)
>
> Enllaç del connector d'un sol clic per a Claude web, Desktop i Code.

> [card] [Referència d'eines](https://docs.didit.me/ca/integration/mcp/tools.md)
>
> Totes les eines que l'agent pot cridar, una per una.

> [card] [Exemples d'indicacions](https://docs.didit.me/ca/integration/mcp/examples.md)
>
> Exemples més llargs i resolts, amb payloads reals.


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