Skip to main content

Documentation Index

Fetch the complete documentation index at: https://cut.pro/docs/llms.txt

Use this file to discover all available pages before exploring further.

O MCP (Model Context Protocol) é um padrão aberto que conecta ferramentas de IA a serviços externos. O CutPro oferece duas formas de conexão, com propósitos diferentes:

MCP de documentação

Deixa a IA responder perguntas sobre o CutPro lendo a documentação. Só leitura.

MCP da API (ações)

Deixa a IA executar o fluxo: analisar, clipar, renderizar e baixar, usando a sua chave de API.

​
MCP de documentação

Servidor de busca hospedado nos próprios docs, em https://cut.pro/docs/mcp. Com ele, a IA pesquisa e lê as páginas para responder dúvidas sobre o produto. Não executa ações.
Em Settings → Connectors → Add custom connector, informe a URL https://cut.pro/docs/mcp.

​
MCP da API (ações)

Este servidor expõe todos os endpoints da API v1 como ferramentas (34 no total), cobrindo workspace, saldo, vídeos e uploads, clipagem, clipes, templates, renders, publicação e conexões. Assim a IA executa o fluxo de ponta a ponta, do analyze_video ao create_post.
O acesso à API exige o plano Pro. Gere uma chave em Chaves de API e use-a como CUTPRO_API_KEY.

​
Claude Code

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

​
Claude Desktop, Cursor, Windsurf, VS Code

Todos usam o mesmo formato de configuração de servidores MCP: 
{
  "mcpServers": {
    "cutpro": {
      "command": "npx",
      "args": ["-y", "@cutpro/mcp"],
      "env": { "CUTPRO_API_KEY": "SUA_CHAVE" }
    }
  }
}
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 → get_render_download.

​
Remoto e web (ChatGPT, Claude.ai)

O mesmo servidor roda em modo HTTP remoto (self-host) com OAuth 2.1 completo (descoberta de metadados, registro dinâmico de cliente, PKCE e tokens). Para conectar:
1

Adicione o conector

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

Autorize com sua chave

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

Pronto

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

Prefere chamar a API direto? Veja o Quickstart com exemplos em curl.
Last modified on June 1, 2026