浏览用户指南

Claude Code

一键或用一条命令,通过 MCP 把 Claude Code 连接到 Shotomatic,确认它能正常工作,并解决常见的设置问题。

更新日期 2026年11月16日

查看 Markdown
本页内容

Claude Code 可以通过 Shotomatic 的本地 MCP 服务器,在你的 Mac 或 Windows 电脑上使用 Shotomatic。Shotomatic 已用 Claude Code 测试。

一键连接

  1. 打开 Shotomatic,进入设置 > AI 智能体(Command + ,,Windows 上为 Ctrl + ,)。
  2. 在连接智能体下,选择 Claude 旁边的连接。

Shotomatic 会以用户范围替你运行 claude mcp add,所以在任何项目中都能使用 Shotomatic。它还会开启允许 AI 智能体使用 Shotomatic 并批准 Claude Code,因此不会出现批准卡片。开始新的 Claude Code 会话即可载入服务器。

只要装有 Claude Code 或 Claude 应用,列表中就会出现 Claude。点一次连接,会把电脑上已有的那一个或两个都设置好。

手动添加

如果你习惯用命令行,请在设置 > AI 智能体中开启允许 AI 智能体使用 Shotomatic,安装 Node 18.3 或更高版本,然后运行:

claude mcp add --scope user shotomatic -- npx -y shotomatic mcp

不加 --scope user 时,Claude Code 只会把服务器添加到当前项目。用这种方式添加的 Claude Code 首次连接时,Shotomatic 会显示批准卡片,选择允许即可。请参阅批准与确认。

确认能正常工作

在终端中运行 claude mcp list,或在会话中输入 /mcp,查看是否有 shotomatic。然后这样请求:

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

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

看不到工具时

  • /mcp 中没有 shotomatic。 开始新的会话。如果添加时没有加 --scope user,请在同一个项目文件夹中打开 Claude Code。
  • 连接时出现与 claude 命令有关的错误。 在终端中打开一次 Claude Code,让它的命令完成安装,然后再选择连接。
  • “MCP access is turned off.” 在设置 > AI 智能体中开启允许 AI 智能体使用 Shotomatic,然后开始新的会话。
  • 智能体在等待批准。 打开 Shotomatic,在卡片上选择允许。
  • 找不到 npx。 只适用于手动添加的情况。请参阅所有客户端的问题排查列表。

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

Claude Code | 用户指南 | Shotomatic