Conectar vía MCP
Usa CutPro dentro de Claude, ChatGPT y otras herramientas de IA mediante el Model Context Protocol
El MCP (Model Context Protocol) es un estándar abierto que conecta herramientas de IA con servicios externos. Conectado a CutPro, el modelo ejecuta el flujo entero solo: analiza el vídeo, lo recorta, lo renderiza y devuelve el enlace.
El servidor local usa una clave de API, que viene en los planes Plus y Pro: genera una en Claves de API y úsala como CUTPRO_API_KEY. El servidor remoto, más abajo, funciona en cualquier plan y sin clave.
Local: Claude Code, Cursor, VS Code
El servidor corre en tu máquina con npx y expone todos los endpoints de la API v1 como herramientas, una por endpoint: workspace, saldo, vídeos y subidas, recorte, clips, monitoreo de canales y directos, plantillas, renders, transcripción, publicación, personas IA y conexiones. Lo que hace la API, lo hace el modelo.
claude mcp add cutpro \
--env CUTPRO_API_KEY=$CUTPRO_API_KEY \
-- npx -y @cutpro/mcp@latest¿Clave de varios workspaces? Añade también CUTPRO_WORKSPACE_ID al env.
Un ejemplo
Una vez conectado, basta con pedirlo en lenguaje natural:
"Analiza este vídeo de YouTube, genera los clips y mándame los 3 de mejor nota ya renderizados."
La IA encadena las herramientas sola: analyze_video, create_submission, get_submission (hasta que termine), list_clips, render_clip, get_render y download_render.
Remoto: ChatGPT y Claude.ai
El mismo servidor corre en https://mcp.cut.pro con OAuth 2.1 completo (descubrimiento de metadatos, registro dinámico de cliente, PKCE y refresh token). Es el camino para los clientes que corren en la nube y no ejecutan npx.
Añade el conector
En ChatGPT (Connectors) o en Claude.ai (Settings, Connectors, Add custom connector), indica la URL https://mcp.cut.pro.
Inicia sesión y autoriza
El cliente abre cut.pro. Inicia sesión, elige el workspace que la app puede usar y haz clic en Conectar. Los trabajos usan los créditos de ese workspace, en cualquier plan, y puedes desconectar cuando quieras en Apps conectadas.
Listo
El cliente ya puede usar las herramientas de CutPro en las conversaciones.
Deja que la IA lea esta documentación
Para preguntas sobre el producto, sin ejecutar nada, la documentación se publica en texto plano en el formato que los modelos leen directamente:
| Dirección | Qué trae |
|---|---|
/docs/llms.txt | El índice de todas las páginas, en los tres idiomas |
/docs/llms-full.txt | La documentación entera en un solo archivo |
Pega cualquiera de los dos en una conversación y pregunta. Cualquier página responde también en Markdown si cambias la URL por .md, como en /docs/es/api-reference/quickstart.md.
Pídele a la IA que escriba la integración
Si quieres el código en tu propio proyecto en vez de hacerlo todo por el chat, pega esto en Cursor, en Claude Code o en el asistente que uses:
Lee https://cut.pro/docs/llms-full.txt y la spec en
https://api.cut.pro/api/v1/openapi.json.
Escribe un script que:
1. analice la URL de vídeo que le pase (POST /clips/info) y me diga el coste
en créditos antes de gastar;
2. la envíe al recorte y la siga hasta que termine;
3. renderice el clip de mayor nota y me devuelva el enlace del MP4.
Reglas de la API: la clave va en la cabecera X-Api-Key; todo campo es
snake_case; el id del propio recurso siempre es "id"; todo error llega como
{ code, extra }, así que trátalo por el code y respeta la cabecera Retry-After
en el 429.Una clave de API alcanza los créditos y las cuentas conectadas del workspace. Guárdala en una variable de entorno y no pegues la clave dentro del código que le pides a la IA.
Siguiente paso
¿Prefieres llamar a la API directamente?
El Quickstart tiene el flujo entero en curl, Node.js y Python