*MCP › Conectar*

# Conecta Windsurf

> Añade Filmo a Cascade de Windsurf con una clave de API leída de tu entorno.

## 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.json`. 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.json`. |

verificado el 2026-10-09: [MCP en Cascade](https://docs.devin.ai/desktop/cascade/mcp)

> **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 a `mcp_config.json` una entrada solo con `serverUrl`.
2. **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

- 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. **Abrir el archivo** En el panel Cascade abre el menú Actions y elige el archivo de configuración de MCP.
2. **Haz referencia a la clave** `${env:NAME}` se rellena desde el entorno en `serverUrl`, `url` y `headers`; una variable sin definir se convierte en una cadena vacía.

*mcp_config.json*

```json
{
  "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

| 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

Disponibilidad 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](https://docs.filmo.io/es/mcp/guides/limits-and-context).

## 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](https://docs.filmo.io/es/mcp/guides/safe-writes#requires-confirmation).

- La página describe la configuración del agente Cascade heredado; su documentación ahora está junto a Devin Desktop.

## 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/windsurf  
Última actualización: 2026-10-25