HubSpot 集成服务器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/hubspot-mcp-server。
技能介绍
要解决的问题
企业运营中,客户记录、销售管道和营销活动都沉淀在 HubSpot CRM 里。团队要么手工导出再加工,要么为一次简单查询写一次性脚本,结果数据口径不一致,自动化也难以复用。要让模型或自动化工具直接操作 HubSpot 数据,需要一个统一、可枚举的接口,而不是每次重写 HTTP 调用。
工作方式
这个技能把 HubSpot API 封装成一个 MCP(Model Context Protocol)服务器:
- 基于官方客户端
@hubspot/api-client,直接复用其认证、请求构造与分页处理逻辑 - 通过标准 MCP 工具接口暴露 HubSpot 资源操作,宿主应用无需关心底层 HTTP 细节
- 按 SKILL.md 的前置要求,运行环境需具备
Node.js与npm
使用流程大致分三步:配置(准备 HubSpot 私有应用凭据并授予所需 scope)、调用(通过 MCP 客户端列出可用工具并发起请求)、处理(解析返回结果,衔接后续业务逻辑)。
适用边界
- 仅覆盖 SKILL.md 中声明的能力范围,未实现的功能需要自行扩展
- 具体端点的可用性取决于 HubSpot API 文档中的接口与权限设置
- 高频调用需要关注 HubSpot 的限流策略,避免触发速率限制
- 凭据管理应遵循团队内部的安全规范,不要硬编码到代码仓库
使用场景
- 运营要把 HubSpot 里的联系人列表同步给自动化流程做后续跟进,不想每次手写导出脚本。
- 销售想查看某一阶段销售管道中的客户及最近活动记录,通过 MCP 工具直接查询而非复制粘贴。
- 开发者要给内部工具增加查询 HubSpot 公司信息的能力,希望统一用 MCP 接口暴露给宿主应用。
- 自动化脚本需要按条件筛选客户并读取其属性,想复用官方 API 客户端而不用自己处理认证和分页。
适合人员
- 企业运营人员:日常要在 HubSpot 里维护客户数据,希望减少重复的手工导出和脚本编写。
- Node.js 后端开发者:正给自动化或 AI 应用接入 HubSpot API,需要一个可枚举的标准接口。
- CRM 管理员:负责配置 HubSpot 私有应用凭据和 scope 权限,想规范团队对 CRM 数据的访问方式。
- 内部工具负责人:希望把 HubSpot 查询能力封装成可被模型调用的工具,供其他团队复用。