HubSpot MCP 服务器

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

概述

该 MCP 服务器提供了一套全面的工具用于与 HubSpot CRM API 交互，允许 AI 助手：

• 在您的 HubSpot CRM 中创建和管理联系人和公司

• 检索详细的公司活动历史和参与时间表

• 访问整个 HubSpot 实例中的近期参与数据

• 获取最近活跃的公司和联系人列表

• 无需离开 AI 助手界面即可执行 CRM 操作

Related MCP server: HubSpot MCP Server

为什么要使用此 MCP 服务器？

• 无缝 AI 集成：将您的 AI 助手直接连接到您的 HubSpot CRM 数据

• 简化的 CRM 操作：通过自然语言命令执行常见的 HubSpot 任务

• 实时数据访问：从您的 HubSpot 实例获取最新信息

• 安全身份验证：使用 HubSpot 的安全 API 令牌身份验证

• 可扩展设计：根据需要轻松添加更多 HubSpot API 功能

安装

配置

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

1. 前往您的HubSpot 开发者帐户

2. 创建具有必要范围（联系人、公司、约定）的私人应用程序

3. 复制生成的访问令牌

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

1. 作为环境变量：

   HUBSPOT_ACCESS_TOKEN=your-access-token

2. 作为命令行参数：

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

为了开发，请在项目根目录中创建一个.env文件来存储环境变量：

用法

启动服务器

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

SSE 服务器使用mcp-proxy-auth软件包进行身份验证。要实现身份验证，请执行以下操作：

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 端点

与人工智能助手集成

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

可用工具

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

1. hubspot_create_contact

   • 在 HubSpot 中创建新联系人并进行重复检查

   • 参数：

     • firstname （字符串，必需）：联系人的名字

     • lastname （字符串，必需）：联系人的姓氏

     • email （字符串，可选）：联系人的电子邮件地址

     • properties （对象，可选）：其他联系人属性，如公司、电话等。

   • 例子：

     { "firstname": "John", "lastname": "Doe", "email": "john.doe@example.com", "properties": { "company": "Acme Inc", "phone": "555-123-4567", "jobtitle": "Software Engineer" } }

2. hubspot_create_company

   • 在 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_companies

   • 从 HubSpot 获取最近活跃的公司

   • 参数：

     • limit （数字，可选，默认值：10）：返回的最大公司数量

   • 返回按上次修改日期排序的公司

6. hubspot_get_active_contacts

   • 从 HubSpot 获取最近活跃的联系人

   • 参数：

     • limit （数字，可选，默认值：10）：返回的最大联系人数量

   • 返回按上次修改日期排序的联系人

扩展服务器

该服务器设计易于扩展。要添加新的 HubSpot API 功能，请执行以下操作：

1. 在src/hubspot-client.ts中向HubSpotClient类添加新方法

2. 在src/index.ts中的setupToolHandlers方法中注册新工具

3. 使用npm run build重建项目

执照

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

关键词

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