浏览用户指南

VS Code 与 GitHub Copilot

把 Shotomatic 作为本地 MCP 服务器添加到 VS Code 与 GitHub Copilot,确认它能正常工作,并解决常见的设置问题。

更新日期 2026年11月16日

查看 Markdown
本页内容

VS Code 与 GitHub Copilot 可以通过 Shotomatic 的本地 MCP 服务器使用 Shotomatic。以下步骤依据 VS Code 与 GitHub Copilot 自己的文档(MCP configuration reference 和 Manage MCP servers);Shotomatic 已用 Claude Code 和 Codex 测试,没有在 VS Code 与 GitHub Copilot 上测试过。如果菜单或文件与实际不符,请查看 VS Code 与 GitHub Copilot 的文档。

开始之前

  • 在 Shotomatic 中打开设置 > AI 智能体,开启允许 AI 智能体使用 Shotomatic。
  • 安装 Node 18.3 或更高版本。客户端会用 npx 启动一个名为 shotomatic 的小型桥接包,不需要 API 密钥。
  • 在 Mac 上授予屏幕录制权限,需要按键时还要授予辅助功能权限。请参阅 macOS 权限。

将 Shotomatic 添加到 VS Code 与 GitHub Copilot

VS Code 使用 servers 而不是 mcpServers,并且必须有 type。把下面的内容添加到工作区的 .vscode/mcp.json:

{
  "servers": {
    "shotomatic": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}

如果想改为添加到用户配置文件,请运行:

code --add-mcp '{"name":"shotomatic","type":"stdio","command":"npx","args":["-y","shotomatic","mcp"]}'

VS Code 首次启动服务器时,可能会请你确认信任该服务器。

如果 Windows 上的客户端无法启动 npx,请把命令设为 cmd,参数设为 /c、npx、-y、shotomatic、mcp。

批准一次

VS Code 与 GitHub Copilot 首次连接时,Shotomatic 会以客户端报告的名称显示批准卡片。选择允许即可。批准之前,智能体只能读取 Shotomatic 的状态。请参阅批准与确认。

确认能正常工作

在 Command Palette 中运行 MCP: List Servers,可以查看服务器并启动或重启它。然后这样请求:

“检查 Shotomatic 的状态,并告诉我你能用它做什么。”

设置正确时,智能体会回复 Shotomatic 版本、Mac 上是否已授予屏幕录制和辅助功能权限、你的版本以及今天还能使用的免费截图数、网页浏览器是否已安装,以及正在运行的截图任务。

Shotomatic 会把预览作为图片放在工具结果中返回。VS Code 与 GitHub Copilot 的文档没有说明这些图片是否会传给模型,因此智能体可能只收到文字。

看不到工具时

  • 服务器被忽略。 检查条目是否位于 servers 下,并且包含 "type": "stdio"。
  • “MCP access is turned off.” 在设置 > AI 智能体中开启允许 AI 智能体使用 Shotomatic,然后重启客户端。
  • 没有出现批准卡片。 打开 Shotomatic 查看卡片;在 Mac 上,卡片出现时 Dock 图标会跳动。
  • 客户端找不到 npx 或 Node。 请参阅所有客户端的问题排查列表。

接下来可以试试智能体能做什么中的请求,或在工具参考中查看所有工具。

VS Code 与 GitHub Copilot | 用户指南 | Shotomatic