Hubspot-MCP

🚀 集成现有 MCP 服务器到 Hubspot 数据库的流程优化文档 🤖

本项目旨在优化将现有 MCP 服务器集成到 Hubspot 数据库的流程，通过一系列配置和验证步骤，实现两者的有效连接。

🚀 快速开始

要完成 MCP 服务器到 Hubspot 数据库的集成，需完成 Hubspot 和 Cursor 的相关配置，并进行访问权限检查。以下是具体步骤：

✨ 主要特性

• 流程清晰：详细说明了从 Hubspot 配置、Cursor 配置到访问权限检查的完整流程。
• 可验证性：提供了验证访问令牌有效性和测试数据输入的提示语句，方便检查集成是否成功。

📦 安装指南

先决条件

• 具备带有读取/写入权限的 Hubspot 访问令牌（需用于私有应用）。
• 安装并运行 Cursor 应用程序以访问 MCP 服务器并与 LLM 进行交互。

在 Hubspot 上配置

1. 访问 Hubspot 并创建一个账户。
2. 在 Hubspot 中，进入 设置 > 集成 > 创建私有应用。
3. 提供该私有应用的基本信息。
4. 点击 权限范围，添加新的权限范围，并确保以下权限被选中：
   • crm.objects.contacts（读取和写入）
   • crm.objects.companies（读取和写入）
5. 添加完权限范围后，点击 创建应用。
6. 返回到 私有应用 页面，查看并保存生成的访问令牌。此令牌将用于后续的 MCP 集成。

在 Cursor 上配置

1. 下载 Cursor 并完成项目文件夹的设置。
2. 进入 设置 > MCP > 添加新的全局 MCP 服务器。
3. 将以下内容粘贴到相应位置，并确保包含你的 Hubspot 访问令牌：

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "buryhuang/mcp-hubspot:latest",
        "--access-token",
        "<Your Access Token here>"
      ]
    }
  }
}

💻 使用示例

基础用法

我们可以使用以下提示语句来验证集成是否成功或是否遇到问题。

验证访问令牌的有效性

通过向 HubSpot MCP 服务器发出最小的认证请求，测试当前访问令牌的有效性。

测试数据输入以进行检查

创建一家公司，使用以下数据：
名称：nimbus Technologies
描述：云基础设施与人工智能服务 ☁️🤖
域名：nimbustech.ai
电话：+1-800-555-0199
网站：https://www.nimbustech.ai
地址：123 创新大道
城市：旧金山
州份：CA
邮政编码：94107
国家：美国
行业：信息技术和服务
类型：潜在客户
员工人数：4200
年收入：125,000,000

在 Hubspot 数据库中反映的值：

📄 许可证

文档中未提及相关许可证信息。

致谢

• 感谢 baryhuang 创作了 Docker 集成。
• 原始的 Hubspot CRM - MCP 服务器由 peakmojo 创建。