# Construa com IA

> Ligue a Cut.Pro ao Claude, ChatGPT, Cursor ou VS Code por MCP, e dê ao seu agente de código a documentação em texto puro.

A Cut.Pro tem um servidor [MCP](https://modelcontextprotocol.io) oficial. Conectado a ele, o assistente usa cada rota da API v1 como uma ferramenta: clipa um vídeo, gera imagem, vídeo e voz, cria personas, renderiza e publica. Em clientes que aceitam confirmação, ele mostra o preço e espera o sim antes de cobrar.

| Caminho | Para quem | Autenticação |
|---|---|---|
| Local, via `npx` | Claude Code, Claude Desktop, Cursor, VS Code | Chave de API, nos planos Gratuito, Básico, Plus e Pro |
| Remoto, `https://mcp.cut.pro` | ChatGPT, Claude.ai | OAuth, em qualquer plano |

## Local

**Claude Code**

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

**Claude Desktop, Cursor, VS Code**

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

Uma chave com acesso a vários workspaces precisa também de `CUTPRO_WORKSPACE_ID` no `env`. Gere a chave em [Autenticação](/authentication).

## Remoto

### Adicione o conector

No ChatGPT, em Connectors. No Claude.ai, em Settings, Connectors, Add custom connector. A URL é `https://mcp.cut.pro`.

### Autorize

O cliente abre o cut.pro. Entre, escolha o workspace e clique em Conectar. Os trabalhos usam os créditos desse workspace. Desconecte quando quiser em [Apps conectados](https://cut.pro/studio/me/api-keys).

O servidor remoto segue OAuth 2.1 com descoberta de metadados, registro dinâmico de cliente, PKCE e refresh token.

## Peça em linguagem natural

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

O assistente encadeia `analyze_video`, `create_submission`, `get_submission` até terminar, `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. Me mostre o preço antes.

Ele lê modelos e preços com `list_generation_models`, mostra o total e, depois do sim, chama `create_generation` e `get_generation`. Para publicar o resultado, `open_generation_edit` devolve o `edit_id`.

Cada ferramenta tem o nome da operação da API em `snake_case`, então o que está na [referência](/reference) vale para o assistente. O servidor também traz pedidos prontos que aparecem no menu do cliente: `generate_video`, `product_ad`, `create_persona`, `clip_and_schedule` e `transcribe`.

## Dê a documentação ao seu agente de código

Toda a documentação sai em texto puro, no formato que os modelos leem direto:

| Endereço | O que traz |
|---|---|
| [`/docs/llms.txt`](https://cut.pro/docs/llms.txt) | Índice de todas as páginas, nos três idiomas. |
| [`/docs/llms-full.txt`](https://cut.pro/docs/llms-full.txt) | A documentação inteira num arquivo. |
| `/docs/<página>.md` | Qualquer página em Markdown, como [`/docs/quickstart.md`](https://cut.pro/docs/quickstart.md). |
| [`openapi.json`](https://api.cut.pro/api/v1/openapi.json) | O contrato completo da API v1. |

Para ter a integração escrita no seu projeto, cole isto no Cursor, no Claude Code ou no assistente que você usa:

```text
Leia https://cut.pro/docs/llms-full.txt e o contrato 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 mostre o custo
   em créditos antes de gastar;
2. crie a submissão e acompanhe até terminar;
3. renderize o clipe de maior nota e devolva o link do MP4.

A chave vem da variável de ambiente CUTPRO_API_KEY e vai no header X-Api-Key.
Todo campo é snake_case e o id do próprio recurso é sempre "id". Todo erro vem
como { code, extra }: trate pelo code e respeite o Retry-After num 429.
```

> A chave dá acesso aos créditos e às contas conectadas do workspace. Deixe-a numa variável de ambiente e nunca cole o valor dentro do código nem do pedido ao assistente.

- [Prefere chamar a API direto?](https://cut.pro/docs/quickstart): Do link ao MP4 vertical, em curl, Node.js e Python.
- [Receitas](https://cut.pro/docs/recipes): Fluxos inteiros prontos para copiar.