Cut.ProDocs
Guias

Conectar via MCP

Use o CutPro dentro do Claude, ChatGPT e outras ferramentas de IA via Model Context Protocol

O MCP (Model Context Protocol) é um padrão aberto que conecta ferramentas de IA a serviços externos. Conectado ao CutPro, o modelo gera imagens e vídeos com qualquer modelo de ponta (Veo, Kling, Seedance, Wan, Nano Banana, GPT Image e mais), cria personas IA e coloca em vídeos, e clipa vídeos longos do começo ao fim, devolvendo o link. Nos clientes com MCP Apps o resultado toca no próprio chat, e os que aceitam confirmação mostram o preço e esperam o seu sim antes de cobrar.

O servidor local usa uma chave de API, que vem nos planos Gratuito, Básico, Plus e Pro: gere uma em Chaves de API e use-a como CUTPRO_API_KEY. O servidor remoto, mais abaixo, funciona em qualquer plano e sem chave.

Local: Claude Code, Cursor, VS Code

O servidor roda na sua máquina via npx e expõe todos os endpoints da API v1 como ferramentas, uma por endpoint: geração de imagem e vídeo, personas IA, workspace, saldo, vídeos e uploads, clipagem, clipes, monitoramento de canais e lives, templates, renders, transcrição, publicação e conexões. O que a API faz, o modelo faz.

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

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, create_submission, get_submission (até concluir), list_clips, render_clip, get_render e download_render.

"Faça um vídeo vertical de 5 segundos de um barista desenhando no café com o Veo, e me mostre o preço antes de começar."

A IA lê os modelos e preços com list_generation_models, informa o total e, depois do seu sim, chama create_generation e get_generation até o vídeo ficar pronto. Para animar uma imagem que acabou de gerar, ela passa o output.image_id dessa imagem em image_ids.

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.

Adicione o conector

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

Entre e autorize

O cliente abre o cut.pro. Entre na sua conta, escolha o workspace que o app pode usar e clique em Conectar. Os trabalhos usam os créditos desse workspace, em qualquer plano, e dá para desconectar quando quiser em Apps conectados.

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çoO que traz
/docs/llms.txtO índice de todas as páginas, nos três idiomas
/docs/llms-full.txtA 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.

Peça para a IA escrever a integração

Se você quer o código pronto no seu projeto em vez de rodar tudo pelo chat, cole este pedido no Cursor, no Claude Code ou no assistente que você usa:

Leia https://cut.pro/docs/llms-full.txt e a spec em
https://api.cut.pro/api/v1/openapi.json.

Escreva um script que:
1. analise a URL de vídeo que eu passar (POST /clips/info) e me diga o custo
   em créditos antes de gastar;
2. submeta para clipagem e acompanhe até terminar;
3. renderize o clipe de maior nota e me devolva o link do MP4.

Regras da API: a chave vai no header X-Api-Key; todo campo é snake_case; o id
do próprio recurso é sempre "id"; todo erro vem como { code, extra }, então
trate pelo code e respeite o header Retry-After no 429.

A chave de API dá acesso aos créditos e às contas conectadas do workspace. Deixe-a numa variável de ambiente e não cole a chave dentro do código que você pede para a IA escrever.

Próximo passo

Prefere chamar a API direto?

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

Nesta página