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
Enlace a esta sección: 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.. 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 · Referencia de configuración
Usa exactamente esta URL
Escribe https:// 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
Enlace a esta sección: Conecta con OAuthAñadir el servidor
Añade la entrada solo con
url(consulta el archivo de abajo sinbearer_token_env_var).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 deconfig.. Los metadatos del recurso de Filmo anuncian todos los scopes: elige en la pantalla de consentimiento.toml - 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
Enlace a esta sección: La pantalla de consentimiento- Solo vienen marcados los permisos
*:readque pidió el cliente (todos los de lectura si no pide ninguno). - Los de escritura,
workflows:runyai:asksalen 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:askdesmarcado 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.
Conecta con una clave de API
Enlace a esta sección: Conecta con una clave de APIExportar la clave
Define
FILMO_API_KEYen el entorno desde el que arranca Codex.Ponle nombre a la variable
bearer_token_env_varcontiene el nombre de la variable, nunca su valor.
[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
Enlace a esta sección: 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
Enlace a esta sección: Preajuste recomendadoOperaciones 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.
Qué poner en «preguntar antes de ejecutar»
Enlace a esta sección: 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.
- 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
Enlace a esta sección: Comprueba la conexiónPregunta 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.
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasIntroducción
Inicio rápido de MCP
Conecta un asistente, compruébalo con una herramienta de lectura y elige los permisos que necesita.
Acceso
Autenticación y permisos
Autentica con una clave de API en una cabecera o deja que el cliente inicie sesión con OAuth 2.1. En ambos casos los permisos deciden qué herramientas existen.
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
¿Te ha resultado útil esta página?