Konfiguracja Sketchie MCP: Claude Desktop, Claude Code, aplikacja Claude

Sketchie dostarcza serwer MCP, więc dowolny agent obsługujący MCP może generować i edytować filmy objaśniające na tablicy jako natywne narzędzia. Skonfiguruj go w Claude Code, Claude Desktop i aplikacji Claude.

Czego potrzebujesz

  • Klucz API Sketchie (sk_...). Utwórz go w aplikacji w Ustawieniach. Dostęp do API jest zawarty w każdym płatnym planie.
  • Serwer MCP Sketchie. Działa na bun i znajduje się w packages/mcp/src/index.ts w repozytorium Sketchie.

Dwie zmienne środowiskowe konfigurują serwer:

ZmiennaZnaczenieDomyślnie
SKETCHIE_API_KEYTwój klucz API, wysyłany jako token Bearer.unset
SKETCHIE_API_URLPodstawowy URL API, wraz z prefiksem /api.https://sketchie.ai/api

Claude Code

Zarejestruj serwer jedną komendą. Zastąp ścieżkę swoim checkoutem repozytorium 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

Zweryfikuj rejestrację za pomocą claude mcp list. W sesji poproś Claude o wygenerowanie objaśnienia, a wywoła narzędzia Sketchie.

Claude Desktop

Otwórz plik konfiguracyjny Claude Desktop:

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

Dodaj Sketchie pod mcpServers, następnie zrestartuj 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_..."
      }
    }
  }
}

Po restarcie narzędzia Sketchie pojawią się w menu narzędzi. Możesz szybko otworzyć konfigurację z Ustawienia, Deweloper, Edytuj konfigurację.

Aplikacja Claude

Aplikacja desktopowa Claude używa tego samego claude_desktop_config.json co powyżej. Dodaj niestandardowe konektory z Ustawienia, Konektory, Dodaj niestandardowy konektor.

Serwer MCP Sketchie działa jako proces lokalny (transport stdio), więc działa wszędzie tam, gdzie Claude może uruchomić lokalną komendę, czyli Claude Code i aplikacja desktopowa Claude. Hostowany konektor dla aplikacji webowej i mobilnej Claude jest w planach. W międzyczasie HTTP API, SDK i CLI obejmują każde inne środowisko.

Narzędzia

NarzędzieCo robi
sketchie_generate_explainer Rozpoczyna generowanie z input (z opcjonalnymi length, aspect, voice). Zwraca zakolejkowany rekord.
sketchie_get_explainer Pobiera status, URL wideo po jego gotowości oraz edytowalny graf sceny.
sketchie_edit_explainer Stosuje instrukcję w prostym języku jako ukierunkowane ponowne renderowanie.
sketchie_list_explainers Wypisuje objaśnienia posiadane przez twój klucz.
sketchie_list_voices Wypisuje głosy narracji.