# Construye con IA

> Conecta Cut.Pro a Claude, ChatGPT, Cursor o VS Code por MCP, y dale a tu agente de código la documentación en texto plano.

Cut.Pro tiene un servidor [MCP](https://modelcontextprotocol.io) oficial. Conectado a él, el asistente usa cada ruta de la API v1 como una herramienta: genera clips de un video, genera imagen, video y voz, crea personas, renderiza y publica. En clientes que aceptan confirmación, muestra el precio y espera el sí antes de cobrar.

| Camino | Para quién | Autenticación |
|---|---|---|
| Local, vía `npx` | Claude Code, Claude Desktop, Cursor, VS Code | Clave de API, en los planes Gratuito, Básico, Plus y Pro |
| Remoto, `https://mcp.cut.pro` | ChatGPT, Claude.ai | OAuth, en cualquier plan |

## Local

**Claude Code**

```bash
claude mcp add cutpro \
  --env CUTPRO_API_KEY=$CUTPRO_API_KEY \
  -- npx -y @cutpro/mcp@latest
```

**Claude Desktop, Cursor, VS Code**

```json title="mcpServers"
{
  "mcpServers": {
    "cutpro": {
      "command": "npx",
      "args": ["-y", "@cutpro/mcp@latest"],
      "env": { "CUTPRO_API_KEY": "tu_clave" }
    }
  }
}
```

Una clave con acceso a varios workspaces necesita también `CUTPRO_WORKSPACE_ID` en `env`. Genera la clave en [Autenticación](/es/authentication).

## Remoto

### Agrega el conector

En ChatGPT, en Connectors. En Claude.ai, en Settings, Connectors, Add custom connector. La URL es `https://mcp.cut.pro`.

### Autoriza

El cliente abre cut.pro. Inicia sesión, elige el workspace y haz clic en Conectar. Los trabajos usan los créditos de ese workspace. Desconecta cuando quieras en [Apps conectadas](https://cut.pro/studio/me/api-keys).

El servidor remoto sigue OAuth 2.1 con descubrimiento de metadatos, registro dinámico de clientes, PKCE y refresh token.

## Pide en lenguaje natural

> Analiza este video de YouTube, genera los clips y envíame los 3 de mayor nota ya renderizados.

El asistente encadena `analyze_video`, `create_submission`, `get_submission` hasta terminar, `list_clips`, `render_clip`, `get_render` y `download_render`.

> Haz un video vertical de 5 segundos de un barista dibujando en la cafetería con Veo. Muéstrame el precio antes.

Lee modelos y precios con `list_generation_models`, muestra el total y, después del sí, llama a `create_generation` y `get_generation`. Para publicar el resultado, `open_generation_edit` devuelve el `edit_id`.

Cada herramienta lleva el nombre de la operación de la API en `snake_case`, así que lo que está en la [referencia](/reference) vale para el asistente. El servidor también trae pedidos listos que aparecen en el menú del cliente: `generate_video`, `product_ad`, `create_persona`, `clip_and_schedule` y `transcribe`.

## Dale la documentación a tu agente de código

Toda la documentación sale en texto plano, en el formato que los modelos leen directamente:

| Dirección | Qué trae |
|---|---|
| [`/docs/llms.txt`](https://cut.pro/docs/llms.txt) | Índice de todas las páginas, en los tres idiomas. |
| [`/docs/llms-full.txt`](https://cut.pro/docs/llms-full.txt) | La documentación completa en un archivo. |
| `/docs/<página>.md` | Cualquier página en Markdown, como [`/docs/quickstart.md`](https://cut.pro/docs/quickstart.md). |
| [`openapi.json`](https://api.cut.pro/api/v1/openapi.json) | El contrato completo de la API v1. |

Para tener la integración escrita en tu proyecto, pega esto en Cursor, en Claude Code o en el asistente que uses:

```text
Lee https://cut.pro/docs/llms-full.txt y el contrato en
https://api.cut.pro/api/v1/openapi.json.

Escribe un script que:
1. analice la URL de video que yo pase (POST /clips/info) y muestre el costo
   en créditos antes de gastar;
2. cree el envío y lo siga hasta que termine;
3. renderice el clip de mayor nota y devuelva el enlace del MP4.

La clave viene de la variable de entorno CUTPRO_API_KEY y va en el header X-Api-Key.
Todo campo es snake_case y el id del propio recurso es siempre "id". Todo error viene
como { code, extra }: trátalo por el code y respeta el Retry-After en un 429.
```

> La clave da acceso a los créditos y a las cuentas conectadas del workspace. Déjala en una variable de entorno y nunca pegues el valor dentro del código ni del pedido al asistente.

- [¿Prefieres llamar a la API directamente?](https://cut.pro/docs/es/quickstart): Del enlace al MP4 vertical, en curl, Node.js y Python.
- [Recetas](https://cut.pro/docs/es/recipes): Flujos completos listos para copiar.