你需要能開啟 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
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。然後提出簡單請求，例如工作區晨報。
提示範例
使用自然語言。指派工作時請盡量使用全名或電子郵件，以便選到正確的人。當兩個人同名時
如果兩位同事都叫 Sara，Claude 會詢問你指的是哪一位。它不會編造 ID，也不會默默猜測。 當姓名可能衝突時，請務必在提示中包含全名或電子郵件。目前可用 vs 尚不可用
MCP 支援使用你的 API 金鑰讀取工作區並執行動作（建立、指派、寄送、更新）。客戶聊天回覆尚未透過 MCP 開放——請在 AgencyHandy 中處理這些對話。
相關
- 在應用程式內 Workspace Config → API Key 產生金鑰並複製設定
Latest package on the
1 tag is 1.7.2+. 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.- 套件：npm 上的
agencyhandy-mcp（npx -y agencyhandy-mcp@1）