*MCP › Conectar* # Conecta Claude > Añade Filmo a Claude en la web o en la app de escritorio como conector personalizado. ## Antes de empezar | Qué | Lo que documenta el proveedor | | --- | --- | | Plan | Los conectores personalizados funcionan en Free (uno), Pro, Max, Team y Enterprise. | | Quién añade el conector | En Team lo añade un Owner (Organization settings › Connectors); en Enterprise un Owner o un rol con «Manage access to Libraries». En Free, Pro y Max lo añades tú (Customize › Connectors). | | Quién conecta | Cada miembro conecta con su propia cuenta de Filmo (Connect en el conector). | | Administración | Un interruptor además de los roles anteriores: no documentado por el proveedor. | verificado el 2026-10-09: [Conectores personalizados (Centro de ayuda de Claude)](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) · [Añadir un conector que no figura en la lista](https://claude.com/docs/connectors/custom/add-unlisted) · [Autenticación de conectores](https://claude.com/docs/connectors/building/authentication) > **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. **Abrir los conectores** Team y Enterprise: un Owner abre Organization settings › Connectors › Add › Custom. Otros planes: Customize › Connectors › Add custom connector. 2. **Pega la URL** Ponle el nombre Filmo y pega `https://app.filmo.io/api/v1/mcp` tal cual. Deja las opciones del cliente OAuth en el valor por defecto (la identidad publicada de Claude, o Register automatically). 3. **Añadirlo y conectar** Cada persona que lo vaya a usar abre el conector y elige Connect. Claude abre la pantalla de consentimiento de Filmo. 4. **Consentimiento en Filmo** Un administrador de la cuenta de Filmo elige la suscripción y los scopes; consulta «La pantalla de consentimiento» más abajo. - Claude envía el `scope` de la cabecera `WWW-Authenticate` del 401 cuando la tiene y, si no, pide todos los scopes de los metadatos del recurso. El 401 de Filmo lleva los scopes de lectura. - El `resource` de los metadatos del recurso protegido tiene que ser igual a la URL tal como la escribiste en Claude, ruta incluida. - El URI de redirección de las apps alojadas es `https://claude.ai/api/mcp/auth_callback`: es el host que muestra la pantalla de consentimiento. - Claude sigue las especificaciones de autorización 2025-03-26, 2025-06-18 y 2025-11-25. - Ampliación de permisos (scope) tras un `403 insufficient_scope` en las apps alojadas: no está documentada por el proveedor. ## 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. **Úsalo solo si lo ves** «Request headers» es una función beta disponible para un conjunto limitado de organizaciones; si la sección no aparece en el cuadro de diálogo Add custom connector, usa OAuth. 2. **Elegir No sign-in** Pega la URL, elige No sign-in como autenticación. 3. **Añadir la cabecera** En Request headers añade `authorization` con el valor `Bearer ` seguido de tu clave. Claude envía el valor tal como está escrito y no lo vuelve a mostrar. - La cabecera es la credencial de la organización, compartida por todos los miembros que usan el conector; no se puede editar después: elimina el conector y vuelve a añadirlo. > **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 | El resultado de una herramienta se corta en unos 150,000 caracteres. | | Tiempo | Una llamada a una herramienta agota el tiempo a los 240 segundos. | ## Preajuste recomendado Operaciones de alquiler (21): `orders:read`, `orders:write`, `availability:read`, `items:read`, `contacts:read`, `account:read`. Incluye las escrituras de pedidos (crear, actualizar, archivar, reservar, anular la reserva, cancelar y devolver líneas). Para trabajo de solo lectura parte de un preajuste marcado (read) y añade escrituras a mano solo cuando el asistente las necesite. 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» Customize › Connectors › Filmo: configura cada herramienta como Always allow, Needs approval o Blocked. Las herramientas que deben pedir aprobación están en [Escrituras seguras](https://docs.filmo.io/es/mcp/guides/safe-writes#requires-confirmation). - Claude documenta `readOnlyHint` y `destructiveHint` como indicaciones que él y sus usuarios leen; cómo cambia cada una la aprobación en claude.ai no está documentado. - Compatibilidad con `_meta["anthropic/requiresUserInteraction"]` en claude.ai y la aplicación de escritorio: no está documentada 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/claude Última actualización: 2026-10-25