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 密钥
- 访问 HubSpot
- 登录或创建新账户
- 进入 设置 > 开发人员
- 创建新应用并启用所需权限范围
开发
环境变量
创建 .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 集成专家 & 软件工程师
热衷于构建智能系统以转变业务流程
🤝 参与贡献
此项目由衷热爱并怀着对 AI 的激情打造。欢迎随时联系,了解如何参与、提问或讨论 AI 驱动的业务流程!
微信扫一扫