接入 Claude Desktop

章节正在完善中

本页详细内容正在撰写。MCP 概览见 什么是 MCP。

前置

• 已安装 AgileShot V1.2+
• 已安装 Claude Desktop(Mac / Windows)
• 知道 agileshot.exe 的绝对路径

配置步骤

1. 找到 Claude Desktop 配置文件

平台	路径
Windows	%APPDATA%\Claude\claude_desktop_config.json
macOS	~/Library/Application Support/Claude/claude_desktop_config.json

如果文件不存在,新建即可。

2. 添加 AgileShot MCP Server

打开配置文件,加入以下内容(Windows 示例):

{
  "mcpServers": {
    "agileshot": {
      "command": "C:\\Program Files\\AgileShot\\agileshot.exe",
      "args": ["--mcp-server"]
    }
  }
}

便携版示例:

{
  "mcpServers": {
    "agileshot": {
      "command": "D:\\Tools\\AgileShot\\agileshot.exe",
      "args": ["--mcp-server"]
    }
  }
}

JSON 转义

Windows 路径里的反斜杠 \ 在 JSON 中必须双写为 \\。否则 Claude Desktop 会启动失败。

3. 重启 Claude Desktop

完全退出(托盘右键 → Quit,不是关窗口)→ 重新打开。

4. 验证

在 Claude Desktop 对话框右下角应该看到 🔌 🛠️ icons → 点击展开应有 agileshot 工具列表(9 个工具)。

试一句: "截一下我现在的活动窗口" → Claude 应自动调用 screenshot_active_window。

故障排查

问题	原因 / 解决
工具列表里没有 agileshot	1) 配置文件 JSON 语法错误 → 用 jsonlint.com 校验 2) command 路径不对 → 用绝对路径,反斜杠双写 3) Claude 没完全退出 → 托盘右键 Quit
调用工具时报错 "spawn failed"	agileshot.exe 不可执行或不存在,核对路径
Claude 说"我看不到任何屏幕内容"	工具调用成功但图传输失败 → 查看 Claude Desktop 日志 (%APPDATA%\Claude\logs\)
截图但是黑屏	AgileShot 当前是远程桌面环境 / 安全软件拦截了截屏 API

---

完整内容陆续补充。