Agency Handy

Agency Handy MCP 服务

将 AI 助手连接到你的 Agency Handy 工作区。你可以通过 Claude、Cursor、VS Code、Cline 和其他 MCP 客户端，查询客户、潜在客户、项目、任务、工单、发票和提案，也可以创建和更新这些内容。

该服务由 Agency Handy 托管。此代码库包含连接说明和注册信息；你无需自行安装或运行任何内容。

端点	https://mcp.agencyhandy.com/（Streamable HTTP，POST /）
身份验证	使用 Agency Handy 登录（OAuth 2.1、PKCE、动态客户端注册），或通过 Authorization: Bearer <key> 发送工作区 API 密钥
注册表	Official MCP Registry 中的 com.agencyhandy/mcp
文档	docs.agencyhandy.com

如何连接

使用 Agency Handy 登录（推荐）。 在助手中添加服务 URL，即可打开 Agency Handy 窗口。输入你的工作区，登录后选择工作区并点击 Allow。无需复制或粘贴。每个连接都会显示在 Agency Handy 的 Settings → Workspace Config → API Key 下，你可以随时将其移除。

或使用 API 密钥。 对于不支持 OAuth 的工具，请在 Settings → Workspace Config → API Key 中生成密钥，并通过 Authorization: Bearer YOUR_API_KEY 发送。该密钥会以你的身份，在一个工作区中使用你所在角色的权限。

设置客户端

Claude（claude.ai 和 Claude Desktop）

前往 Settings → Connectors → Add custom connector（在 claude.ai 上：Customize → Connectors → Add）。名称填写 Agency Handy，URL 填写 https://mcp.agencyhandy.com/，然后点击 Connect 并登录。

ChatGPT

在开发者模式下：前往 Settings → Apps & Connectors → Create。URL 填写 https://mcp.agencyhandy.com/，身份验证选择 OAuth，然后使用 Agency Handy 登录。

Claude Code

安装插件。插件还会添加一个使用技巧，并要求你在向客户发送任何内容或删除内容之前进行确认：

/plugin marketplace add AgencyHandy/claude-plugins
/plugin install agencyhandy@agencyhandy

或者直接添加服务，然后运行 /mcp 并选择 Authenticate：

claude mcp add --transport http agencyhandy https://mcp.agencyhandy.com/

若改用 API 密钥：claude mcp add --transport http agencyhandy https://mcp.agencyhandy.com/ --header "Authorization: Bearer YOUR_API_KEY"

Cursor

在 ~/.cursor/mcp.json 中配置，然后在 Cursor 的 MCP 设置中点击服务旁边的 Login：

{
  "mcpServers": {
    "agencyhandy": { "url": "https://mcp.agencyhandy.com/" }
  }
}

若改用 API 密钥，请添加 "headers": { "Authorization": "Bearer YOUR_API_KEY" }。

VS Code（GitHub Copilot）

配置 .vscode/mcp.json。服务启动时，VS Code 会提示你登录：

{
  "servers": {
    "agencyhandy": { "type": "http", "url": "https://mcp.agencyhandy.com/" }
  }
}

Cline 和其他仅支持 stdio 的客户端

{
  "mcpServers": {
    "agencyhandy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.agencyhandy.com/"]
    }
  }
}

mcp-remote 会在浏览器中打开登录页面。若改用 API 密钥，请将 "--header", "Authorization: Bearer ${AGENCYHANDY_API_KEY}" 添加到 args，并在 env 中设置 AGENCYHANDY_API_KEY。

功能

约 100 个工具，名称均以 ah_ 开头：

• **读取：**客户、潜在客户、客户公司、项目及其任务、工单、评论、工时记录、发票、提案、订单、订阅、服务、表单、自定义字段、Webhook、聊天。
• 所有者洞察：ah_dashboard_digest、ah_cash_risk（逾期和有风险的发票）、ah_client_churn_risk。
• **写入：**创建和更新潜在客户、客户、任务、工单、评论、发票、提案、订单和服务；分配工作并更改状态。
• 发送：ah_invoice_send、ah_proposal_send 和 ah_client_invite 可向客户发送电子邮件。

使用 ah_health 开始会话，并读取 ah://full-context 资源以了解数据模型。

安全

所有操作都以连接者的权限运行，并且仅限于其选择的一个工作区。发送邮件或删除数据的工具会更改真实的客户数据，因此请在确认前检查助手提出的操作。Claude Code 插件始终会在执行这些操作前征求确认。登录页面会在应用未经验证时发出警告，并始终显示将把你重定向到何处。

托管服务不会存储你的工作区数据。它会保留简短的请求日志（工具、时间、成员和工作区 ID、IP 地址，以及移除密钥后的错误信息），最长 14 天。请参阅隐私政策。

支持

agencyhandy.com/contact-us · [email protected]