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 | 你的 API 密钥,作为 Bearer 令牌发送。 | unset |
SKETCHIE_API_URL | API 基础 URL,包含 /api 前缀。 | 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 | 列出旁白语音。 |