AppDirect MCP

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

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

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

一个二进制文件即可完成所有有文档记录的 AppDirect 市场操作，还支持离线同步和账单对账关联。可与您现有的 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	如何安装 AppDirect 技能
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 appdirect-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	此连接器重新发布前暂停：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，且您打开的网页可以连接到它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 appdirect-mcp，然后选择 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，之后为 CLI/MCP 二进制文件运行相应的 Skill 安装程序）。请参阅 docs/which-agent.md。

60 秒内完成安装

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

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

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

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

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

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

appdirect-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），并在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：运行 /plugin update appdirect@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/appdirect --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/appdirect --force

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

为 OpenClaw 安装

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

从 https://github.com/servosity/msp-skills/tree/main/skills/appdirect 安装 appdirect 技能。此技能会通过 openclaw: frontmatter 块，说明如何安装其必需的 CLI（appdirect-cli）。

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

身份验证

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

APPDIRECT_CLIENT_ID=<value> APPDIRECT_CLIENT_SECRET=<value> APPDIRECT_OAUTH_SCOPE=<value> appdirect-cli doctor

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

此技能的功能

MSP 常见问题	命令
过去一周内，所有公司的哪些付款失败或停滞了？	appdirect-cli payments unpaid --since 7d --json
月末结算前，哪些处于活跃状态但未开票、已逾期或失败？	appdirect-cli reconcile --since 30d --agent
本周订阅有哪些变化——新增、结束或暂停？	appdirect-cli subs changed --since 7d --json
查看某位客户的完整情况——用户、订阅、发票、商机。	appdirect-cli company show <companyId>
按状态分组后，我的辅助销售渠道是什么情况？	appdirect-cli pipeline --group-by status --agent
哪些未结商机已长期没有进展？	appdirect-cli pipeline stale --days 14 --json
按关键词查找任意公司、订阅、发票或商机。	appdirect-cli search "<text>"
将整个市场拉取到本地镜像，以便离线分析。	appdirect-cli sync

完整命令参考：guide.md。AI Agent 操作规范（--agent、--dry-run，以及何时应在变更前确认）请参阅 AGENTS.md。

与众不同之处

大多数 AppDirect 集成和 MCP 服务都会将每个问题转发为实时 API 调用，并为此重新生成每小时过期的 OAuth 令牌。查询一条记录时，这样做没问题。但当你要查询所有转售商公司中本季度处于活跃状态却从未开票的订阅时，这种方式就无法胜任大规模查询。

此技能会将 AppDirect 同步到支持全文搜索的本地 SQLite 镜像中。汇总类问题只需执行一次本地 SQL 联接：即时、离线，而且 AI 看到的是答案，而非原始数据。reconcile、subs changed 和 company show 等复合命令会联接订阅、发票、付款、公司和商机数据——这是无状态 API 封装器无法做到的。

它解决的痛点

在 r/msp 上，转售 SaaS 的账单对账是一个反复出现的抱怨——“账单对账简直是噩梦”、每月账单调整，以及市场中订阅仍处于有效状态，却从未出现在发票上的订阅导致利润流失。控制台每个屏幕只显示一家公司，因此要发现未开票的订阅、付款失败或停滞的交易，就得手动逐页查看数百家公司的账单。对账工作因此被拖延，利润流失也会在每个月结账时不断累积。

此技能将这些问题变成一条命令：

• appdirect-cli reconcile --since 30d --agent - 查看所有公司的有效订阅（尚未开票）、逾期发票和付款失败情况。
• appdirect-cli payments unpaid --since 7d --json - 将每周追查付款失败的工作汇总为一个排序列表。
• appdirect-cli subs changed --since 7d --json - 查看新增、结束和暂停的订阅，以便审查客户流失情况。
• appdirect-cli company show <companyId> - 查看单个客户的完整情况，为续约做准备。
• appdirect-cli pipeline stale --days 14 --json - 查看已陷入停滞的未结商机。

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

常见问题

这能与 ChatGPT 配合使用吗？

此版本还不行。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 计划；Free 目前尚未开放 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务，这意味着必须以 HTTP 模式运行 AppDirect 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）。这两种方式都不需要编写代码。你只需输入一次 AppDirect 凭据。

我的 AppDirect 数据安全吗？

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

我需要成为 AppDirect 合作伙伴吗？

需要。此技能使用合作伙伴 API 凭据（OAuth2 client_credentials）进行身份验证，适用于你运营或转售产品的市场。它不适用于你无法控制的市场上的终端用户购买。如果你在自己的域名上运营白标市场，可通过 APPDIRECT_BASE_URL 将 CLI 指向该市场。

这会触发 AppDirect API 的速率限制吗？

此工具的设计目的就是避免这种情况。市场 REST API 使用漏桶式速率限制（例如，每个桶允许 20 次请求，并以每秒几次的速度补充）。此技能会同步到本地镜像，并离线回答大多数问题，因此日常查询几乎不会发起实时调用。sync 会遵守限制，你还可以使用 --rate-limit 限制请求速率。

它会取代我的 AppDirect 门户吗？

不会——它是对门户的补充。门户仍然是逐家查看公司的地方；此技能则回答跨公司、月末结账前的账单和销售管线问题，而门户没有相应的界面来处理这些问题。

这要花多少钱？

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

安全模型

各级别根据每条命令实际使用的 HTTP 方法确定，因此，名为 finalize-opportunity 或 upload-and-link-image 的写入操作会被视为写入，而不会被当作读取放行。

级别	示例	建议的 Agent 策略
读取	payments unpaid、reconcile、subs changed、company show、pipeline、search 以及全部 160 多个 GET 端点	允许
写入（常规）	创建/更新公司、用户、成员资格和商机；邀请用户；申请购买；应用折扣；完成商机（总计 118 项）	使用 --dry-run 预览，然后执行经审核的写入
凭证/财务	设置临时密码；创建/更新/设为默认的支付方式或支付工具（总计 7 项）	仅限人在环路中
破坏性操作	删除成员资格、群组、订阅分配或购物车；取消订阅；使开发者账户失效（总计 34 项）	仅限人在环路中

最有力的控制措施是授予 AppDirect 凭证的权限范围——CLI 只能执行凭证允许的操作。完整详情（包括如何限制权限）请参阅 governance.md。

状态

Beta 版。已根据 AppDirect 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-07。