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

# Connetti OpenAI Codex al server MCP di Didit

> Aggiungi Didit a OpenAI Codex con un comando: codex mcp add didit --url https://mcp.didit.me/mcp, poi accedi. Nessuna chiave API.

OpenAI Codex si connette al server MCP ospitato di Didit (`https://mcp.didit.me/mcp`) con un solo comando. Codex apre poi **Log in with Didit** nel browser e memorizza l'accesso per te; non c'è alcuna chiave API da copiare. La stessa configurazione vale per la CLI di Codex e per l'estensione IDE di Codex.

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

***

## Configurazione

**1. Aggiungi il server**

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

Codex scrive il server in `~/.codex/config.toml`, rileva che richiede OAuth e avvia subito l'accesso. Se lo annulli, esegui più tardi `codex mcp login didit`.

**2. Accedi con Didit**

Nel browser si apre **Codex vuole accedere al tuo account Didit**. Scegli le organizzazioni da collegare, controlla le autorizzazioni e fai clic su **Approva**. Il terminale mostra `Successfully logged in to MCP server 'didit'.`

**3. Conferma**

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

La riga `didit` mostra lo stato `enabled` e l'autenticazione `OAuth`.

Preferisci modificare il file manualmente? Questa è l'intera voce in `~/.codex/config.toml`:

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

Poi esegui `codex mcp login didit` per accedere.

> [!NOTE]
>
> **Nessuna chiave API nella configurazione.** Il server usa OAuth 2.1 con PKCE e agisce **per tuo conto**: solo nelle organizzazioni che approvi durante l'accesso, con i permessi del tuo ruolo. Codex si identifica con un Client ID Metadata Document. Vedi [Autenticazione](https://docs.didit.me/it/integration/mcp/authentication.md).

***

## Verifica che funzioni

Avvia Codex e fai una domanda, indicando il server per nome:

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

Codex carica gli strumenti MCP su richiesta, quindi nel primo prompt indica il server Didit o lo strumento. Chiama `didit_context_get` ed elenca le tue organizzazioni con le relative applicazioni.

Per mantenere una sessione mirata, limita Codex agli strumenti che ti servono con `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 l'operazione opposta. I nomi degli strumenti sono nel [riferimento degli strumenti](https://docs.didit.me/it/integration/mcp/tools.md).

***

## Risoluzione dei problemi

* **`Not logged in` in `codex mcp list`.** Esegui `codex mcp login didit` e completa l'accesso dal browser.
* **Su una macchina remota senza browser.** Esegui `codex mcp login didit`, apri l'URL stampato sul tuo computer e lascia il terminale aperto finché l'accesso non è completato. Il callback va a una porta locale della macchina su cui è in esecuzione Codex, quindi inoltra quella porta se necessario.
* **Uno strumento risponde con `missing_scope`.** Il tuo ruolo in quell'organizzazione non ha l'autorizzazione necessaria. Consulta [ruoli e autorizzazioni](https://docs.didit.me/it/integration/mcp/authentication.md#ruoli-e-autorizzazioni).
* **Per uscire:** `codex mcp logout didit`.

***

## Prossimi passi

> [card] [Collega ChatGPT](https://docs.didit.me/it/integration/mcp/chatgpt.md)
>
> Il plugin Didit nella directory di ChatGPT, oppure il server completo come server MCP personalizzato.

> [card] [Collega Claude](https://docs.didit.me/it/integration/mcp/claude.md)
>
> Link di connessione in un clic per Claude web, Desktop e Code.

> [card] [Riferimento agli strumenti](https://docs.didit.me/it/integration/mcp/tools.md)
>
> Tutto ciò che l'agente può richiamare, strumento per strumento.

> [card] [Prompt di esempio](https://docs.didit.me/it/integration/mcp/examples.md)
>
> Esempi più lunghi e completi, con payload reali.


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