> ## 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 OpenAI Codex al servidor MCP de Didit

> Conecta el servidor MCP de Didit a OpenAI Codex con un solo comando e inicia sesión con Didit sin clave de API.

OpenAI Codex se conecta al servidor MCP alojado de Didit (`https://mcp.didit.me/mcp`) con un solo comando. A continuación, Codex abre **Log in with Didit** en tu navegador y guarda el inicio de sesión por ti; no hay que copiar ninguna clave de API. La misma configuración sirve para la CLI de Codex y para la extensión de IDE de Codex.

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

***

## Configuración

**1. Añadir el servidor**

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

Codex escribe el servidor en `~/.codex/config.toml`, detecta que necesita OAuth e inicia sesión de inmediato. Si lo cancelas, ejecuta `codex mcp login didit` más tarde.

**2. Iniciar sesión con Didit**

Tu navegador abre **Codex quiere acceder a tu cuenta de Didit**. Elige las organizaciones que deseas conectar, revisa los permisos y haz clic en **Aprobar**. La terminal muestra `Successfully logged in to MCP server 'didit'.`

**3. Confirmar**

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

La fila de `didit` muestra el estado `enabled` y la autenticación `OAuth`.

¿Prefieres editar el archivo tú mismo? Esta es la entrada completa en `~/.codex/config.toml`:

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

Luego ejecuta `codex mcp login didit` para iniciar sesión.

> [!NOTE]
>
> **Sin clave de API en la configuración.** El servidor utiliza OAuth 2.1 con PKCE y actúa como **tú**: únicamente en las organizaciones que apruebes al iniciar sesión, con los permisos de tu rol. Codex se identifica mediante un documento de metadatos del ID de cliente. Consulta [Autenticación](https://docs.didit.me/es/integration/mcp/authentication.md).

***

## Comprueba que funciona

Inicia Codex y haz una solicitud indicando el servidor:

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

Codex carga las herramientas de MCP bajo demanda, por lo que debes nombrar el servidor de Didit o la herramienta en tu primera solicitud. Invoca `didit_context_get` y enumera tus organizaciones con sus aplicaciones.

Para mantener la sesión enfocada, limita Codex a las herramientas que necesitas 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` hace lo contrario. Los nombres de las herramientas están en la [referencia de herramientas](https://docs.didit.me/es/integration/mcp/tools.md).

## Solución de problemas

* **`Not logged in` en `codex mcp list`.** Ejecuta `codex mcp login didit` y completa el inicio de sesión en el navegador.
* **En una máquina remota sin navegador.** Ejecuta `codex mcp login didit`, abre la URL mostrada en tu propio dispositivo y mantén la terminal en ejecución hasta que se complete el inicio de sesión; el callback se envía a un puerto local en la máquina que ejecuta Codex, así que redirige ese puerto si es necesario.
* **Una herramienta responde con `missing_scope`.** Tu rol en esa organización no tiene el permiso necesario. Consulta [roles y permisos](https://docs.didit.me/es/integration/mcp/authentication.md#roles-y-permisos).
* **Para cerrar sesión:** `codex mcp logout didit`.

***

## Próximos pasos

> [card] [Conectar ChatGPT](https://docs.didit.me/es/integration/mcp/chatgpt.md)
>
> El plugin de Didit en el directorio de ChatGPT o el servidor completo como servidor MCP personalizado.

> [card] [Conectar Claude](https://docs.didit.me/es/integration/mcp/claude.md)
>
> Enlace de conector en un solo clic para Claude web, Desktop y Code.

> [card] [Referencia de herramientas](https://docs.didit.me/es/integration/mcp/tools.md)
>
> Todo lo que el agente puede invocar, herramienta por herramienta.

> [card] [Prompts de ejemplo](https://docs.didit.me/es/integration/mcp/examples.md)
>
> Ejemplos prácticos más extensos con payloads reales.


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