Autotask MCP

Autotask + AI - 适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini，以及任何支持 MCP 的 Agent

非官方。由社区构建的 Claude Code Skill 和 Autotask API MCP 服务。与 Datto, Inc. 无关联，未获其认可或赞助。

_{▶ 观看 30 秒演示 - 演示数据为模拟数据；展示的每条命令都存在于真实的 CLI 中。}

在命令行中使用每个 Autotask 实体，另有本地 SQLite 镜像，可解答其他 Autotask 工具都无法回答的工单账龄、工作量、未开票工时和账户全景问题。可与您现有的 AI 配合使用 - ChatGPT（Plus/Pro+，此连接器重新发布前暂停；请参阅 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot - 还可通过远程方式搭配 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini。免费、开源，可在您的笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

安全提示（此连接器重新发布前）。 请勿运行 HTTP 模式 （--transport http），即使是在 localhost 上也不行。此版本没有密码， 会监听所有网络接口，且早于浏览器重绑定防护， 因此您打开的网页可以访问它。MCP 工具还可以使用您的凭据进行更改。 请使用默认的 stdio 传输。如果您为远程 Agent 设置了隧道， 请关闭它。修复即将推出。

MSP 所有者实际使用的六种 Agent（可自行设置，现已可用）：

您的 AI Agent	如何安装 Autotask skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 autotask-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	此连接器重新发布前暂停：ChatGPT 需要其 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，将 autotask-mcp 添加到 mcp.json 的 servers 键下，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，这意味着需要使用此连接器的 HTTP 模式；该模式在连接器重新发布前暂停：此版本的该模式无需密码，会监听所有网络接口，且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。

Microsoft 和 Google 技术栈也适用

用户基数庞大，但先坦诚说明：这些属于远程 / 企业方案，而不是你刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停使用，直到重新发布此连接器：Copilot Studio 需要使用 HTTP 模式，而在此版本中，该模式无需密码、会监听所有网络接口，并且可以被你打开的网页访问。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 是本地运行的，与 Claude Code 相同。Gemini app 则是远程应用，需要使用与 ChatGPT 相同的、目前暂停使用的 HTTP 模式。请参阅 mcp-install.md。

原生支持 Skill 的 Agent（也已涵盖）： Hermes 和 OpenClaw 可直接读取此 Skill 的 SKILL.md，也支持 MCP——请参阅下文的安装说明。通过 MCP 也支持 Cursor、Windsurf、Cline、Continue.dev 和 Zed。各工具的完整配置方法：docs/which-agent.md。

要运行多个 Agent？ 使用一条命令即可为所有 51+ 个受支持的 Agent 安装：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后运行相应 Skill 的安装程序来安装 CLI/MCP 二进制文件）。请参阅 docs/which-agent.md。

60 秒内完成安装

Claude Desktop 的最快方式——一键安装 .mcpb

Claude Desktop 安装包： .mcpb 可在 macOS（Intel 和 Apple Silicon）、Windows x64 和 Linux x64 上启动。每个工具都会调用配套的 autotask-cli。自 2026-09-18 起发布的版本会在安装包中附带该 CLI；较旧的安装包仅包含 MCP 服务，因此，如果你的安装包缺少配套组件，请先运行下方的路径 A 或路径 B 安装程序（或将 AUTOTASK_CLI_PATH 设置为现有二进制文件的路径）。详情：#331。

下载 Autotask MCP (.mcpb)——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON，无需命令行。（在发布页面浏览所有 Autotask 版本。）

更喜欢 Claude Code 插件？添加一次市场，然后安装——立即可用，无需列出目录：

/plugin marketplace add Servosity/msp-skills
/plugin install autotask@msp-skills

路径 A——向 AI Agent 粘贴一条提示词（推荐）

将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork 中：

在此 Agent 工作区中安装 Servosity/msp-skills 提供的 Autotask Skill 和 MCP 服务。如果此工作区使用 POSIX shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/autotask/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/autotask/install.ps1 | iex。然后按照 README 完成身份验证，并运行 autotask-cli --help 进行探索。

任何能够运行 shell 的 Agent 都可以使用相同的提示词。

路径 B——自行运行安装程序

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/autotask/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/autotask/install.sh)

安装程序会将 autotask-cli（CLI）和 autotask-mcp（MCP 服务）安装到用户的 bin 路径中。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 发现 Skill。

验证：

autotask-cli --version

升级到最新版本

安装程序始终会获取当前版本——重新运行即可升级：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/autotask/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/autotask/install.ps1 | iex

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），并在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：/plugin update autotask@msp-skills。

添加到 Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot 或其他 MCP 客户端

安装程序运行后，请参阅 mcp-install.md 和 docs/which-agent.md，了解各 Agent 的接入方式——每个 Agent 都有单独的章节，其中包括 GitHub Copilot 的 servers 键，以及 Microsoft 365 Copilot / Copilot Studio 的远程接入方式。Claude Desktop 的 Settings > Extensions 面板是最简单的方式；对于偏好编辑 JSON 的用户，mcp-install.md 中提供了 MCP 配置块。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/autotask --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/autotask --force

Hermes 原生支持 MCP，因此也可以直接使用 autotask-mcp 服务——安装方式相同，环境变量也相同。

为 OpenClaw 安装

告诉你的 OpenClaw Agent（复制以下内容）：

从 https://github.com/servosity/msp-skills/tree/main/skills/autotask 安装 autotask 技能。该技能定义了如何通过 openclaw: frontmatter 块安装所需的 CLI（autotask-cli）。

OpenClaw 尚未正式推出；frontmatter 接入配置已预先提供，并将在 OpenClaw 发布时立即启用。

进行身份验证

设置 CLI 所需的凭据（从你的 Autotask 门户获取）：

AUTOTASK_PSA_API_INTEGRATION_CODE=<value> AUTOTASK_PSA_SECRET=<value> AUTOTASK_PSA_USER_NAME=<value> autotask-cli doctor

在运行任何会访问数据的操作之前，doctor 会确认凭据是否有效。即使凭据被拒绝，它也会以退出码 0 退出，因此脚本应添加 --fail-on error。

此技能的功能

MSP 常见问题	命令
哪些已批准的工时条目尚未开具发票？	autotask-cli unbilled
服务台目前的积压情况有多严重？按积压时长分组查看。	autotask-cli ticket-aging
哪些未关闭工单已经一周无人处理？	autotask-cli stale --days 7
哪些未分配工单应由调度员优先处理？	autotask-cli triage
在分配下一个工单之前，谁的工作量已经过载？	autotask-cli workload
我们的包时合同消耗了多少？何时会用完？	autotask-cli retainer
一次查看某家公司的所有已知信息？	autotask-cli company-360 "1234"
用一张表查看月末账单情况？	autotask-cli reconcile
某个下拉列表字段的标签与 ID 对照表是什么？	autotask-cli picklist "Tickets" "status"

完整命令参考：guide.md。AI Agent 操作约定（--agent、--dry-run，以及何时应在执行修改前确认）请参阅 AGENTS.md。

有何不同

大多数 Autotask 集成和 MCP 服务都会将每个问题转发为实时 API 调用。对于单条记录，这样做没问题。但规模一大就行不通了，例如你询问“本月所有客户中有多少已批准工时尚未开票”，或“哪些保留服务将在下一次续约前到期”时——每个问题都需要针对每个租户的区域 URL 发起多次 API 调用；每个分类筛选都受限于各实例各不相同的整数下拉列表 ID；而所有调用都会消耗每小时 API 请求额度。

此技能会将 Autotask 同步到带有全文搜索的本地 SQLite 镜像中。汇总类问题只需执行一次本地 SQL 联接：即时、离线，AI 看到的是答案，而不是原始数据。reconcile、retainer 和 company-360 等复合命令可跨工单、工时条目、合同、发票和资源进行联接——这是无状态 API 封装器无法做到的。

它解决的痛点

问任何一位 MSP 老板，Autotask 哪些地方最让人头疼，答案总是两个：永远无法计费的时间，以及必须先导出的报表。技术人员关闭工单时没有录入工时，或已批准的工时始终没有出现在发票上，直到开始结算时才有人发现——因为 Autotask 没有一个页面能将已批准工时与对应的发票关联起来。而当你需要查看跨对象的全貌时，Autotask 原生的 LiveReports 是一个需要复制和编辑的报表设计器，输出格式为 Excel、PDF、RTF 或 CSV（据 Kaseya 自己的 Autotask PSA 报表帮助文档所述）——因此，任何将工单、工时和合同关联起来的需求都会被推给 Power BI 或其他 BI 工具。正因为如此，才会出现整个第三方连接器市场。

这项技能可以直接从数据所在之处回答这些问题——只需一次离线查询，无需创建报表，也无需使用电子表格：

痛点	命令
已批准工时悄悄从发票中漏掉	autotask-cli unbilled
月末核对工时、合同和发票	autotask-cli reconcile
预付费金额悄悄变为负数	autotask-cli retainer
查看某位客户的完整情况以供审查	autotask-cli company-360 "1234"
状态和优先级显示为含义不明的整数 ID	autotask-cli picklist "Tickets" "status"

详见 pain-point.md，了解更完整的背景。

常见问题

这适用于 ChatGPT 吗？

当前版本不适用。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 计划；Free 目前尚未开放 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务，这意味着需要以 HTTP 模式运行 Autotask MCP 服务。当前版本的 HTTP 模式无需密码，会监听所有网络接口，并且可以通过你打开的网页访问，因此在连接器重新发布之前，请勿运行它或将其置于隧道后；mcp-install.md 中的安全说明解释了原因。在此之前，请使用 Claude Desktop、Claude Code 或 Codex。

这适用于 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 吗？

适用——它们都支持 MCP。跨工具安装命令见上方对照表，深入说明见 docs/which-agent.md。

我需要懂编程吗？

不需要。推荐的安装方式是在 Claude Code 或 Codex 中粘贴一句话——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是按操作系统使用一行安装命令（bash 或 PowerShell）。两种方式都不需要编写代码。你只需输入一次 Autotask 凭据。

我的 Autotask 数据安全吗？

你的数据会留在自己的计算机上。CLI 和 MCP 服务都是本地二进制文件。SQLite 镜像存储在你用户帐户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而不是原始批量数据。凭据从你的环境或 Agent 配置中读取；MSP Skills 不会将其打包到此存储库中，也不会在任何地方传输。

我需要哪些凭据？

你需要在自己的 Autotask 实例中创建一个仅限 API 的用户，以获取 UserName 和 Secret，还需要从集成供应商记录中获取用于跟踪的 Integration Code。请在环境中设置 AUTOTASK_PSA_USER_NAME、AUTOTASK_PSA_SECRET 和 AUTOTASK_PSA_API_INTEGRATION_CODE。API 用户的安全级别是真正的权限边界——请将其范围严格限制为你希望 AI 访问的内容。

我需要自己查找 Autotask 区域 URL 吗？

不需要。Autotask 会将每个租户托管在编号区域（webservicesN.autotask.net）中。运行一次 autotask-cli zone，CLI 就会发现并缓存你的租户基本 URL——这与 Autotask 自己的文档要求集成首先发出的区域信息请求相同。

这会触及我的 Autotask API 速率限制吗？

Autotask 按数据库统计滚动 60 分钟窗口内的 API 调用次数，接近阈值时会增加延迟。设置本地镜像是为了让读取操作不再调用 API：完成首次同步后，跨实体视图（unbilled、reconcile、retainer、company-360、ticket-aging、triage、workload）会通过本地 SQLite 运行，不产生任何 API 调用；同步是增量式的——只获取自上次检查点以来发生变化的内容。

这是 Datto Autotask PSA，还是只是 Autotask？

是同一款产品。Autotask PSA 现在由 Kaseya 以 Datto Autotask PSA 为品牌；此技能针对的是 Autotask REST API，这两个名称指的都是它。它不涵盖 Datto RMM——那是另一款使用独立 API 的产品。

费用是多少？

免费。采用 Apache-2.0 许可。你只需为所使用的 AI Agent（Claude、ChatGPT、Codex 等）付费，费用由你的 AI 提供商收取，而非我们。

安全模型

层级	示例	建议的 Agent 策略
读取	autotask-cli triage、autotask-cli unbilled、autotask-cli company-360 "1234"、autotask-cli search "vpn outage"、autotask-cli tickets query	允许
写入（常规）	autotask-cli tickets create-entity、autotask-cli tickets patch-entity、autotask-cli time-entries create-entity、autotask-cli companies update-entity - 写入会立即发送；--dry-run 是可选择启用的预览模式，并非默认行为	先使用 --dry-run 预览，再经审核后写入
破坏性操作／配置	autotask-cli time-entries delete-entity、autotask-cli service-calls delete-entity "1234"、autotask-cli contact-groups delete-entity "1234"	仅限人工参与

最重要的控制措施是你授予 Autotask 凭据的权限范围——CLI 只能执行凭据获准执行的操作。完整详情（包括如何限制权限）请参阅 governance.md。

状态

Beta 版。已针对 Autotask API 功能进行验证，目前正通过每周的 Build Sessions，与在自己的生产租户中运行该工具的 MSP 一起进行验证。请在 compoundingteams.com/build-sessions RSVP。

---

标准。 符合开源的 Agent Skills 规范（Anthropic，2025 年 12 月；适用于 40 多种 Agent）。兼容 MCP - 可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。已为 OpenClaw 做好准备（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可。使用 CLI Printing Press 构建。最后更新：2026-06-06。