HubSpot MCP Server 使用说明

项目简介

HubSpot MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 提供与 HubSpot CRM 系统集成的能力。通过此服务器，LLM 应用可以安全、标准地访问和操作 HubSpot 中的数据，例如联系人、公司以及活动记录。

主要功能点

资源访问: 提供对 HubSpot 联系人 ('hubspot://hubspot_contacts') 和公司 ('hubspot://hubspot_companies') 资源的标准化访问，支持实时更新。
工具调用: 支持多种工具，包括：
- 联系人管理: 获取联系人列表 ('hubspot_get_contacts')，创建新联系人 ('hubspot_create_contact')。
- 公司管理: 获取公司列表 ('hubspot_get_companies')，创建新公司 ('hubspot_create_company')，获取公司活动历史 ('hubspot_get_company_activity')。
数据交互: 允许 LLM 应用通过调用工具与 HubSpot 数据进行交互，例如创建新的 CRM 记录或检索现有信息。
便捷部署: 提供 Docker 镜像，方便用户快速部署和运行 MCP 服务器。

安装步骤

获取 HubSpot Access Token:
- 登录您的 HubSpot 账户。
- 导航到 "设置" -> "集成" -> "私有 App"。
- 创建一个新的私有 App，并为其命名和添加描述。
- 在 "作用域" 页面，为您的 App 选择以下必要的权限（scopes）：
  - 'tickets'
  - 'crm.objects.contacts.write'
  - 'crm.objects.contacts.sensitive.read'
  - 'crm.objects.companies.sensitive.read'
  - 'sales-email-read'
  - 'crm.objects.deals.sensitive.read'
  - 'crm.objects.companies.write'
  - 'crm.objects.companies.read'
  - 'crm.objects.deals.read'
  - 'crm.objects.deals.write'
  - 'crm.objects.contacts.read'
- 创建 App 后，复制生成的 Access Token，请妥善保管。

Docker 安装 (推荐):

拉取 Docker 镜像:

docker pull buryhuang/mcp-hubspot:latest

运行 Docker 容器: 将 'your_access_token_here' 替换为您在步骤 1 中获取的 HubSpot Access Token。

docker run \
  -e HUBSPOT_ACCESS_TOKEN=your_access_token_here \
  buryhuang/mcp-hubspot:latest

服务器配置

对于 MCP 客户端（如 Claude Desktop），您需要配置 MCP 服务器的启动命令。以下是使用 Docker 运行 HubSpot MCP Server 的配置示例，请将 'your_access_token_here' 替换为您的 HubSpot Access Token。

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HUBSPOT_ACCESS_TOKEN=your_access_token_here",
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

配置参数说明:

'server name': 'hubspot' (服务器名称，客户端用以标识)
'command': 'docker' (启动服务器的命令，这里使用 Docker)
'args': 启动 Docker 容器的参数列表
- 'run': Docker 运行命令
- '-i': 保持标准输入 (STDIN) 打开，即使没有连接
- '--rm': 容器退出后自动删除
- '-e HUBSPOT_ACCESS_TOKEN=your_access_token_here': 设置环境变量 'HUBSPOT_ACCESS_TOKEN'，用于传递 HubSpot Access Token
- 'buryhuang/mcp-hubspot:latest': Docker 镜像名称和标签

基本使用方法

配置完成后，您的 MCP 客户端（如 Claude Desktop）即可通过 MCP 协议与 HubSpot MCP Server 通信。

资源访问: 客户端可以请求读取 'hubspot://hubspot_contacts' 或 'hubspot://hubspot_companies' 资源，获取 HubSpot 联系人或公司列表。
工具调用: 客户端可以调用预定义的工具，例如 'hubspot_create_contact' 创建新的 HubSpot 联系人，或使用 'hubspot_get_company_activity' 获取指定公司的活动历史。
Prompt 示例:
- 创建 HubSpot 联系人： "请根据以下信息创建一个 HubSpot 联系人：姓名：张三，邮箱：[email protected]，公司：Example 公司" (LLM 应用需要根据此自然语言指令，调用 'hubspot_create_contact' 工具并传递相应的参数)
- 查询公司活动： "请查询公司ID为 1234567 的 HubSpot 公司最近的活动记录" (LLM 应用需要调用 'hubspot_get_company_activity' 工具并传递 'company_id' 参数)

请参考 MCP 客户端的文档，了解如何配置和使用 MCP 服务器以及如何通过 Prompt 与服务器进行交互。

关键词