Conectar
Conecta Windsurf
Añade Filmo a Cascade de Windsurf con una clave de API leída de tu 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ú, en mcp_config.. Los administradores de Team y Enterprise pueden desactivar MCP y permitir servidores por nombre. |
| Quién conecta | Cada usuario, con su propio fichero de configuración. |
| Administración | En cuanto un servidor entra en la lista de permitidos, se bloquea todo servidor que no esté en ella; el id tiene que coincidir con la clave de mcp_config.. |
verificado el 2026-10-09: MCP en Cascade
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 a
mcp_config.una entrada solo conjson serverUrl.Autenticar
Windsurf documenta la compatibilidad con OAuth para cada transporte; los pasos de su diálogo no están documentados, así que sigue lo que muestre el cliente y da tu consentimiento en Filmo.
- Cómo se eligen los scopes y si las herramientas se vuelven a listar tras iniciar sesión: no está documentado por el proveedor.
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 APIAbrir el archivo
En el panel Cascade abre el menú Actions y elige el archivo de configuración de MCP.
Haz referencia a la clave
${env:NAME}se rellena desde el entorno enserverUrl,urlyheaders; una variable sin definir se convierte en una cadena vacía.
{
"mcpServers": {
"filmo": {
"serverUrl": "https://app.filmo.io/api/v1/mcp",
"headers": {
"Authorization": "Bearer ${env: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 | Cascade tiene un límite de 100 herramientas en total a las que puede acceder en cada momento, entre todos los servidores. |
| Salida | Un límite de salida de herramientas: no documentado por el proveedor. |
Preajuste recomendado
Enlace a esta sección: Preajuste recomendadoDisponibilidad y agenda (lectura) (20): availability:read, schedule:read, planner:read, staff:read, vehicles:read, items:read, spaces:read, kits:read, account:read. Mantén el total por debajo de 100 contando tus otros servidores.
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»Activa o desactiva un servidor en la sección MCPs; desactiva herramientas concretas con disabledTools en la entrada del servidor.
Las herramientas que deben pedir aprobación están en Escrituras seguras.
- La página describe la configuración del agente Cascade heredado; su documentación ahora está junto a Devin Desktop.
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?