返回 MCP 目录
public公开dns本地运行

hubspot-mcp-server-pkc

HubSpot MCP服务器是一个标准化接口实现,用于连接应用程序与HubSpot API,提供CRM数据管理和工作流自动化功能。

article

README

🚀 HubSpot MCP 服务器

本项目实现了一个 MCP 服务器,它作为应用与 HubSpot API 之间的桥梁,通过模型上下文协议提供标准化接口,让应用能够便捷地与 HubSpot 的服务进行交互。

🚀 快速开始

安装

npm install hubspot-mcp-server

运行命令行工具

npx hubspot-mcp-server

Claude Desktop 集成

config.json 中添加以下内容:

{
  "modelContextProtocol": {
    "apiKey": "your_hubspot_api_key",
    "serverUrl": "http://localhost:3000"
  }
}

✨ 主要特性

  • 联系人管理:可添加、更新和删除联系人记录。
  • 企业管理:能操作公司信息和关联关系。
  • 关联管理:负责处理项目与参与者的链接。
  • 时间线事件:支持创建和更新日历活动。
  • 工单系统:可管理支持请求和状态变更。

💻 使用示例

销售与项目管理

  • 创建新交易:create new deal
  • 更新客户记录:update customer record
  • 计划下次会议:schedule next meeting

客户 Onboard

  • 欢迎新客户:welcome new customer
  • 收集信息:gather information
  • 安排后续通话:schedule follow-up call

项目交接

  • 更新项目状态:update project status
  • 分配任务:assign task
  • 创建交付记录:create delivery record

📦 安装指南

npm install hubspot-mcp-server

📚 详细文档

配置

获取 HubSpot API 密钥

  1. 访问 HubSpot
  2. 登录或创建新账户
  3. 进入 设置 > 开发人员
  4. 创建新应用并启用所需权限范围

开发

环境变量

创建 .env 文件:

HUBSPOT_API_KEY=your_hubspot_api_key_here

构建项目

npm run build

开发模式

npm run watch

依赖项

  • @hubspot/api-client:HubSpot API 客户端
  • @modelcontextprotocol/sdk:模型上下文协议 SDK
  • dotenv:环境变量管理工具
  • zod:数据验证库

⚠️ 注意事项

⚠️ 重要提示

  • 需要 Node.js 14 或更高版本
  • 必须提供有效的 HubSpot API 密钥

📄 许可证

本项目使用 MIT 许可证。

👨‍💻 作者

Naor Hemed
AI 集成专家 & 软件工程师
热衷于构建智能系统以转变业务流程

GitHub | LinkedIn | 邮箱

🤝 参与贡献

此项目由衷热爱并怀着对 AI 的激情打造。欢迎随时联系,了解如何参与、提问或讨论 AI 驱动的业务流程!

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端