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.

QuéLo que documenta el proveedor
PlanPlanes: no documentado por el proveedor.
Quién añade el conectorTú, con codex mcp add o config.toml. Los administradores del espacio de trabajo pueden restringir servidores con requisitos gestionados.
Quién conectacodex mcp login filmo para OAuth.
AdministraciónEl requisito mcp_servers de la empresa.

verificado el 2026-10-09: MCP en Codex · Referencia de configuración

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.

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

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

QuéLo que documenta el proveedor
HerramientasLímite de herramientas: no documentado por el proveedor.
Salidaoutput_token_limit por herramienta, y tool_output_token_limit para lo que entra en el historial.
Tiempotool_timeout_sec es 60 por defecto: súbelo para filmo_ai_ask, que puede tardar decenas de segundos.

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.

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.

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.

  • Introducció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?