HubSpot MCP服务器

HubSpot MCP服务器是一个AI客户端与HubSpot数据交互的中间层服务,支持通过标准协议实现CRM数据操作和集成。

  • by ajaystream
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 ajaystream/hubspot-mcp-custom

使用说明

HubSpot MCP服务器

HubSpot的MCP服务器现已发布测试版。这使AI客户端能够无缝地执行HubSpot操作并与您的HubSpot数据交互,为我们的生态系统开辟了强大的新集成可能性。有关更多信息和提供反馈,请访问https://developers.hubspot.com/mcp.您还可以使用提示 Provide feedback for HubSpot MCP tools 从您首选的客户端应用程序!

什么是MCP?

主控程序 (模型上下文协议)是一种新兴标准,允许人工智能模型通过一致的接口与应用程序交互。它作为HTTP上的抽象层,允许AI代理访问应用程序功能,而无需了解特定的API协议。

条款与条件

HubSpot MCP服务器处于测试阶段,受 早期采用者计划条款.

先决条件

安装node和npm

访问 这 链接下载Node和NPM。

在HubSpot中创建一个私人应用程序:

  • 前往“设置”>“集成”>“私人应用”

  • 点击“创建私人应用”

  • 命名您的应用程序并设置所需的范围

  • 点击“创建应用”

  • 复制生成的访问令牌

    考虑从只读作用域开始

使用MCP服务器

克劳德桌面

  1. 下载克劳德桌面 这里.
  2. 将服务器配置添加到Claude Desktop配置文件中(通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS中)并重新启动Claude Desktop:
{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": ["-y", "@hubspot/mcp-server"],
      "env": {
        "PRIVATE_APP_ACCESS_TOKEN": "<your-private-app-access-token>"
      }
    }
  }
}
  1. 保存文件并重新启动Claude。您现在应该可以访问所有工具了!
  2. 访问 这一页 了解更多信息和故障排除。

光标

  1. 创建一个 .cursor/mcp.json 项目中的文件
mkdir -p .cursor && touch .cursor/mcp.json
  1. 将以下配置放入文件。
{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": ["-y", "@hubspot/mcp-server"],
      "env": {
        "PRIVATE_APP_ACCESS_TOKEN": "<your-private-app-access-token>"
      }
    }
  }
}
  1. 保存文件并重新启动Cursor。您现在应该可以访问所有工具了!

  2. 访问 这一页 了解更多信息和故障排除。

其他MCP客户端

其他流行的MCP客户端列表包括 这里.

示例用法

设置后,尝试以下示例提示:

从HubSpot数据中获取见解

  • 从我的HubSpot帐户获取有关Acme股份有限公司的最新更新。
  • 总结我HubSpot管道中“决策者买入”阶段的所有交易,交易价值>1000美元。
  • 总结我HubSpot帐户中为Alex Smith创建的最后五张票。

创建和更新CRM记录

  • 更新我HubSpot帐户中John Smith的地址。
  • 创建新联系人”John.Johnson@email.com”在我的HubSpot帐户中。

CRM关联

  • 从我的HubSpot帐户中列出Acme股份有限公司的所有关联联系人及其角色。
  • 在我的HubSpot帐户中列出Acme股份有限公司的关联联系人。
  • 在我的HubSpot账户中将John Smith作为Acme股份有限公司的合伙人。

添加约定

  • 添加一个任务以向其发送感谢信jane@example.com在我的HubSpot账户中。
  • 在我的HubSpot帐户中添加Acme股份有限公司的备注。
  • 列出我过期的HubSpot任务。
  • 从我的HubSpot帐户中,找到联系人的数量 有?

工具

此MCP服务器提供了一组用于与HubSpot CRM API交互的工具。

类别 工具名称 描述
OAuth hubspot获取用户详细信息 验证当前hubspot私有应用访问令牌,提供用户信息、中心详细信息、授权范围和帐户信息。
对象 中心点列表对象 检索指定对象类型的CRM记录的分页列表。
对象 中心点搜索对象 使用复杂的条件和基于属性的筛选在CRM记录中执行筛选搜索
对象 hubspot-batch-create-Objects 在单个API调用中创建同一对象类型的多个CRM记录。
对象 hubspot-batch-update-Objects 在单个API调用中使用新属性值更新多个现有CRM记录。
对象 hubspot批读取对象 在单个批处理操作中按ID检索多个CRM记录。
对象 hubspot获取模式 检索可用的自定义对象模式及其objectTypeId和定义。
Properties hubspot列表属性 检索为任何CRM对象类型定义的完整属性目录。
Properties hubspot get property 检索有关特定属性定义的详细信息。
属性 轮毂点创建属性 为CRM对象类型创建新的自定义属性。
属性 轮毂点更新属性 更新现有自定义属性的设置。
关联 hubspot批量创建关联 在不同对象类型的CRM记录之间建立多个关系。
关联 中心点列表关联 检索特定记录和其他关联记录之间的现有关系。
关联 轮毂点获取关联定义 检索特定对象类型之间的有效关联类型和标签。
Engagements hubspot创建engagency 创建与联系人、公司、交易或票证相关的Engagements(注释或任务)。
订婚 hubspot获取订婚 按ID检索订婚详细信息
约定 中心点更新约定 用新信息更新现有约定。
工作流 中心点列表工作流 检索分页的工作流列表
工作流 中心点获取工作流 检索特定工作流的详细信息,包括操作、注册条件和日程安排。
链接 hubspot生成反馈链接 生成用于报告工具问题或提供反馈的反馈链接。
链接 hubspot获取链接 生成hubspot UI URL,以直接访问hubspot界面中的记录。