HubSpot MCP Server

什么是 HubSpot MCP 服务器？

HubSpot MCP 服务器是一个轻量级服务器应用，将 HubSpot CRM 功能作为标准化的 MCP 工具提供。通过这个集成，AI 客户端，如 Claude Desktop、Cursor 以及其他兼容模型上下文协议的客户端，可以安全地访问、查询和修改 HubSpot 数据，而无需手动进行 API 集成或了解 HubSpot API 的具体细节。它将复杂的 CRM 操作抽象成用户友好的命令，以适应 AI 驱动的工作流程和代理自动化。

如何配置 HubSpot MCP 服务器

安装 Node 和 NPM: 从 nodejs.org 下载并安装 Node.js 和 npm。
创建私人 HubSpot 应用:
- 转到 HubSpot 仪表板：设置 > 集成 > 私人应用。
- 点击 "创建私人应用"，命名、设置所需范围，并复制生成的访问令牌。
配置 MCP 客户端:
- 对于 Claude Desktop:
  - 将 HubSpot 服务器配置与您的访问令牌添加到 Claude 配置文件 (claude_desktop_config.json)，然后重启应用。
- 对于 Cursor:
  - 将配置添加到项目目录中的 .cursor/mcp.json。
- 对于其他 MCP 客户端，请遵循其特定的外部 MCP 服务器配置说明。
环境变量: 确保在您的配置中正确设置了 PRIVATE_APP_ACCESS_TOKEN。

如何使用 HubSpot MCP 服务器

配置服务器后，重启您的 MCP 客户端（例如，Claude Desktop 或 Cursor）。
现在您可以直接从 AI 客户端访问 HubSpot 特定的工具。使用 "获取 Acme Inc. 的最新更新" 或 "在我的 HubSpot 帐户中创建一个新联系人的" 等提示。
AI 代理将利用 MCP 工具执行 CRM 操作、获取洞察并按要求更新记录。
如果遇到配置问题，请访问相关文档或故障排除页面。

关键特性

统一访问: 无需手动处理 API，即可通过任何兼容 MCP 的客户端连接 HubSpot。
广泛功能: 执行各种 CRM 操作，从读取和更新记录到管理关联、工作流程和互动。
安全灵活: 使用您私人应用的访问令牌安全操作，不需要暴露原始的 HubSpot 凭证。
可扩展: 利用与您的 HubSpot CRM 工作流程相关联的不断增长的 MCP 工具套件。
反馈支持: 立即生成反馈链接以报告或建议改进。

使用案例

CRM 数据洞察: 总结交易、工单和公司互动以获取即时商业洞察。
联系人和交易管理: 自动创建、更新和关联联系人、公司、交易和工单。
活动跟踪: 添加备注或任务，并在 CRM 中跟踪逾期操作。
工作流程分析: 获取和分析 HubSpot 工作流程、注册和调度。
自定义属性管理: 以编程方式列出、创建和更新 CRM 对象上的自定义属性。

常见问题

Q1: 使用 MCP 服务器需要我的 HubSpot 私人应用有什么权限？
A: 初始设置建议从只读范围开始。随着使用扩展，仅授予所需操作的范围（例如，CRM 对象读/写、互动访问、属性管理）。

Q2: 使用 MCP 服务器时我的 HubSpot 数据安全吗？
A: 是的。MCP 服务器完全在您的基础设施内运行，仅使用您配置的私人应用的访问令牌。没有 HubSpot 凭证或敏感数据存储或暴露于您的设置之外。

Q3: 我可以将 HubSpot MCP 服务器与多个 MCP 客户端应用一起使用吗？
A: 是的，您可以将服务器配置添加到任何兼容 MCP 的客户端，如 Claude Desktop 或 Cursor，并在每个客户端访问 HubSpot 工具。

Q4: 如何提供反馈或报告 MCP 工具的问题？
A: 使用 hubspot-generate-feedback-link 工具生成反馈 URL，或在您的 MCP 客户端中使用专用提示。

Q5: 使用此服务器，我能自动化哪些类型的操作？
A: 您可以自动化从批量创建和更新记录到生成报告、管理关联和跟踪互动的所有操作——全部通过自然语言提示。

工具名称	描述
hubspot-get-user-details	验证当前 HubSpot 私人应用的访问令牌并检索用户信息、门户详情、授权范围和账户元数据。
hubspot-list-objects	检索指定对象类型（例如，联系人、公司、交易或工单）的分页 CRM 记录列表。
hubspot-search-objects	使用自定义标准和基于属性的过滤器在 HubSpot CRM 中执行过滤搜索。
hubspot-batch-create-objects	在一次调用中创建多个同一对象类型的 CRM 记录，简化批量输入和入职流程。
hubspot-batch-update-objects	在一次操作中使用新的属性值更新多个现有 CRM 记录。
hubspot-batch-read-objects	通过其 ID 一次性检索多个 CRM 记录，优化批量查询的性能。
hubspot-get-schemas	列出可用的自定义对象架构，显示 objectTypeId 及其定义，以便进行高级 CRM 自定义。
hubspot-list-properties	列出任何 HubSpot CRM 对象类型的所有属性定义，提供架构和自定义字段的洞察。
hubspot-get-property	获取特定 CRM 属性定义的详细元数据。
hubspot-create-property	为指定的 CRM 对象类型创建新的自定义属性。
hubspot-update-property	更新现有自定义属性的设置和配置。
hubspot-create-association	建立或更新 CRM 记录之间的关系（例如，将联系人与公司关联）。
hubspot-list-associations	检索特定 CRM 记录与任何相关记录之间的所有关联。
hubspot-get-association-definitions	提供指定 CRM 对象类型之间有效关联类型和标签的列表。
hubspot-create-engagement	创建新的互动，例如备注或任务，将其与相关的联系人、公司、交易或工单关联。
hubspot-get-engagement	检索特定互动 ID 的互动详情。
hubspot-update-engagement	更新现有互动的详情或属性。
hubspot-list-workflows	检索并列出您 HubSpot 账户中配置的可用工作流程。
hubspot-get-workflow	获取特定工作流程的详细信息，包括注册触发器、操作和调度。
hubspot-generate-feedback-link	生成反馈 URL，用于报告问题、建议新工具功能或提供与 MCP 工具相关的其他反馈。
hubspot-get-link	生成一个直接链接，以在您的门户中查看特定 CRM 记录的 HubSpot UI URL。