Configuração do Sketchie MCP: Claude Desktop, Claude Code, aplicação Claude

A Sketchie inclui um servidor MCP, por isso qualquer agente compatível com MCP pode gerar e editar vídeos explicativos de quadro branco como ferramentas nativas. Configure-o no Claude Code, no Claude Desktop e na aplicação Claude.

O que precisa

Uma chave de API da Sketchie (sk_...). Crie uma na aplicação em Definições. O acesso à API está incluído em todos os planos pagos.
O servidor MCP da Sketchie. Corre em bun e fica em packages/mcp/src/index.ts no repositório da Sketchie.

Duas variáveis de ambiente configuram o servidor:

Variável	Significado	Predefinição
`SKETCHIE_API_KEY`	A sua chave de API, enviada como token Bearer.	unset
`SKETCHIE_API_URL`	URL base da API, incluindo o prefixo `/api`.	`https://sketchie.ai/api`

Claude Code

Registe o servidor com um comando. Substitua o caminho pelo seu checkout do repositório da Sketchie.

Terminal

claude mcp add sketchie \
  -e SKETCHIE_API_URL=https://sketchie.ai/api \
  -e SKETCHIE_API_KEY=sk_... \
  -- bun /path/to/sketchie/packages/mcp/src/index.ts

Verifique que ficou registado com claude mcp list. Numa sessão, peça ao Claude para gerar um explicativo e ele chamará as ferramentas da Sketchie.

Claude Desktop

Abra o ficheiro de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Adicione a Sketchie em mcpServers e depois reinicie o Claude Desktop:

claude_desktop_config.json

{
  "mcpServers": {
    "sketchie": {
      "command": "bun",
      "args": ["/path/to/sketchie/packages/mcp/src/index.ts"],
      "env": {
        "SKETCHIE_API_URL": "https://sketchie.ai/api",
        "SKETCHIE_API_KEY": "sk_..."
      }
    }
  }
}

Após o reinício, as ferramentas da Sketchie aparecem no menu de ferramentas. Pode abrir a configuração rapidamente em Definições, Programador, Editar Configuração.

A aplicação Claude

A aplicação de ambiente de trabalho do Claude usa o mesmo claude_desktop_config.json acima. Adicione conectores personalizados em Definições, Conectores, Adicionar conector personalizado.

O servidor MCP da Sketchie corre como um processo local (transporte stdio), por isso funciona onde quer que o Claude possa iniciar um comando local, ou seja, o Claude Code e a aplicação de ambiente de trabalho do Claude. Um conector alojado para as aplicações web e móvel do Claude está no roteiro. Entretanto, a API HTTP, o SDK e a CLI cobrem todos os outros ambientes.

As ferramentas

Ferramenta	O que faz
`sketchie_generate_explainer`	Inicia uma geração a partir de `input` (com `length`, `aspect`, `voice` opcionais). Devolve o registo em fila.
`sketchie_get_explainer`	Obtém o estado, o URL do vídeo quando pronto, e o scene graph editável.
`sketchie_edit_explainer`	Aplica uma instrução em linguagem simples como um re-render direcionado.
`sketchie_list_explainers`	Lista os explicativos que a sua chave possui.
`sketchie_list_voices`	Lista as vozes de narração.