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文件。