HubSpot智能MCP服务器
A. 自定义MCP（模型上下文协议）服务器 它将Claude连接到HubSpot的CRM，以获取高管客户情报。通过整合HubSpot CRM的数据，将自然语言问题转化为全面的客户洞察。
🎯 这能带来什么
将自然语言问题转化为全面的客户智能：
高管查询→ 真实数据
- *“告诉我我们与TheFeed的关系”* → 完整的客户概述，包括6195美元的交易、33个联系人、支持历史记录
- *“我们的交易渠道状况如何？”* → 实时收入数据和销售阶段
- *“显示支持票趋势”* → 客户服务指标和问题模式
- *“谁是我们收入最高的客户？”* → 使用参与度数据对客户分析进行排名
魔术：一个问题=多个系统
- HubSpot （此服务器）→ CRM数据、交易、联系人、支持票、电子邮件
- 吉拉MCP → 开发票、功能请求
- Zendesk MCP → 支持互动、满意度得分
- AI合成 → 结合所有来源的高管级见解
🚀 快速开始
快速设置（自动）
- 设置OAuth应用程序（一次性）：
./setup-oauth.sh这将部署您的HubSpot OAuth应用程序并自动提取凭据。
- 完成设置：
./setup-complete.sh这将：
- 安装依赖项 - 通过浏览器获取OAuth令牌 - 构建MCP服务器 - 配置Claude桌面
- 重新启动克劳德桌面 并用以下方法进行测试： *“查找有关我们主要客户的信息”*
对于开发者
与上述自动设置相同：
- 克隆存储库：
git clone https://github.com/yourusername/hubspot-intelligence-mcp.git
cd hubspot-intelligence-mcp- 设置OAuth应用程序（一次性）：
./setup-oauth.sh- 完成设置：
./setup-complete.sh- 重新启动克劳德桌面 和测试
🔧 客户智能工具
核心工具（全部上线和测试）
search_customers-按名称或关键字查找公司和联系人get_customer_overview-完成客户关系分析get_customer_deals-销售渠道和收入分析get_customer_tickets-支持票务历史和趋势get_customer_contacts-联系人目录和组织结构图get_top_accounts-收入排名客户情报
数据覆盖
- 公司：名称、域名、行业、地点、员工人数、收入
- 联系人：姓名、电子邮件、电话、职位、生命周期阶段
- 交易：价值观、阶段、截止日期、管道、描述
- 门票：主题、优先级、类别、解决状态
- 电子邮件：通信历史、方向、时间戳
🏗️ 技术架构
Claude Desktop ←→ MCP Protocol ←→ HubSpot Intelligence Server ←→ OAuth 2.0 ←→ HubSpot APIs
↓
┌─ Companies API
├─ Contacts API
├─ Deals API
├─ Tickets API
└─ Associations API关键组件
- MCP协议处理程序 -使用6个客户智能工具实施MCP服务器规范
- HubSpot API客户端 -通过自动刷新和速率限制管理OAuth 2.0令牌
- 情报部门 -客户数据聚合和分析的业务逻辑
- 数据聚合 -结合来自多个HubSpot对象的数据，以获得高管见解
📦 分销选项
给每个人
- 全自动设置 (
./setup-complete.sh) - 无需手动配置
- 与跨平台支持 （macOS、Linux、Windows）
对于开发者
- GitHub存储库 有全面的文件
- npm包 分发就绪
- Docker容器化 用于企业部署
对于企业
- Docker Compose 编排
- 内部包注册表 支持
- 安全性和合规性 考虑因素
🔐 安全和OAuth设置
包含OAuth应用程序
此存储库包括 完整的HubSpot OAuth应用程序 在 hubspot-oauth-app/ 预先配置了所有必需作用域的目录。无需创建自己的应用程序！
快速部署OAuth应用程序：
cd hubspot-oauth-app
./deploy.sh有关详细的部署说明，请参阅 hubspot-oauth-app/DEPLOY.md.
所需范围（预配置）
oauth-OAuth身份验证crm.objects.companies.read-公司数据crm.objects.contacts.read-联系方式crm.objects.deals.read-销售渠道数据tickets-支持票访问sales-email-read- 电子邮件通信 （对完整的客户情报至关重要）conversations.read-聊天/对话历史记录crm.objects.users.read-用户信息crm.objects.owners.read-所有者/受让人数据
OAuth应用程序功能
- ✅ 市场准备就绪 -已配置为HubSpot应用市场分发
- ✅ 包括所有范围 -客户数据上没有“拒绝权限”错误
- ✅ 专业设置 -真正的支持联系人和文档URL
- ✅ 一键部署 -基于脚本的简单部署
许可证管理
- 基于环境的配置 -源代码中没有硬编码凭据
- 交互式OAuth流 -基于浏览器的安全令牌获取
- 自动令牌刷新 使用刷新令牌
- 安全令牌存储 通过环境变量
- OAuth 2.0最佳实践 实施
- 格式验证 -凭据设置的有用错误消息
📊 现场测试结果
已验证的工作查询
✅ "search_customers thefeed"
→ Found TheFeed.com (Boulder, CO) + 4 similar companies
→ 33 contacts including Matt Johnson (CTO), Riley (Dev Director)
✅ "get_customer_overview TheFeed.com"
→ $6,195 in active deals, 33 contacts, 1 deal pipeline
→ Industry: RETAIL, 50 employees, $1M annual revenue
→ Last activity: Sept 10, 2025
✅ All 6 MCP tools responding with real HubSpot data📋 文件概述
src/-MCP服务器的TypeScript源代码hubspot-oauth-app/- 完整的HubSpot OAuth应用程序 使用部署脚本
- app-hsmeta.json -具有所有必需作用域的OAuth应用程序配置 - hsproject.json -HubSpot项目配置 - deploy.sh -一键OAuth应用程序部署脚本 - DEPLOY.md -OAuth应用程序部署文档
setup-for-ceo.sh-高管一键设置脚本get-tokens.js-安全OAuth令牌获取脚本（基于环境）claude-desktop-config.example.json-Claude桌面配置模板.env.example-环境变量模板DEPLOYMENT.md-全面部署指南
🆘 故障排除
常见问题
- “找不到Node.js” → 从nodejs.org安装Node.js 18+
- “访问令牌无效” → 检查.env中的令牌是否正确且未过期
- “MCP服务器未连接” → 重新启动Claude Desktop并验证文件路径
支持
有关技术问题，请参阅 DEPLOYMENT.md 或联系您的开发团队。
🎯 非常适合AI Jam 2025
您的HubSpot Intelligence MCP服务器是 全面运转的 并准备好进行高管客户智能演示：
- ✅ 证实 通过OAuth 2.0使用HubSpot
- ✅ 查询 所有主要的CRM对象（公司、联系人、交易、门票、电子邮件）
- ✅ 聚合体 将数据转化为高管就绪的见解
- ✅ 合并 使用Claude Desktop进行自然语言查询
- ✅ 作品 与其他MCP服务器一起提供完整的客户情报
非常适合演示 “一个问题→ 多个业务系统→ 高管见解”
______________________________________________________________________
*为AI Jam 2025打造-高管客户智能平台*