HubSpot MCP Server

HubSpot MCP 服务器

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

概述

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

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

为什么要使用此 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 工具