什麼是 HubSpot MCP 伺服器?
HubSpot MCP 伺服器是一個輕量級的伺服器應用,將 HubSpot CRM 功能以標準化的 MCP 工具形式提供。透過這個整合,AI 客戶端如 Claude Desktop、Cursor 和其他與模型上下文協議相容的客戶端可以安全地訪問、查詢和修改 HubSpot 數據,而無需手動整合 API 或學習 HubSpot API 的具體細節。它將複雜的 CRM 操作抽象為易於使用的命令,以便於 AI 驅動的工作流程和代理自動化。
如何配置 HubSpot MCP 伺服器
- 安裝 Node 和 NPM: 從 nodejs.org 下載並安裝 Node.js 和 npm。
- 建立私人 HubSpot 應用:
- 前往 HubSpot 儀表板:設定 > 整合 > 私人應用。
- 點擊"建立私人應用",命名它,設置所需的範圍,並複製生成的存取令牌。
- 配置 MCP 客戶端:
- 對於 Claude Desktop:
- 在 Claude 配置檔 (
claude_desktop_config.json
) 中添加 HubSpot 伺服器配置與存取令牌,然後重啟應用。
- 在 Claude 配置檔 (
- 對於 Cursor:
- 在專案目錄下的
.cursor/mcp.json
中添加配置。
- 在專案目錄下的
- 對於其他 MCP 客戶端,依照其具體說明來配置外部 MCP 伺服器。
- 對於 Claude Desktop:
- 環境變數: 確保
PRIVATE_APP_ACCESS_TOKEN
在你的配置中正確設置。
如何使用 HubSpot MCP 伺服器
- 配置完伺服器後,重啟你的 MCP 客戶端(例如 Claude Desktop 或 Cursor)。
- 現在你可以直接從 AI 客戶端訪問 HubSpot 特定的工具。使用提示,例如 "獲取有關 Acme Inc. 的最新更新" 或 "在我的 HubSpot 帳戶中創建一個新聯絡人"。
- AI 代理將利用 MCP 工具執行 CRM 操作、獲取見解並根據要求更新記錄。
- 如果遇到配置問題,請訪問相應的文檔或故障排除頁面。
主要特點
- 統一訪問: 從任何與 MCP 相容的客戶端連接到 HubSpot,而無需手動處理 API。
- 廣泛功能: 執行多種 CRM 操作,從讀取和更新記錄到管理關聯、工作流程和互動。
- 安全靈活: 使用你私人應用的存取令牌安全運行,無需暴露原始 HubSpot 憑證。
- 可擴展: 利用不斷增長的 MCP 工具套件,映射到你的 HubSpot CRM 工作流程。
- 反饋支持: 即時生成反饋鏈接以報告或建議改進。
使用案例
- CRM 數據洞察: 總結交易、票據和公司互動以獲取即時商業智慧。
- 聯絡人 & 交易管理: 自動創建、更新和關聯聯絡人、公司、交易和票據。
- 活動追蹤: 添加註解或任務,並追蹤 CRM 中的逾期行動。
- 工作流程分析: 獲取和分析 HubSpot 工作流程、註冊和排程。
- 自定義屬性管理: 程式化列出、創建和更新 CRM 對象上的自定義屬性。
常見問題
Q1: 我在 HubSpot 私人應用中需要哪些權限以使用 MCP 伺服器?
A: 建議初始設置使用唯讀範圍。隨著使用擴展,僅授予執行所需操作的範圍(例如,CRM 對象的讀取/寫入、互動訪問、屬性管理)。
Q2: 使用 MCP 伺服器時我的 HubSpot 數據安全嗎?
A: 是的。MCP 伺服器完全在你的基礎架構內運行,只使用你配置的私人應用的存取令牌。沒有 HubSpot 憑證或敏感數據被存儲或暴露於你的設置之外。
Q3: 我可以在多個 MCP 客戶端應用中使用 HubSpot MCP 伺服器嗎?
A: 是的,你可以將伺服器配置添加到任何與 MCP 相容的客戶端,例如 Claude Desktop 或 Cursor,並在每個客戶端訪問 HubSpot 工具。
Q4: 我如何提供反饋或報告 MCP 工具的問題?
A: 使用 hubspot-generate-feedback-link
工具生成反饋 URL,或在你的 MCP 客戶端中使用專用提示。
Q5: 使用這個伺服器,我可以自動化哪些行動?
A: 你可以自動化從批量記錄創建和更新到生成報告、管理關聯和追蹤互動的所有操作—都可以通過自然語言提示進行。