*MCP › Conectar*

# Conecta Claude Code

> Añade Filmo a Claude Code con OAuth, o con una clave de API que no entra en tu repositorio.

## Antes de empezar

| Qué | Lo que documenta el proveedor |
| --- | --- |
| Plan | No se indica ninguna restricción de plan para los servidores que añades tú. |
| Quién añade el conector | Tú, con `claude mcp add`. En Team y Enterprise, solo los administradores añaden conectores en claude.ai/customize/connectors; los ajustes gestionados pueden permitir o denegar servidores. |
| Quién conecta | Te autenticas con `/mcp` (OAuth) o envías tu propia clave. |
| Administración | Ajustes gestionados: `allowedMcpServers`, `deniedMcpServers`, `managed-mcp.json`. |

verificado el 2026-10-09: [Conectar Claude Code a servidores MCP](https://code.claude.com/docs/en/mcp) · [Permisos](https://code.claude.com/docs/en/permissions)

> **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 el comando de abajo.
2. **Autenticar** En una sesión ejecuta `/mcp`, elige filmo y autentícate; o ejecuta `claude mcp login filmo` en una shell.
3. **Consentimiento en Filmo** Un administrador elige la suscripción y los scopes en la pantalla de consentimiento de Filmo; mira más abajo.

- Cuando `oauth.scopes` no está definido, Claude Code solicita el scope de la cabecera `WWW-Authenticate` del 401 o de los metadatos del recurso, y no envía ninguno cuando ninguno de los dos lo tiene. El 401 de Filmo lleva los permisos de lectura.
- Ante un `403 insufficient_scope` falla con “needs additional permissions”; no hay step-up automático. Añade el scope a `oauth.scopes` y autentícate de nuevo.
- Usa una redirección de loopback (`http://localhost:<port>/callback`); `--callback-port` fija el puerto.

## 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. **Pon la clave en tu entorno** Exporta `FILMO_API_KEY` desde el perfil de tu shell o desde un gestor de secretos. Usa ese nombre exacto o uno propio: los nombres con aspecto de credencial que Claude Code reserva (como `ANTHROPIC_API_KEY` o `NPM_TOKEN`) se leen vacíos en las cabeceras remotas.
2. **Añadir el servidor en el ámbito de usuario** El comando siguiente guarda la entrada en tu configuración de usuario, fuera de cualquier repositorio.
3. **O comparte un archivo de proyecto sin la clave** En `.mcp.json` la cabecera lleva `${FILMO_API_KEY}`, nunca el valor, así que el fichero es seguro de commitear.

**Command**

```bash
claude mcp add --transport http filmo --scope user https://app.filmo.io/api/v1/mcp \
  --header "Authorization: Bearer $FILMO_API_KEY"
```

**.mcp.json**

```json
{
  "mcpServers": {
    "filmo": {
      "type": "http",
      "url": "https://app.filmo.io/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${FILMO_API_KEY}"
      }
    }
  }
}
```

- No uses nunca `--scope project` con una clave literal: ese scope escribe `.mcp.json`, que la documentación de Claude Code sugiere subir al control de versiones.

> **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 | No hay un tope fijo de herramientas por servidor; la búsqueda de herramientas aplaza las definiciones, así que el presupuesto es tu ventana de contexto. |
| Salida | Avisa por encima de 10,000 tokens de salida y corta en 25,000 por defecto (`MAX_MCP_OUTPUT_TOKENS`); un resultado de texto de más de 50,000 caracteres se guarda en un archivo salvo que la herramienta defina `_meta["anthropic/maxResultSizeChars"]` (hasta 500,000). Cada descripción se corta en 2,048 caracteres. |
| Tiempo | `timeout` por herramienta en la entrada del servidor; una llamada de más de dos minutos pasa a segundo plano por defecto. |

## Preajuste recomendado

Operaciones de alquiler (21): `orders:read`, `orders:write`, `availability:read`, `items:read`, `contacts:read`, `account:read`. Claude Code difiere las definiciones de las herramientas, así que el preset trata de lo que la clave puede hacer, no del contexto. Incluye las escrituras de pedidos, cancelar incluido; para trabajo de solo lectura elige un preset marcado (read).

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»

Reglas de permisos `mcp__filmo` (todo el servidor) o `mcp__filmo__<tool>`. Una herramienta con `_meta["anthropic/requiresUserInteraction"]: true` pregunta en cada llamada, en todos los modos, sin “no volver a preguntar”.

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

- Claude Code no aprueba automáticamente según `readOnlyHint` ni `destructiveHint`: no figura en su documentación.

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