Conectar

Conecta Windsurf

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

QuéLo que documenta el proveedor
PlanPlanes: no documentado por el proveedor.
Quién añade el conectorTú, en mcp_config.json. Los administradores de Team y Enterprise pueden desactivar MCP y permitir servidores por nombre.
Quién conectaCada usuario, con su propio fichero de configuración.
AdministraciónEn 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

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

QuéLo que documenta el proveedor
HerramientasCascade tiene un límite de 100 herramientas en total a las que puede acceder en cada momento, entre todos los servidores.
SalidaUn límite de salida de herramientas: no documentado por el proveedor.

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.

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.

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?