Conectar vía MCP

El MCP (Model Context Protocol) es un estándar abierto que conecta herramientas de IA con servicios externos. CutPro ofrece dos formas de conexión, con propósitos distintos:

MCP de documentación

Deja que la IA responda preguntas sobre CutPro leyendo la documentación. Solo lectura.

MCP de la API (acciones)

Deja que la IA ejecute el flujo: analizar, clipar, renderizar y descargar, usando tu clave de API.

MCP de documentación

Servidor de búsqueda alojado en la propia documentación, en https://cut.pro/docs/mcp. Con él, la IA busca y lee las páginas para responder dudas sobre el producto. No ejecuta acciones.

Claude

En Settings → Connectors → Add custom connector, indica la URL https://cut.pro/docs/mcp.

Cursor / VS Code

Añade el servidor MCP con la URL https://cut.pro/docs/mcp en los ajustes de MCP del editor.

ChatGPT

En Settings → Connectors, añade un conector apuntando a https://cut.pro/docs/mcp.

MCP de la API (acciones)

Este servidor expone los endpoints de la API v1 como herramientas, cubriendo workspace, saldo, vídeos y subidas, clipping, clips, plantillas, renders, publicación y conexiones. Así la IA ejecuta el flujo de punta a punta, del analyze_video al create_post.

Nota

El acceso a la API exige el plan Pro. Genera una clave en Claves de API y úsala como CUTPRO_API_KEY.

Claude Code

claude mcp add cutpro \
  --env CUTPRO_API_KEY=TU_CLAVE \
  -- npx -y @cutpro/mcp

Claude Desktop, Cursor, Windsurf, VS Code

Todos usan el mismo formato de configuración de servidores MCP:

{
  "mcpServers": {
    "cutpro": {
      "command": "npx",
      "args": ["-y", "@cutpro/mcp"],
      "env": { "CUTPRO_API_KEY": "TU_CLAVE" }
    }
  }
}

Consejo

¿Clave multi-workspace? Añade también CUTPRO_WORKSPACE_ID al env.

Ejemplo de uso

Una vez conectado, basta con pedirlo en lenguaje natural:

“Analiza este vídeo de YouTube, genera los clips, y mándame los 3 de mayor puntuación ya renderizados.”

La IA encadena las herramientas sola: analyze_video → submit_clipping → get_submission (hasta terminar) → list_clips → render_clip → get_render → get_render_download.

Remoto y web (ChatGPT, Claude.ai)

El mismo servidor corre en modo HTTP remoto (self-host) con OAuth 2.1 completo (descubrimiento de metadatos, registro dinámico de cliente, PKCE y tokens). Para conectar:

1. Añade el conector

   En ChatGPT (Connectors) o en Claude.ai (Settings → Connectors → Add custom connector), indica la URL del servidor: https://mcp.cut.pro.

2. Autoriza con tu clave

   El cliente abre una página de consentimiento. Pega tu clave de API. La clave se valida y el acceso queda autorizado.

3. Listo

   El cliente pasa a usar las herramientas de CutPro en las conversaciones.

¿Prefieres llamar a la API directamente? Mira el Quickstart con ejemplos en curl.