HubSpot MCP Server

关键词

HubSpotCRMAI助手CRM集成HubSpot API

项目简介

HubSpot MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它充当 AI 助手和 HubSpot CRM 之间的桥梁。通过此服务器，AI 助手可以安全、便捷地访问和操作 HubSpot CRM 中的数据，例如创建联系人、公司，检索活动历史记录等。它利用 MCP 协议，为 AI 应用提供了一个标准化的上下文服务框架，使得 AI 能够更好地理解和处理与 CRM 系统相关的用户请求。

主要功能点

  • 连接 HubSpot CRM: 无缝连接到 HubSpot CRM 系统，让 AI 助手可以访问 CRM 数据。
  • 简化 CRM 操作: 通过自然语言指令，AI 助手可以执行常见的 HubSpot CRM 任务，例如创建和管理联系人及公司。
  • 实时数据访问: 提供对 HubSpot 实例的实时数据访问能力，确保 AI 助手获取最新信息。
  • 安全认证: 使用 HubSpot 安全的 API 令牌认证机制，保障数据访问安全。
  • 工具扩展性: 易于扩展设计，可以根据需要添加更多的 HubSpot API 功能。
  • 提供多种工具: 预置了一系列强大的 HubSpot 集成工具，例如创建联系人、创建公司、获取公司活动、获取最近互动、获取活跃公司和联系人等。

安装步骤

  1. 克隆仓库

    git clone https://github.com/lkm1developer/hubspot-mcp-server.git
cd hubspot-mcp-server

  2. 安装依赖

    npm install

  3. 构建项目

    npm run build

服务器配置

HubSpot MCP Server 需要 HubSpot API 访问令牌才能工作。您需要先在 HubSpot 开发者账户中创建一个私有应用并获取访问令牌。

MCP 客户端配置 (JSON 格式):

{
  "serverName": "hubspot-mcp-server",
  "command": "npm",
  "args": [
    "start",
    "--",
    "--access-token",
    "<Your_HubSpot_API_Access_Token>"
    // 将 <Your_HubSpot_API_Access_Token> 替换为您的 HubSpot API 访问令牌
    // 或者您也可以选择将访问令牌设置为环境变量 HUBSPOT_ACCESS_TOKEN，
    // 这样在args中可以省略 "--access-token" 和 "<Your_HubSpot_API_Access_Token>"
  ]
}

参数说明:

  • 'serverName': MCP 服务器的名称，可以自定义。
  • 'command': 启动服务器的命令，这里使用 'npm'。
  • 'args': 传递给 'npm start' 命令的参数列表。
    • '"start"': 运行 'package.json' 中定义的 'start' 脚本，启动服务器。
    • '"--"': 用于分隔 npm 命令和传递给 Node.js 脚本的参数。
    • '"--access-token"': 将 HubSpot API 访问令牌作为命令行参数传递给服务器。
    • '"<Your_HubSpot_API_Access_Token>"': 请替换为您的实际 HubSpot API 访问令牌。

环境变量配置 (可选):

您也可以将 HubSpot API 访问令牌设置为环境变量 'HUBSPOT_ACCESS_TOKEN'。 创建 '.env' 文件在项目根目录下，并添加：

HUBSPOT_ACCESS_TOKEN=your-access-token

如果使用环境变量配置，MCP 客户端配置的 'args' 可以简化为:

{
  "serverName": "hubspot-mcp-server",
  "command": "npm",
  "args": [
    "start"
  ]
}

SSE 服务器配置 (可选):

如果需要使用 SSE 协议，并启用 API Key 认证，可以使用 'mcp-proxy-auth' 工具。 MCP 客户端需要连接到 'mcp-proxy-auth' 提供的 SSE URL，例如： 'localhost:8080/sse?apiKey=apikey'。 具体配置和启动方式请参考 README 文档中关于 "Implementing Authentication in SSE Server" 的部分。

基本使用方法

  1. 启动服务器: 根据上述配置，使用 MCP 客户端启动 HubSpot MCP Server。
  2. AI 助手交互: 配置支持 MCP 协议的 AI 助手连接到该服务器。
  3. 调用工具: AI 助手可以通过调用服务器提供的工具来与 HubSpot CRM 进行交互。例如，调用 'hubspot_create_contact' 工具创建新的联系人，或调用 'hubspot_get_company_activity' 工具获取公司活动历史记录。
  4. 查看结果: 工具执行结果将以 JSON 格式返回给 AI 助手。

可用工具列表 (Tools):

  • 'hubspot_create_contact': 创建 HubSpot 联系人
  • 'hubspot_create_company': 创建 HubSpot 公司
  • 'hubspot_get_company_activity': 获取公司活动历史
  • 'hubspot_get_recent_engagements': 获取最近的互动记录
  • 'hubspot_get_active_companies': 获取最近活跃的公司
  • 'hubspot_get_active_contacts': 获取最近活跃的联系人

更多工具的参数和使用细节，请参考仓库 README.md 文档中的 "Available Tools" 章节。

服务器信息

访问项目