> ## 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.

# 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. O CutPro oferece duas formas de conexão, com propósitos diferentes:

<CardGroup cols={2}>
  <Card icon="book-open" title="MCP de documentação">
    Deixa a IA **responder perguntas** sobre o CutPro lendo a documentação. Só leitura.
  </Card>

  <Card icon="wand-sparkles" title="MCP da API (ações)">
    Deixa a IA **executar o fluxo**: analisar, clipar, renderizar e baixar, usando a sua chave de API.
  </Card>
</CardGroup>

## 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.

<Tabs>
  <Tab title="Claude">
    Em **Settings → Connectors → Add custom connector**, informe a URL `https://cut.pro/docs/mcp`.
  </Tab>

  <Tab title="Cursor / VS Code">
    Adicione o servidor MCP com a URL `https://cut.pro/docs/mcp` nas configurações de MCP do editor.
  </Tab>

  <Tab title="ChatGPT">
    Em **Settings → Connectors**, adicione um conector apontando para `https://cut.pro/docs/mcp`.
  </Tab>
</Tabs>

## 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`.

<Note>
  O acesso à API exige o plano **Pro**. Gere uma chave em [Chaves de API](https://cut.pro/studio/me/api-keys) e use-a como `CUTPRO_API_KEY`.
</Note>

### Claude Code

```bash theme={null}
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:

```json theme={null}
{
  "mcpServers": {
    "cutpro": {
      "command": "npx",
      "args": ["-y", "@cutpro/mcp"],
      "env": { "CUTPRO_API_KEY": "SUA_CHAVE" }
    }
  }
}
```

<Tip>
  Chave multi-workspace? Adicione também `CUTPRO_WORKSPACE_ID` ao `env`.
</Tip>

### 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:

<Steps>
  <Step title="Adicione o conector">
    No ChatGPT (Connectors) ou no Claude.ai (Settings → Connectors → Add custom connector), informe a URL do servidor: `https://mcp.cut.pro`.
  </Step>

  <Step title="Autorize com sua chave">
    O cliente abre uma página de consentimento. Cole sua [chave de API](https://cut.pro/studio/me/api-keys). A chave é validada e o acesso é autorizado.
  </Step>

  <Step title="Pronto">
    O cliente passa a usar as ferramentas do CutPro nas conversas.
  </Step>
</Steps>

<Card icon="terminal" href="/api-reference/quickstart" horizontal>
  Prefere chamar a API direto? Veja o **Quickstart** com exemplos em `curl`.
</Card>