兩種連接方式
兩種方式使用同一組工作區 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。然後提出簡單請求,例如工作區晨報。
連接雲端代理(託管伺服器)
如果你的代理執行在無法安裝套件的環境中——Cloudflare Workers、Vercel 函式、n8n,或託管的 Claude、Cursor——請將它指向我們為你託管的 MCP 伺服器:mcp-remote 轉接:
位址是根路徑 ——
https://mcp.agencyhandy.com/,而不是 /mcp。要確認伺服器可連線,請開啟 https://mcp.agencyhandy.com/health。提示範例
使用自然語言。指派工作時請盡量使用全名或電子郵件,以便選到正確的人。當兩個人同名時
如果兩位同事都叫 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)

