Sketchie MCP 설정: Claude Desktop, Claude Code, Claude 앱
Sketchie는 MCP 서버를 제공하므로 MCP를 지원하는 모든 에이전트가 화이트보드 설명 영상을 네이티브 도구로 생성하고 편집할 수 있습니다. Claude Code, Claude Desktop, Claude 앱에서 설정하세요.
필요한 것
- Sketchie API 키(
sk_...). 앱의 설정에서 생성하세요. API 접근은 모든 유료 플랜에 포함되어 있습니다. - Sketchie MCP 서버. bun에서 실행되며 Sketchie 저장소의
packages/mcp/src/index.ts에 있습니다.
두 개의 환경 변수가 서버를 구성합니다:
| 변수 | 의미 | 기본값 |
|---|---|---|
SKETCHIE_API_KEY | Bearer 토큰으로 전송되는 API 키. | unset |
SKETCHIE_API_URL | /api 접두사를 포함한 API 기본 URL. | https://sketchie.ai/api |
Claude Code
한 번의 명령으로 서버를 등록하세요. 경로를 Sketchie 저장소의 체크아웃으로 바꾸세요.
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 claude mcp list로 등록을 확인하세요. 세션에서 Claude에게 설명 영상 생성을 요청하면 Sketchie 도구를 호출합니다.
Claude Desktop
Claude Desktop 설정 파일을 여세요:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
mcpServers 아래에 Sketchie를 추가한 다음 Claude Desktop을 재시작하세요:
{
"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_..."
}
}
}
} 재시작 후 Sketchie 도구가 도구 메뉴에 나타납니다. 설정, 개발자, 설정 편집에서 빠르게 설정을 열 수 있습니다.
Claude 앱
Claude 데스크톱 애플리케이션은 위와 동일한 claude_desktop_config.json을 사용합니다. 설정, 커넥터, 사용자 지정 커넥터 추가에서 사용자 지정 커넥터를 추가하세요.
Sketchie MCP 서버는 로컬 프로세스(stdio 전송)로 실행되므로 Claude가 로컬 명령을 실행할 수 있는 곳이면 어디서나 작동합니다. 이는 Claude Code와 Claude 데스크톱 앱입니다. Claude 웹 및 모바일 앱을 위한 호스팅된 커넥터는 로드맵에 있습니다. 그동안 HTTP API, SDK 및 CLI가 다른 모든 환경을 커버합니다.
도구
| 도구 | 기능 |
|---|---|
sketchie_generate_explainer | input에서 생성을 시작합니다(선택적 length, aspect, voice 포함). 대기 중인 레코드를 반환합니다. |
sketchie_get_explainer | 상태, 준비되면 영상 URL, 편집 가능한 씬 그래프를 가져옵니다. |
sketchie_edit_explainer | 평이한 언어 지시를 대상 재렌더링으로 적용합니다. |
sketchie_list_explainers | 당신의 키가 소유한 설명 영상을 나열합니다. |
sketchie_list_voices | 내레이션 음성을 나열합니다. |