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

A Sketchie inclui um servidor MCP, então qualquer agente compatível com MCP pode gerar e editar vídeos explicativos de lousa como ferramentas nativas. Configure no Claude Code, Claude Desktop e no app do Claude.

O que você precisa

Uma chave de API da Sketchie (sk_...). Crie uma no app em Configurações. O acesso à API está incluído em todo plano pago.
O servidor MCP da Sketchie. Ele roda no 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	Padrão
`SKETCHIE_API_KEY`	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

Registre o servidor com um comando. Troque 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 se registrou com claude mcp list. Em uma sessão, peça ao Claude para gerar um explicativo e ele chamará as ferramentas da Sketchie.

Claude Desktop

Abra o arquivo 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 sob mcpServers e 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 reiniciar, as ferramentas da Sketchie aparecem no menu de ferramentas. Você pode abrir a configuração rápido em Configurações, Desenvolvedor, Editar Config.

O app do Claude

O aplicativo desktop do Claude usa o mesmo claude_desktop_config.json acima. Adicione conectores personalizados em Configurações, Conectores, Adicionar conector personalizado.

O servidor MCP da Sketchie roda como um processo local (transporte stdio), então funciona onde o Claude puder lançar um comando local, que é o Claude Code e o app desktop do Claude. Um conector hospedado para os apps web e mobile do Claude está no roadmap. Enquanto isso, a API HTTP, o SDK e a CLI cobrem qualquer outro ambiente.

As ferramentas

Ferramenta	O que faz
`sketchie_generate_explainer`	Inicia uma geração a partir de `input` (com `length`, `aspect`, `voice` opcionais). Retorna o registro na fila.
`sketchie_get_explainer`	Busca o status, a 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 sua chave possui.
`sketchie_list_voices`	Lista as vozes de narração.