Configurazione MCP di Sketchie: Claude Desktop, Claude Code, app Claude

Sketchie include un server MCP, così qualsiasi agente compatibile MCP può generare e modificare video esplicativi a lavagna come strumenti nativi. Configuralo in Claude Code, Claude Desktop e l’app Claude.

Cosa ti serve

Una chiave API di Sketchie (sk_...). Creane una nell’app in Impostazioni. L’accesso all’API è incluso in ogni piano a pagamento.
Il server MCP di Sketchie. Gira su bun e si trova in packages/mcp/src/index.ts nel repository di Sketchie.

Due variabili d’ambiente configurano il server:

Variabile	Significato	Predefinito
`SKETCHIE_API_KEY`	La tua chiave API, inviata come token Bearer.	unset
`SKETCHIE_API_URL`	URL base dell’API, incluso il prefisso `/api`.	`https://sketchie.ai/api`

Claude Code

Registra il server con un comando. Sostituisci il percorso con il tuo checkout del repository di 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

Verifica la registrazione con claude mcp list. In una sessione, chiedi a Claude di generare un esplicativo e chiamerà gli strumenti di Sketchie.

Claude Desktop

Apri il file di configurazione di Claude Desktop:

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

Aggiungi Sketchie sotto mcpServers, poi riavvia 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_..."
      }
    }
  }
}

Dopo il riavvio, gli strumenti di Sketchie compaiono nel menu strumenti. Puoi aprire la config velocemente da Impostazioni, Sviluppatore, Modifica config.

L’app Claude

L’applicazione desktop di Claude usa lo stesso claude_desktop_config.json di sopra. Aggiungi connettori personalizzati da Impostazioni, Connettori, Aggiungi connettore personalizzato.

Il server MCP di Sketchie gira come processo locale (trasporto stdio), quindi funziona ovunque Claude possa lanciare un comando locale, cioè Claude Code e l’app desktop di Claude. Un connettore ospitato per le app web e mobile di Claude è nella roadmap. Nel frattempo, l’API HTTP, l’SDK e la CLI coprono ogni altro ambiente.

Gli strumenti

Strumento	Cosa fa
`sketchie_generate_explainer`	Avvia una generazione da `input` (con `length`, `aspect`, `voice` opzionali). Restituisce il record in coda.
`sketchie_get_explainer`	Recupera lo stato, l’URL del video una volta pronto e lo scene graph modificabile.
`sketchie_edit_explainer`	Applica un’istruzione in linguaggio naturale come un re-render mirato.
`sketchie_list_explainers`	Elenca gli esplicativi posseduti dalla tua chiave.
`sketchie_list_voices`	Elenca le voci di narrazione.