Conectar via MCP

O MCP (Model Context Protocol) é um padrão aberto que conecta ferramentas de IA a serviços externos. Conectado ao CutPro, o modelo executa o fluxo inteiro sozinho: analisa o vídeo, clipa, renderiza e devolve o link.

Nota

O acesso à API exige o plano Pro. Gere uma chave em Chaves de API e use-a como CUTPRO_API_KEY.

Local: Claude Code, Cursor, VS Code

O servidor roda na sua máquina via npx e expõe os endpoints da API v1 como ferramentas, cobrindo workspace, saldo, vídeos e uploads, clipagem, clipes, templates, renders, publicação e conexões.

Claude Code

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

Claude Desktop, Cursor, VS Code

Configuração de servidores MCP

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

Dica

Chave multi-workspace? Adicione também CUTPRO_WORKSPACE_ID ao env.

Exemplo de uso

Depois de conectado, basta pedir em linguagem natural:

“Analise este vídeo do YouTube, gere os clipes, e me mande os 3 de maior nota já renderizados.”

A IA encadeia as ferramentas sozinha: analyze_video, submit_clipping, get_submission (até concluir), list_clips, render_clip, get_render e get_render_download.

Remoto: ChatGPT e Claude.ai

O mesmo servidor roda em https://mcp.cut.pro com OAuth 2.1 completo (descoberta de metadados, registro dinâmico de cliente, PKCE e refresh token). É o caminho para os clientes que rodam na nuvem e não executam npx.

1. Adicione o conector

   No ChatGPT (Connectors) ou no Claude.ai (Settings, Connectors, Add custom connector), informe a URL https://mcp.cut.pro.

2. Autorize com sua chave

   O cliente abre uma página de consentimento. Cole sua chave de API: ela é validada e o acesso é autorizado.

3. Pronto

   O cliente passa a usar as ferramentas do CutPro nas conversas.

Deixe a IA ler esta documentação

Para perguntas sobre o produto, sem executar nada, a documentação é publicada em texto puro no formato que os modelos leem direto:

Endereço	O que traz
/docs/llms.txt	O índice de todas as páginas, nos três idiomas
/docs/llms-full.txt	A documentação inteira em um arquivo só

Cole um dos dois numa conversa e peça o que quiser. Qualquer página também responde em Markdown trocando a URL por .md, como em /docs/api-reference/quickstart.md.

Próximo passo

Prefere chamar a API direto?

O Quickstart tem o fluxo inteiro em curl, Node.js e Python