Configuración de MCP de Sketchie: Claude Desktop, Claude Code, app de Claude

Sketchie incluye un servidor MCP, así que cualquier agente con soporte MCP puede generar y editar vídeos explicativos de pizarra como herramientas nativas. Configúralo en Claude Code, Claude Desktop y la app de Claude.

Qué necesitas

Una clave de API de Sketchie (sk_...). Crea una en la app en Ajustes. El acceso a la API está incluido en todos los planes de pago.
El servidor MCP de Sketchie. Corre sobre bun y vive en packages/mcp/src/index.ts en el repositorio de Sketchie.

Dos variables de entorno configuran el servidor:

Variable	Significado	Por defecto
`SKETCHIE_API_KEY`	Tu clave de API, enviada como token Bearer.	unset
`SKETCHIE_API_URL`	URL base de la API, incluido el prefijo `/api`.	`https://sketchie.ai/api`

Claude Code

Registra el servidor con un comando. Sustituye la ruta por tu clon del repositorio de 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 que se registró con claude mcp list. En una sesión, pídele a Claude que genere un explicativo y llamará a las herramientas de Sketchie.

Claude Desktop

Abre el archivo de configuración de Claude Desktop:

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

Añade Sketchie bajo mcpServers y luego reinicia 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_..."
      }
    }
  }
}

Tras reiniciar, las herramientas de Sketchie aparecen en el menú de herramientas. Puedes abrir la configuración rápido desde Ajustes, Desarrollador, Editar configuración.

La app de Claude

La aplicación de escritorio de Claude usa el mismo claude_desktop_config.json de arriba. Añade conectores personalizados desde Ajustes, Conectores, Añadir conector personalizado.

El servidor MCP de Sketchie corre como un proceso local (transporte stdio), así que funciona donde Claude pueda lanzar un comando local, es decir Claude Code y la app de escritorio de Claude. Un conector alojado para las apps web y móvil de Claude está en la hoja de ruta. Mientras tanto, la API HTTP, el SDK y la CLI cubren cualquier otro entorno.

Las herramientas

Herramienta	Qué hace
`sketchie_generate_explainer`	Inicia una generación desde `input` (con `length`, `aspect`, `voice` opcionales). Devuelve el registro en cola.
`sketchie_get_explainer`	Obtiene el estado, la URL del vídeo una vez listo y el scene graph editable.
`sketchie_edit_explainer`	Aplica una instrucción en lenguaje natural como un re-render dirigido.
`sketchie_list_explainers`	Lista los explicativos que posee tu clave.
`sketchie_list_voices`	Lista las voces de narración.