跳轉到主要內容
AgencyHandy 的 MCP 連線讓你用自然語言與 Claude 或 Cursor 對話,並在 AgencyHandy 工作區執行日常工作——無需自己開啟每一個畫面。 控制權始終在你。Claude 與 Cursor 只會使用你產生的工作區 API 金鑰操作,並在姓名符合多人時請你確認。

兩種連接方式

兩種方式使用同一組工作區 API 金鑰,並為代理提供相同的工具。
你需要能開啟 Workspace Config 並管理 API keys 的角色(通常是 SuperAdmin 或 Admin)。本地方式還需要在執行 Claude Desktop 或 Cursor 的電腦上安裝 Node.js 20+;託管伺服器則完全無需安裝。

需求

npm 上的 MCP 套件名稱為 agencyhandy-mcp。Claude 與 Cursor 透過 npx -y agencyhandy-mcp@1 執行它。

設定 Claude 或 Cursor MCP

當 Claude Desktop 或 Cursor 在你自己的電腦上執行時,請用這種方式。若代理在雲端執行,請直接跳到 連接雲端代理。
1

開啟 Workspace Config

在 AgencyHandy 中開啟 Workspace Config(公司設定),然後前往 API Key 分頁。
2

產生工作區 API 金鑰

建立新的工作區 API 金鑰(或使用已儲存的金鑰)。出現時請立即複製——之後 AgencyHandy 無法再次顯示完整金鑰。
3

複製 MCP 設定

在同一 API Key 分頁中,使用 Claude / Cursor MCP 設定面板。點擊 Copy MCP config,讓 JSON 包含你的金鑰與後端 URL。
4

貼到 Cursor 或 Claude Desktop

將設定貼到:
  • Cursor:專案或使用者 .mcp.json
  • Claude Desktop:claude_desktop_config.json
保留產生的 npx -y agencyhandy-mcp@1 指令與 API 金鑰。
5

重新啟動並試試提示

完全結束並重新開啟 Cursor 或 Claude Desktop。然後提出簡單請求,例如工作區晨報。
若 Claude 或 Cursor 找不到 MCP 伺服器,請確認已安裝 Node.js 20+,並在儲存設定後重新啟動應用程式。

連接雲端代理(託管伺服器)

如果你的代理執行在無法安裝套件的環境中——Cloudflare Workers、Vercel 函式、n8n,或託管的 Claude、Cursor——請將它指向我們為你託管的 MCP 伺服器:
無需安裝,也不必維護伺服器。用同一組工作區 API 金鑰作為 bearer token 驗證每個請求。工作區會從金鑰中讀取,因此每位使用者都用自己的金鑰連線。 Cursor、Claude Code,以及任何可傳送自訂標頭的主機:
Claude Desktop 無法傳送自訂標頭,請用 mcp-remote 轉接:
命令列中的 Claude Code:
位址是根路徑 —— https://mcp.agencyhandy.com/,而不是 /mcp。要確認伺服器可連線,請開啟 https://mcp.agencyhandy.com/health。
如果你改為以 HTTP API 自建整合,請在請求中送出 User-Agent 標頭。包括 Cloudflare Workers 的 fetch() 在內,有些執行環境預設不會送出,缺少它的請求會在抵達 API 之前被拒絕。

提示範例

使用自然語言。指派工作時請盡量使用全名或電子郵件,以便選到正確的人。

當兩個人同名時

如果兩位同事都叫 Sara,Claude 會詢問你指的是哪一位。它不會編造 ID,也不會默默猜測。 當姓名可能衝突時,請務必在提示中包含全名或電子郵件。

客戶點數、訂單表單瀏覽與客戶公司

已於 agencyhandy-mcp@1.17.0 推出。應用程式內助理 Handy 也使用這些工具。 提示範例
  • 「以每小時 120 點,從 Elizabeth 的點數中扣除 2 小時的行銷工作。」
  • 「每月 1 日給 Acme 360 點,補足至 360。」
  • 「哪些訂單表單還沒有人開啟過?」
  • 「將合作夥伴加入 Apple 和 Samsung 這兩個客戶公司。」
在 Handy 中,增加或扣除點數以及設定每月點數一律需要等待您的核准,且只有 超級管理員 或 管理員 可以核准。點數變更無法在聊天中復原;Handy 會改為提議進行反向調整。

目前可用 vs 尚不可用

MCP 支援使用你的 API 金鑰讀取工作區並執行動作(建立、指派、寄送、更新)。客戶聊天回覆尚未透過 MCP 開放——請在 AgencyHandy 中處理這些對話。

相關

  • 在應用程式內 Workspace Config → API Key 產生金鑰並複製設定
Latest package on the 1 tag is 1.17.0. Claude can read ah://api-context (also inside ah://full-context) for API path gotchas: leads, projects/orders, tasks, comments, labels, clients, invoices, vouchers, and forms.
  • 供雲端代理使用的託管伺服器:https://mcp.agencyhandy.com/(健康檢查在 /health)
  • 套件:npm 上的 agencyhandy-mcp(npx -y agencyhandy-mcp@1)