Zed
把 Shotomatic 作为本地 MCP 服务器添加到 Zed,确认它能正常工作,并解决常见的设置问题。
更新日期 2026年11月16日
Zed 可以通过 Shotomatic 的本地 MCP 服务器使用 Shotomatic。以下步骤依据 Zed 自己的文档(Model Context Protocol in Zed);Shotomatic 已用 Claude Code 和 Codex 测试,没有在 Zed 上测试过。如果菜单或文件与实际不符,请查看 Zed 的文档。
开始之前
- 在 Shotomatic 中打开设置 > AI 智能体,开启允许 AI 智能体使用 Shotomatic。
- 安装 Node 18.3 或更高版本。客户端会用
npx启动一个名为shotomatic的小型桥接包,不需要 API 密钥。 - 在 Mac 上授予屏幕录制权限,需要按键时还要授予辅助功能权限。请参阅 macOS 权限。
将 Shotomatic 添加到 Zed
Zed 把它们称为 context server,并使用 context_servers。在 Command Palette 中运行 zed: open settings file,然后添加:
{
"context_servers": {
"shotomatic": {
"command": "npx",
"args": ["-y", "shotomatic", "mcp"],
"env": {}
}
}
}
Zed 默认会在调用工具前询问。
如果 Windows 上的客户端无法启动 npx,请把命令设为 cmd,参数设为 /c、npx、-y、shotomatic、mcp。
批准一次
Zed 首次连接时,Shotomatic 会以客户端报告的名称显示批准卡片。选择允许即可。批准之前,智能体只能读取 Shotomatic 的状态。请参阅批准与确认。
确认能正常工作
打开 Settings > AI > MCP Servers:带有提示“Server is active”的绿点表示已连接。然后这样请求:
“检查 Shotomatic 的状态,并告诉我你能用它做什么。”
设置正确时,智能体会回复 Shotomatic 版本、Mac 上是否已授予屏幕录制和辅助功能权限、你的版本以及今天还能使用的免费截图数、网页浏览器是否已安装,以及正在运行的截图任务。
Shotomatic 会把预览作为图片放在工具结果中返回。Zed 的文档没有说明这些图片是否会传给模型,因此智能体可能只收到文字。
看不到工具时
- 没有绿点。 检查条目是否位于
context_servers下,而不是mcpServers下。 - “MCP access is turned off.” 在设置 > AI 智能体中开启允许 AI 智能体使用 Shotomatic,然后重启客户端。
- 没有出现批准卡片。 打开 Shotomatic 查看卡片;在 Mac 上,卡片出现时 Dock 图标会跳动。
- 客户端找不到
npx或 Node。 请参阅所有客户端的问题排查列表。