🚀 HubSpot MCP Server
HubSpot的MCP服务器现已开启公测。这使得AI客户端能够无缝执行HubSpot操作并与你的HubSpot数据进行交互,为我们的生态系统开辟了强大的新集成可能性。如需更多信息并提供反馈,请访问 此处。你还可以在你喜欢的客户端应用程序中使用提示 Provide feedback for HubSpot MCP tools
来提供反馈!
🚀 快速开始
什么是MCP?
MCP(模型上下文协议)是一种新兴标准,它允许AI模型通过一致的接口与应用程序进行交互。它充当HTTP之上的抽象层,使AI代理无需了解特定的API协议即可访问应用程序功能。
条款与条件
HubSpot MCP服务器处于公测阶段,需遵守 早期采用者计划条款。
前置条件
使用MCP服务器
Claude Desktop
- 从 这里 下载Claude Desktop。
- 将服务器配置添加到你的Claude Desktop配置文件(在macOS中通常位于
~/Library/Application Support/Claude/claude_desktop_config.json
)并重启Claude Desktop:
{
"mcpServers": {
"hubspot": {
"command": "npx",
"args": ["-y", "@hubspot/mcp-server"],
"env": {
"PRIVATE_APP_ACCESS_TOKEN": "<your-private-app-access-token>"
}
}
}
}
- 保存文件并重启Claude。现在你应该可以访问所有工具了!
- 访问 此页面 以获取更多信息和故障排除指导。
Cursor
- 在你的项目中创建一个
.cursor/mcp.json
文件:
mkdir -p .cursor && touch .cursor/mcp.json
- 将以下配置添加到文件中:
{
"mcpServers": {
"hubspot": {
"command": "npx",
"args": ["-y", "@hubspot/mcp-server"],
"env": {
"PRIVATE_APP_ACCESS_TOKEN": "<your-private-app-access-token>"
}
}
}
}
- 保存文件并重启Cursor。现在你应该可以访问所有工具了!
- 访问 此页面 以获取更多信息和故障排除指导。
其他MCP客户端
其他流行的MCP客户端列表可在 这里 找到。
💻 使用示例
设置完成后,尝试以下示例提示:
从HubSpot数据中获取洞察
- 从我的HubSpot账户中获取Acme Inc.的最新更新。
- 总结我HubSpot销售管道中“决策者已认可”阶段且交易价值超过1000美元的所有交易。
- 总结我的HubSpot账户中为Alex Smith创建的最后五张工单。
创建和更新CRM记录
- 更新我HubSpot账户中John Smith的地址。
- 在我的HubSpot账户中为Acme Inc.创建一个新联系人 “John.Johnson@email.com”。
CRM关联
- 列出我HubSpot账户中与Acme Inc.关联的所有联系人及其角色。
- 列出我HubSpot账户中与Acme Inc.关联的联系人。
- 在我的HubSpot账户中将John Smith与Acme Inc.关联为公司。
添加互动
- 在我的HubSpot账户中添加一个向jane@example.com发送感谢信的任务。
- 在我的HubSpot账户中为Acme Inc.添加一条备注。
- 列出我逾期的HubSpot任务。
- 从我的HubSpot账户中查找 <公司名称> 有多少联系人?
📚 详细文档
此MCP服务器提供了一组用于与HubSpot CRM API进行交互的工具。
类别 |
工具名称 |
描述 |
OAuth |
hubspot-get-user-details |
验证当前的HubSpot私有应用访问令牌,提供用户信息、Hub详细信息、授权作用域和账户信息。 |
对象 |
hubspot-list-objects |
检索指定对象类型的CRM记录的分页列表。 |
对象 |
hubspot-search-objects |
使用复杂条件和基于属性的过滤对CRM记录进行过滤搜索。 |
对象 |
hubspot-batch-create-objects |
在单个API调用中创建同一对象类型的多个CRM记录。 |
对象 |
hubspot-batch-update-objects |
在单个API调用中使用新属性值更新多个现有CRM记录。 |
对象 |
hubspot-batch-read-objects |
在单个批处理操作中按ID检索多个CRM记录。 |
对象 |
hubspot-get-schemas |
检索可用的自定义对象架构及其objectTypeId和定义。 |
属性 |
hubspot-list-properties |
检索为任何CRM对象类型定义的完整属性目录。 |
属性 |
hubspot-get-property |
检索特定属性定义的详细信息。 |
属性 |
hubspot-create-property |
为CRM对象类型创建新的自定义属性。 |
属性 |
hubspot-update-property |
更新现有自定义属性的设置。 |
关联 |
hubspot-batch-create-associations |
在不同对象类型的CRM记录之间建立多个关系。 |
关联 |
hubspot-list-associations |
检索特定记录与其他关联记录之间的现有关系。 |
关联 |
hubspot-get-association-definitions |
检索特定对象类型之间的有效关联类型和标签。 |
互动 |
hubspot-create-engagement |
创建与联系人、公司、交易或工单关联的互动(备注或任务)。 |
互动 |
hubspot-get-engagement |
按ID检索互动详细信息。 |
互动 |
hubspot-update-engagement |
使用新信息更新现有互动。 |
工作流 |
hubspot-list-workflows |
检索工作流的分页列表。 |
工作流 |
hubspot-get-workflow |
检索特定工作流的详细信息,包括操作、注册条件和调度。 |
链接 |
hubspot-generate-feedback-link |
生成用于报告工具问题或提供反馈的反馈链接。 |
链接 |
hubspot-get-link |
生成HubSpot UI URL以直接在HubSpot界面中访问记录。 |