AI导哈

HubSpot CRM集成服务器

一个强大的模型上下文协议（MCP）服务器实现，用于无缝集成HubSpot CRM，使AI助手能够与您的HubSpot数据进行交互。

  • by lkm1developer
  • TypeScript
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 lkm1developer/hubspot-mcp-server

使用说明

HubSpot MCP服务器

一个强大的模型上下文协议（MCP）服务器实现，用于无缝集成HubSpot CRM，使AI助手能够与您的HubSpot数据进行交互。

概述

此MCP服务器提供了一套全面的工具，用于与HubSpot CRM API交互，使人工智能助手能够：

  • 在HubSpot CRM中创建和管理联系人和公司
  • 检索详细的公司活动历史和参与时间表
  • 访问整个HubSpot实例的最新参与数据
  • 获取最近活跃的公司和联系人列表
  • 在不离开AI助手界面的情况下执行CRM操作

为什么使用此MCP服务器？

  • 无缝AI集成：将您的AI助手直接连接到您的HubSpot CRM数据
  • 简化CRM操作：通过自然语言命令执行常见的HubSpot任务
  • 实时数据访问：从HubSpot实例获取最新信息
  • 安全认证：使用HubSpot的安全API令牌身份验证
  • 可扩展设计：根据需要轻松添加更多HubSpot API功能

安装

# Clone the repository
git clone https://github.com/lkm1developer/hubspot-mcp-server.git
cd hubspot-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

配置

服务器需要HubSpot API访问令牌。您可以通过以下方式获得：

  1. 前往您的 HubSpot开发人员帐户
  2. 创建一个具有必要范围（联系人、公司、活动）的私人应用程序
  3. 复制生成的访问令牌

您可以通过两种方式提供令牌：

  1. 作为环境变量：

    HUBSPOT_ACCESS_TOKEN=your-access-token

  2. 作为命令行参数：

    npm start -- --access-token=your-access-token

为了发展，创建一个 .env 项目根目录中的文件，用于存储环境变量：

HUBSPOT_ACCESS_TOKEN=your-access-token

用法

启动服务器

# Start the server
npm start

# Or with a specific access token
npm start -- --access-token=your-access-token

# Run the SSE server with authentication
npx mcp-proxy-auth node dist/index.js

在SSE服务器中实现身份验证

SSE服务器使用 mcp代理身份验证 用于身份验证的包。要实现身份验证，请执行以下操作：

  1. 安装软件包：

    npm install mcp-proxy-auth

  2. 设置 AUTH_SERVER_URL 指向API密钥验证终结点的环境变量：

    export AUTH_SERVER_URL=https://your-auth-server.com/verify

  3. 使用身份验证运行SSE服务器：

    npx mcp-proxy-auth node dist/index.js

  4. SSE URL将在以下网址提供：

    localhost:8080/sse?apiKey=apikey

    替换 apikey 使用您的实际API密钥进行身份验证。

这 mcp-proxy-auth 包充当代理：

  • 拦截对您的SSE服务器的请求
  • 根据身份验证服务器验证API密钥
  • 仅允许经过身份验证的请求到达您的SSE端点

与AI助手集成

此MCP服务器旨在与支持模型上下文协议的AI助手配合使用。一旦运行，服务器就会公开一组工具，兼容的AI助手可以使用这些工具与您的HubSpot CRM数据进行交互。

可用工具

服务器公开了以下强大的HubSpot集成工具：

  1. hubspot_create_contact

    • 使用重复检查在HubSpot中创建新联系人
    • 参数：
      • firstname （string，必填）：联系人的名字
      • lastname （string，必填）：联系人的姓氏
      • email （字符串，可选）：联系人的电子邮件地址
      • properties （object，可选）：其他联系人属性，如公司、电话等。
    • 例子：
      {
  "firstname": "John",
  "lastname": "Doe",
  "email": "john.doe@example.com",
  "properties": {
    "company": "Acme Inc",
    "phone": "555-123-4567",
    "jobtitle": "Software Engineer"
  }
}

  2. hubspot_create_公司

    • 通过重复检查在HubSpot中创建新公司
    • 参数：
      • name （字符串，必填）：公司名称
      • properties （对象，可选）：其他公司属性
    • 例子：
      {
  "name": "Acme Corporation",
  "properties": {
    "domain": "acme.com",
    "industry": "Technology",
    "phone": "555-987-6543",
    "city": "San Francisco",
    "state": "CA"
  }
}

  3. hubspot_get_company_activity

    • 获取特定公司的全面活动历史记录
    • 参数：
      • company_id （字符串，必填）：HubSpot公司ID
    • 返回详细的参与数据，包括电子邮件、电话、会议、笔记和任务

  4. hubspot_get_recent_engagements

    • 获取所有联系人和公司的最新参与活动
    • 参数：
      • days （数字，可选，默认值：7）：回顾的天数
      • limit （数字，可选，默认值：50）：要返回的最大参与次数
    • 按时间顺序返回最近所有CRM活动的列表

  5. hubspot_get_active_公司

    • 从HubSpot获取最近活跃的公司
    • 参数：
      • limit （number，可选，默认值：10）：要返回的最大公司数
    • 返回按上次修改日期排序的公司

  6. hubspot_get_active_contacts

    • 从HubSpot获取最近活跃的联系人
    • 参数：
      • limit （数字，可选，默认值：10）：要返回的最大联系人数
    • 返回按上次修改日期排序的联系人

  7. hubspot_update_contact

    • 更新HubSpot中的现有联系人（如果联系人不存在，则忽略）
    • 参数：
      • contact_id （字符串，必填）：要更新的HubSpot联系人ID
      • properties （对象，必填）：要更新的联系人属性
    • 例子：
      {
  "contact_id": "12345",
  "properties": {
    "email": "updated.email@example.com",
    "phone": "555-987-6543",
    "jobtitle": "Senior Software Engineer"
  }
}

  8. hubspot_update_公司

    • 在HubSpot中更新现有公司（如果公司不存在则忽略）
    • 参数：
      • company_id （字符串，必填）：要更新的HubSpot公司ID
      • properties （object，必填）：要更新的公司属性
    • 例子：
      {
  "company_id": "67890",
  "properties": {
    "domain": "updated-domain.com",
    "phone": "555-123-4567",
    "industry": "Software",
    "city": "New York",
    "state": "NY"
  }
}

扩展服务器

该服务器设计为易于扩展。要添加新的HubSpot API功能：

  1. 向中添加新方法 HubSpotClient 类在 src/hubspot-client.ts
  2. 在中注册新工具 setupToolHandlers 方法in src/index.ts
  3. 使用重建项目 npm run build

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

关键词

HubSpot，CRM，模型上下文协议，MCP，人工智能助手，TypeScript，API集成，HubSpot API，CRM集成，联系人管理，公司管理，参与跟踪，人工智能工具

相关 MCP