Hubspot MCP

🚀 使用Claude Desktop與HubSpot集成

本項目提供了Claude Desktop與HubSpot集成的詳細方案，幫助你輕鬆實現兩者的對接，提升工作效率。

🚀 快速開始

✨ 創建HubSpot私人應用

1. 登錄您的HubSpot賬戶。
2. 進入設置 → 賬戶設置 → 集成 → 私人應用程序。
3. 點擊“創建私人應用”。
4. 為您的應用命名並選擇適當的權限範圍（包括聯繫人、交易和公司）。
5. 創建完成後，複製您的私人應用令牌。

📦 必需的權限範圍

• crm.objects.contacts.read
• crm.objects.contacts.write
• crm.objects.deals.read
• crm.objects.deals.write
• crm.objects.companies.read
• crm.objects.companies.write
• crm.objects.owners.read
• crm.objects.quotes.read
• crm.objects.line_items.read
• crm.objects.custom.read
• crm.schemas.deals.read
• crm.schemas.contacts.read
• crm.schemas.companies.read
• crm.schemas.custom.read

💻 與Claude Desktop配合使用

在您的claude_desktop_config.json文件中添加以下內容：

🔍 基礎用法：使用npx命令

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-hubspot"],
      "env": {
        "HUBSPOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

🔍 高級用法：使用Docker命令

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "HUBSPOT_API_KEY", "mcp/hubspot"],
      "env": {
        "HUBSPOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

🔧 故障排除

如果遇到問題，請檢查以下內容：

1. 確保所有必需的權限範圍已添加到您的HubSpot私人應用。
2. 確認API密鑰已正確複製到配置文件中。
3. 確認您的HubSpot計劃包含您嘗試使用的API權限。

🛠️ 構建

使用以下命令構建Docker鏡像：

docker build -t mcp/hubspot -f Dockerfile .

📄 許可證

此MCP服務器根據MIT許可證發佈。這意味著您可以自由地使用、修改和分發軟件，前提是您遵守MIT許可證的條款和條件。有關詳細信息，請參閱項目存儲庫中的LICENSE文件。