*MCP › Conectar*

# Conecta VS Code

> Añade Filmo a VS Code (modo agente de GitHub Copilot) con OAuth o con una clave de API que te pide.

## Antes de empezar

| Qué | Lo que documenta el proveedor |
| --- | --- |
| Plan | Qué planes de Copilot pueden usar servidores MCP en VS Code: no documentado por el proveedor. |
| Quién añade el conector | Tú, con MCP: Add Server. En Copilot Business y Enterprise, una política de la organización (“MCP servers in Copilot”, desactivada por defecto) rige el acceso. |
| Quién conecta | Cada usuario se autentica en VS Code. |
| Administración | Políticas de VS Code: `chat.mcp.access`, listas de permitidos y denegados, solo servidores gestionados. |

verificado el 2026-10-09: [Servidores MCP en VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) · [Referencia de configuración de MCP](https://code.visualstudio.com/docs/copilot/reference/mcp-configuration)

> **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** Ejecuta MCP: Add Server desde la paleta de comandos y elige un destino, o añade la entrada a `.vscode/mcp.json`: `type` `http` y `url`, sin cabeceras.
2. **Autenticar** VS Code abre el navegador para OAuth. Da tu consentimiento en Filmo como administrador.

- VS Code intenta el registro dinámico de clientes y, cuando el servidor admite documentos de metadatos de cliente, los usa en su lugar.
- Admite el step-up de scope a partir de un desafío `WWW-Authenticate`; Filmo notifica un scope ausente como error de herramienta, así que aquí no hay step-up.
- Redirecciones que usa: `http://127.0.0.1:33418` y `https://vscode.dev/redirect`.

## 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. **Declarar una entrada** La entrada de `inputs` con `password: true` hace que VS Code te pida la clave la primera vez que arranca el servidor y oculte lo que escribes.
2. **Haz referencia a ella** La cabecera usa `${input:filmo-api-key}`; el archivo nunca guarda el valor.

*.vscode/mcp.json*

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "filmo-api-key",
      "description": "Filmo API key",
      "password": true
    }
  ],
  "servers": {
    "filmo": {
      "type": "http",
      "url": "https://app.filmo.io/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input: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.

## Instalación con un clic

El enlace instala la entrada de OAuth (sin clave): la configuración del servidor como JSON, codificada como URL.

*Link*

```text
vscode:mcp/install?%7B%22name%22%3A%22filmo%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//app.filmo.io/api/v1/mcp%22%7D
```

## Límites de este cliente

| Qué | Lo que documenta el proveedor |
| --- | --- |
| Herramientas | Una petición de chat puede tener como máximo 128 herramientas activadas; por encima de eso, desmarca herramientas o activa las herramientas virtuales con `github.copilot.chat.virtualTools.threshold`. |
| 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`. Mantente muy por debajo de 128 herramientas si hay otros servidores activados.

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»

VS Code pregunta antes de ejecutar una herramienta, salvo las anotadas con `readOnlyHint`. Activar una herramienta no se salta los controles de aprobación.

Las herramientas que deben pedir aprobación están en [Escrituras seguras](https://docs.filmo.io/es/mcp/guides/safe-writes#requires-confirmation).

- Como VS Code no pide confirmación para las herramientas anotadas como de solo lectura, `filmo_ai_ask` está anotada como no de solo lectura: gasta créditos de IA.

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