*MCP › Conectar*

# Conecta OpenAI Codex

> Añade Filmo a Codex (CLI e IDE) con OAuth o con una clave de API leída de una variable de entorno.

## Antes de empezar

| Qué | Lo que documenta el proveedor |
| --- | --- |
| Plan | Planes: no documentado por el proveedor. |
| Quién añade el conector | Tú, con `codex mcp add` o `config.toml`. Los administradores del espacio de trabajo pueden restringir servidores con requisitos gestionados. |
| Quién conecta | `codex mcp login filmo` para OAuth. |
| Administración | El requisito `mcp_servers` de la empresa. |

verificado el 2026-10-09: [MCP en Codex](https://learn.chatgpt.com/docs/extend/mcp?surface=cli) · [Referencia de configuración](https://learn.chatgpt.com/docs/config-file/config-reference)

> **Usa exactamente esta URL:** Escribe `https://app.filmo.io/api/v1/mcp` tal cual. No uses el dominio de Filmo de tu empresa ni otro host: los metadatos de OAuth nombran este origen, y un cliente que lo compara con lo que escribiste rechaza uno distinto.

## Conecta con OAuth

1. **Añadir el servidor** Añade la entrada solo con `url` (consulta el archivo de abajo sin `bearer_token_env_var`).
2. **Iniciar sesión** Ejecuta `codex mcp login filmo`; el navegador abre la pantalla de consentimiento de Filmo.

- Si el servidor anuncia `scopes_supported`, Codex prefiere esos scopes durante el inicio de sesión; si no, usa los scopes de `config.toml`. Los metadatos del recurso de Filmo anuncian todos los scopes: elige en la pantalla de consentimiento.
- Por defecto, Codex usa un documento de metadatos del cliente cuando el servidor lo admite y, si no, el registro dinámico.

## La pantalla de consentimiento

- Solo vienen marcados los permisos `*:read` que pidió el cliente (todos los de lectura si no pide ninguno).
- Los de escritura, `workflows:run` y `ai:ask` salen siempre desmarcados, aunque el cliente los pida; los que pidió llevan la etiqueta «Lo pide la integración».
- Marca a mano solo lo que el asistente necesita y deja `ai:ask` desmarcado salvo que quieras que gaste créditos de IA.

Para cambiar los permisos más adelante, quita el conector y vuelve a añadirlo.

Antes de aprobar, lee [Autenticación](https://docs.filmo.io/es/mcp/authentication#before-you-approve).

## Conecta con una clave de API

1. **Exportar la clave** Define `FILMO_API_KEY` en el entorno desde el que arranca Codex.
2. **Ponle nombre a la variable** `bearer_token_env_var` contiene el nombre de la variable, nunca su valor.

*~/.codex/config.toml*

```text
[mcp_servers.filmo]
url = "https://app.filmo.io/api/v1/mcp"
bearer_token_env_var = "FILMO_API_KEY"
```

> **Deja la clave fuera del repositorio:** No pegues nunca una clave de API en un fichero que vaya a control de versiones. Los ejemplos la leen del entorno o la piden; si una se filtra, revócala y crea otra.

## Límites de este cliente

| Qué | Lo que documenta el proveedor |
| --- | --- |
| Herramientas | Límite de herramientas: no documentado por el proveedor. |
| Salida | `output_token_limit` por herramienta, y `tool_output_token_limit` para lo que entra en el historial. |
| Tiempo | `tool_timeout_sec` es 60 por defecto: súbelo para `filmo_ai_ask`, que puede tardar decenas de segundos. |

## Preajuste recomendado

Operaciones de alquiler (21): `orders:read`, `orders:write`, `availability:read`, `items:read`, `contacts:read`, `account:read`. Incluye las escrituras de pedidos, la cancelación incluida: combínalo con el modo de aprobación de abajo, o elige un preajuste marcado (read).

Todos los presets y su peso, en [Límites y contexto](https://docs.filmo.io/es/mcp/guides/limits-and-context).

## Qué poner en «preguntar antes de ejecutar»

`default_tools_approval_mode` acepta `auto`, `prompt`, `writes` y `approve`; `writes` pregunta por las herramientas que no están marcadas como de solo lectura. Por herramienta: `approval_mode`.

Las herramientas que deben pedir aprobación están en [Escrituras seguras](https://docs.filmo.io/es/mcp/guides/safe-writes#requires-confirmation).

- Ampliación de permisos (scope) y volver a listar las herramientas tras iniciar sesión: no está documentado por el proveedor.

## Comprueba la conexión

Pregunta al asistente: «¿A qué cuenta de Filmo estoy conectado?». Debería llamar a `filmo_account_get`, una herramienta de lectura que no devuelve datos personales.

---

URL canónica: https://docs.filmo.io/es/mcp/connect/codex  
Última actualización: 2026-10-25