使用说明

项目简介

HubSpot MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在使AI助手能够直接与HubSpot CRM数据进行交互。通过这个服务器，AI助手可以安全、高效地访问和操作您的HubSpot数据，从而实现更智能的CRM工作流程。

主要功能点

直接访问HubSpot CRM数据：无需复杂的中间步骤，AI助手可以直接连接到您的HubSpot账户，访问联系人、公司和互动数据。
上下文记忆：内置的FAISS向量存储支持跨会话的语义搜索，AI助手可以理解和利用之前的对话上下文。
零配置部署：通过简单的Docker部署，您可以快速启动并运行HubSpot MCP Server，无需繁琐的配置过程。
丰富的工具集：提供一系列预定义的工具，用于创建和检索HubSpot CRM数据，例如创建联系人、公司，获取公司活动，搜索数据等。
优化的性能：利用向量存储、线程级索引和嵌入缓存等技术，提升数据检索和处理效率，确保AI助手获得快速响应。

安装步骤

推荐使用 Smithery 客户端安装，或者直接使用 Docker 镜像。

方法一：使用 Smithery 客户端 (推荐)

确保您已安装 Smithery 客户端。

运行以下命令安装 HubSpot MCP Server：

npx -y @smithery/cli@latest install mcp-hubspot --client claude

方法二：直接使用 Docker 镜像

确保您已安装 Docker。

拉取预构建的 Docker 镜像：

docker pull buryhuang/mcp-hubspot:latest

运行 Docker 镜像，需要替换 'your_token' 为您的 HubSpot 访问令牌。您也可以选择挂载本地目录 '/path/to/storage' 到容器的 '/storage' 目录，以实现数据持久化：
```
docker run -e HUBSPOT_ACCESS_TOKEN=your_token -v /path/to/storage:/storage buryhuang/mcp-hubspot:latest
```
注意: 您需要先在HubSpot中创建一个私有App，并获取具有 'crm.objects.contacts (read/write)', 'crm.objects.companies (read/write)', 'sales-email-read' 权限的访问令牌 (HUBSPOT_ACCESS_TOKEN)。

服务器配置

如果您使用 Claude 等 MCP 客户端，您需要配置 MCP 服务器的启动命令。以下是手动配置的 JSON 示例，您需要根据实际情况修改 'your_token' 和 '/path/to/storage'：

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "HUBSPOT_ACCESS_TOKEN=your_token",  // 替换为您的HubSpot访问令牌
        "-v", "/path/to/storage:/storage",   // 可选：替换为本地存储目录路径，实现数据持久化
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

配置参数说明:

'server name': 'hubspot' (服务器名称，客户端用以标识和调用)
'command': 'docker' (启动服务器的命令，这里使用 Docker)
'args': 启动参数列表，包括：
- 'run': Docker 运行命令
- '-i': 保持STDIN开放，即使未连接
- '--rm': 容器退出时自动删除
- '-e HUBSPOT_ACCESS_TOKEN=your_token': 设置HubSpot访问令牌环境变量，请替换 'your_token' 为您的实际访问令牌
- '-v /path/to/storage:/storage': 挂载本地目录到容器的 '/storage' 目录，可选，请替换 '/path/to/storage' 为您希望保存数据的本地目录路径，用于数据持久化
- 'buryhuang/mcp-hubspot:latest': 使用的 Docker 镜像名称和标签

基本使用方法

配置完成后，您的 AI 助手 (如 Claude) 即可通过 MCP 协议与 HubSpot MCP Server 通信。您可以使用以下示例 Prompt 来指示 AI 助手与 HubSpot CRM 进行交互：

示例 Prompt:

创建 HubSpot 联系人和公司：

Create HubSpot contacts and companies from this LinkedIn profile:
[Paste LinkedIn profile text]

查询销售渠道动态：

What's happening lately with my pipeline?

AI 助手会自动识别并调用 HubSpot MCP Server 提供的工具，例如 'hubspot_create_contact', 'hubspot_create_company', 'hubspot_search_data' 等，来完成您的指令。您可以通过工具名称和描述了解每个工具的具体功能，并在 Prompt 中引导 AI 助手使用合适的工具。

关键词