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