关键词

HubSpot CRM销售分析CRM集成HubSpot API销售数据

项目简介

HubSpot MCP服务器是一个基于Model Context Protocol构建的后端应用，旨在桥接大型语言模型 (LLM) 和 HubSpot CRM。它提供了一系列工具，允许LLM安全、可控地访问和操作HubSpot CRM系统中的数据，例如联系人、交易、公司以及销售分析数据。这使得LLM能够利用HubSpot的丰富信息，为用户提供更智能的销售分析、客户洞察和自动化工作流等功能。

主要功能点

  • 联系人管理工具: 提供搜索、获取、创建和更新HubSpot联系人的工具。
  • 交易管理工具: 提供列出、获取、创建和更新HubSpot交易的工具。
  • 公司管理工具: 提供列出和获取HubSpot公司的工具。
  • 销售分析工具: 提供获取销售分析数据、交易历史、交易备注、交易互动、销售人员绩效和销售管道分析等工具，帮助LLM进行深入的销售数据分析。
  • 预测分析工具: 提供基于历史数据和当前销售管道的销售预测分析工具。

安装步骤

  1. 创建 HubSpot 私有应用:

    • 登录您的 HubSpot 账户。
    • 导航至 "设置" -> "账户设置" -> "集成" -> "私有应用"。
    • 点击 "创建私有应用"。
    • 为您的应用命名，并设置必要的 Scope 权限（例如 'contacts', 'deals', 'companies' 等，详细的 Scope 列表请参考仓库 README 的 "Required Scopes" 部分）。
    • 创建应用并复制您的私有应用令牌 (Private App Token)。

  2. 配置 MCP 客户端 (例如 Claude Desktop):

    • 打开您的 MCP 客户端配置文件 ('claude_desktop_config.json')。
    • 在 'mcpServers' 字段下添加一个新的服务器配置，例如命名为 "hubspot"。
    • 根据您选择的运行方式（npx 或 Docker），复制相应的配置代码块到 'claude_desktop_config.json' 中。
    • 将配置代码块中的 '"your-api-key-here"' 替换为您在步骤 1 中获得的 HubSpot 私有应用令牌。

服务器配置 (Claude Desktop)

以下是在 'claude_desktop_config.json' 中配置 HubSpot MCP 服务器的示例，您可以根据您的偏好选择 'npx' 或 'docker' 方式进行配置。

使用 npx 方式:

{
  "mcpServers": {
    "hubspot": {
      "command": "npx", // 启动命令，使用 npx 运行 npm 包
      "args": ["-y", "@modelcontextprotocol/server-hubspot"], // 命令参数，安装并运行 @modelcontextprotocol/server-hubspot npm 包
      "env": {
        "HUBSPOT_API_KEY": "your-api-key-here" // 环境变量，用于传递 HubSpot API 密钥
      }
    }
  }
}

使用 docker 方式:

{
  "mcpServers": {
    "hubspot": {
      "command": "docker", // 启动命令，使用 docker 运行容器
      "args": ["run", "-i", "--rm", "-e", "HUBSPOT_API_KEY", "mcp/hubspot"], // 命令参数，运行 docker 镜像 mcp/hubspot，并设置环境变量 HUBSPOT_API_KEY
      "env": {
        "HUBSPOT_API_KEY": "your-api-key-here" // 环境变量，用于传递 HubSpot API 密钥 (虽然在 args 中已设置，但在此处重复设置可能更清晰)
      }
    }
  }
}

配置说明:

  • 'server name': 您可以自定义服务器名称，例如 "hubspot"，在 MCP 客户端中通过此名称引用该服务器。
  • 'command': 服务器启动命令，'npx' 表示使用 npx 运行 npm 包，'docker' 表示使用 docker 运行容器。
  • 'args': 命令参数，
    • 'npx' 方式使用 '["-y", "@modelcontextprotocol/server-hubspot"]' 安装并运行 HubSpot MCP 服务器 npm 包。
    • 'docker' 方式使用 '["run", "-i", "--rm", "-e", "HUBSPOT_API_KEY", "mcp/hubspot"]' 运行名为 'mcp/hubspot' 的 docker 镜像，'-i' 表示保持STDIN打开，'-rm' 表示容器退出后自动删除，'-e HUBSPOT_API_KEY' 表示设置环境变量 'HUBSPOT_API_KEY'。
  • 'env': 环境变量，'HUBSPOT_API_KEY' 用于存储您的 HubSpot 私有应用令牌，服务器代码会读取此环境变量进行 HubSpot API 认证。

重要提示: 请将 '"your-api-key-here"' 替换为您真实的 HubSpot 私有应用令牌。

基本使用方法

配置完成后，您的 MCP 客户端 (例如 Claude Desktop) 应该能够连接到 HubSpot MCP 服务器。您可以使用自然语言指令指示 LLM 调用 HubSpot 工具。

例如，在 Claude 中，您可以这样提问：

'搜索 HubSpot 中名为 "John Smith" 的联系人'

LLM 可能会解析您的指令，并调用 'hubspot_search_contacts' 工具，并将 "John Smith" 作为 'query' 参数传递给该工具。服务器会执行搜索并在 HubSpot 中查找匹配的联系人，然后将结果返回给 LLM，最终呈现给您。

您可以参考仓库 README.md 中 "Tools" 部分的工具列表和参数描述，更详细地了解每个工具的功能和使用方法，以便更有效地利用 HubSpot MCP 服务器。

信息

分类

商业系统

访问项目