連接 Claude 和 Cursor，透過 MCP 操作 AgencyHandy

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

兩種連接方式

代理執行位置	連接方式	設定
在你的電腦上 — Claude Desktop 或 Cursor	由應用程式啟動的 `agencyhandy-mcp` 套件	見下方設定 Claude 或 Cursor MCP — 需要 Node.js 20+
在雲端 — Cloudflare Workers、Vercel、n8n、託管的 Claude 或 Cursor	我們託管的 MCP 伺服器 `https://mcp.agencyhandy.com/`	見下方連接雲端代理 — 無需安裝

兩種方式使用同一組工作區 API 金鑰，並為代理提供相同的工具。

你需要能開啟 Workspace Config 並管理 API keys 的角色（通常是 SuperAdmin 或 Admin）。本地方式還需要在執行 Claude Desktop 或 Cursor 的電腦上安裝 Node.js 20+；託管伺服器則完全無需安裝。

需求

需求	細節
AgencyHandy 工作區	可存取 Workspace Config → API Key
一個 MCP 主機	電腦上的 Claude Desktop 或 Cursor，或任何能透過 HTTP 呼叫 MCP 伺服器的代理
Node.js (僅本地方式)	版本 20 或以上（用 `node -v` 檢查）
MCP 套件 (僅本地方式)	`npx -y agencyhandy-mcp@1`（`1` 標籤提供 1.7.2+）

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

設定 Claude 或 Cursor MCP

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

開啟 Workspace Config

在 AgencyHandy 中開啟 Workspace Config（公司設定），然後前往 API Key 分頁。

產生工作區 API 金鑰

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

複製 MCP 設定

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

貼到 Cursor 或 Claude Desktop

將設定貼到：

Cursor：專案或使用者 .mcp.json
Claude Desktop：claude_desktop_config.json

保留產生的 npx -y agencyhandy-mcp@1 指令與 API 金鑰。

重新啟動並試試提示

完全結束並重新開啟 Cursor 或 Claude Desktop。然後提出簡單請求，例如工作區晨報。

若 Claude 或 Cursor 找不到 MCP 伺服器，請確認已安裝 Node.js 20+，並在儲存設定後重新啟動應用程式。

連接雲端代理（託管伺服器）

如果你的代理執行在無法安裝套件的環境中——Cloudflare Workers、Vercel 函式、n8n，或託管的 Claude、Cursor——請將它指向我們為你託管的 MCP 伺服器：

https://mcp.agencyhandy.com/

無需安裝，也不必維護伺服器。用同一組工作區 API 金鑰作為 bearer token 驗證每個請求。工作區會從金鑰中讀取，因此每位使用者都用自己的金鑰連線。 Cursor、Claude Code，以及任何可傳送自訂標頭的主機：

{
  "mcpServers": {
    "agency-handy": {
      "url": "https://mcp.agencyhandy.com/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop 無法傳送自訂標頭，請用 mcp-remote 轉接：

{
  "mcpServers": {
    "agency-handy": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.agencyhandy.com/",
        "--header", "Authorization:Bearer YOUR_API_KEY"
      ]
    }
  }
}

命令列中的 Claude Code：

claude mcp add agency-handy --transport http https://mcp.agencyhandy.com/ \
  --header "Authorization: Bearer YOUR_API_KEY"

位址是根路徑 —— https://mcp.agencyhandy.com/，而不是 /mcp。要確認伺服器可連線，請開啟 https://mcp.agencyhandy.com/health。

如果你改為以 HTTP API 自建整合，請在請求中送出 User-Agent 標頭。包括 Cloudflare Workers 的 fetch() 在內，有些執行環境預設不會送出，缺少它的請求會在抵達 API 之前被拒絕。

提示範例

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

目標	提示範例
晨報	「給我一份晨報：未結工單、未付發票，以及等待客戶的提案。」
指派工單	「把 Acme 首頁改版相關工單指派給 Jordan Lee（jordan@agency.com）。」
寄送發票	「用電子郵件把發票 INV-1042 寄給客戶。」
建立潛在客戶	「為 Bright Studio 的 Nora Patel 建立潛在客戶，信箱 nora@brightstudio.com。」
將發票標示為已付	「將發票 INV-1042 標示為 paid。」

當兩個人同名時

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

目前可用 vs 尚不可用

目前可用	MCP 尚不支援
提案、專案、工單與發票的晨報與查詢	透過 MCP 在 client chat 回覆
指派工單及其他團隊工作	—
建立潛在客戶	—
寄送發票並標示為已付	—

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

開始使用

工作區設定

CRM

服務與訂單

提案與發票

團隊與任務

表單與檔案

帳戶與帳單

付款

整合

連接 Claude 和 Cursor，透過 MCP 操作 AgencyHandy

兩種連接方式

需求

設定 Claude 或 Cursor MCP

連接雲端代理（託管伺服器）

提示範例

當兩個人同名時

目前可用 vs 尚不可用

相關

​兩種連接方式

​需求

​設定 Claude 或 Cursor MCP

​連接雲端代理（託管伺服器）

​提示範例

​當兩個人同名時

​目前可用 vs 尚不可用

​相關

兩種連接方式

需求

設定 Claude 或 Cursor MCP

連接雲端代理（託管伺服器）

提示範例

當兩個人同名時

目前可用 vs 尚不可用

相關