HubSpot MCP Server

基本能力

产品定位

HubSpot MCP Server 是一个用于与 HubSpot CRM 交互的开源服务，旨在为销售分析和洞察提供支持。

核心功能

1. CRM 工具：
2. 搜索、获取、创建和更新联系人
3. 列出、获取、创建和更新交易
4. 列出和获取公司信息
5. 销售分析工具：
6. 获取销售分析数据
7. 获取交易历史记录
8. 获取交易笔记
9. 获取与交易相关的活动
10. 获取销售代表绩效数据
11. 获取销售管道分析
12. 获取销售预测分析

适用场景

• 销售团队需要分析销售数据和绩效
• 客户关系管理（CRM）系统需要与 HubSpot 集成
• 需要自动化管理联系人和交易

工具列表

1. 核心 CRM 工具：
2. hubspot_search_contacts：搜索联系人
3. hubspot_get_contact：获取特定联系人
4. hubspot_create_contact：创建新联系人
5. hubspot_update_contact：更新联系人
6. hubspot_list_deals：列出交易
7. hubspot_get_deal：获取特定交易
8. hubspot_create_deal：创建新交易
9. hubspot_update_deal：更新交易
10. hubspot_list_companies：列出公司
11. hubspot_get_company：获取特定公司
12. 销售分析工具：
13. hubspot_get_sales_analytics：获取销售分析数据
14. hubspot_get_deal_history：获取交易历史记录
15. hubspot_get_deal_notes：获取交易笔记
16. hubspot_get_engagements_by_deal：获取与交易相关的活动
17. hubspot_get_sales_performance：获取销售代表绩效数据
18. hubspot_get_pipeline_analytics：获取销售管道分析
19. hubspot_get_forecast_analytics：获取销售预测分析

常见问题解答

1. 错误排查：
2. 确保所有必需的权限范围已添加到 HubSpot 私有应用
3. 确保 API 密钥已正确复制到配置中
4. 确保 HubSpot 计划包含您尝试使用的 API 的访问权限

使用教程

使用依赖

1. 创建 HubSpot 私有应用：
2. 登录 HubSpot 账户
3. 导航到“设置” → “账户设置” → “集成” → “私有应用”
4. 点击“创建私有应用”
5. 命名应用并设置适当的权限范围（联系人、交易和公司）
6. 创建应用并复制私有应用令牌

安装教程

1. 使用 npx 安装： json { "mcpServers": { "hubspot": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-hubspot"], "env": { "HUBSPOT_API_KEY": "your-api-key-here" } } } }
2. 使用 Docker 安装： json { "mcpServers": { "hubspot": { "command": "docker", "args": ["run", "-i", "--rm", "-e", "HUBSPOT_API_KEY", "mcp/hubspot"], "env": { "HUBSPOT_API_KEY": "your-api-key-here" } } } }

调试方式

1. Docker 构建： bash docker build -t mcp/hubspot -f Dockerfile .
2. 错误排查：
3. 确保所有必需的权限范围已添加到 HubSpot 私有应用
4. 确保 API 密钥已正确复制到配置中
5. 确保 HubSpot 计划包含您尝试使用的 API 的访问权限

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。