Hubspot MCP Server (Naoraideas)

HubSpot MCP服务器

HubSpot的模型上下文协议（MCP）服务器实现，提供了与HubSpot API交互的标准化接口。

概述

该软件包实现了一个MCP服务器，该服务器充当应用程序和HubSpot的API之间的桥梁。它提供了一种通过模型上下文协议与HubSpot服务交互的标准化方式。

示例用法

你有没有想过人工智能如何改变你的HubSpot工作流程？通过简单的对话，看看这些现实世界的场景是如何变成现实的：

💡 销售与项目管理 *“我刚刚与TechCorp的Sarah就他们的云迁移项目进行了一次很好的会面。以25万美元的价格创建一笔新交易，将其与他们的公司记录相关联，并安排下周与他们的CTO进行后续通话，讨论实施时间表。”*

🚀 客户登录 *“我们最大的客户Enterprise Solutions正在扩大他们的团队。为他们的新首席技术官创建一个新联系人，将他们与‘数字化转型’项目联系起来，并在未来两周内与我们的技术团队举行一系列入职会议。”*

⚡ 项目移交 *“‘人工智能集成’项目正在进入最后阶段。更新交易状态，为移交过程创建新的支持票，并安排下个月与客户团队的培训课程，确保包括其IT部门的所有相关联系人。”*

用法

作为命令行工具运行

服务器在stdio上运行，可以用作命令行工具：

hubspot-mcp-server

与Claude Desktop集成

要将此服务器与Claude Desktop一起使用，请将以下配置添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@naoraideas/hubspot-mcp-server"
      ],
      "env": {
        "HUBSPOT_API_KEY": "your_hubspot_api_key_here"
      }
    }
  }
}

安装

npm install @NaorAIdeas/hubspot-mcp-server

先决条件

• （版本14或更高版本）-从官方网站下载并安装
• HubSpot API密钥（个人访问令牌）

配置

获取HubSpot API密钥

要开始使用HubMCP Spot服务器，您需要获得API密钥。以下是详细的指南：

1. 登录您的HubSpot帐户

- 访问 HubSpot网站 并登录您的帐户

1. 导航到私人应用程序

- 前往设置>帐户设置>集成>私人应用 - 如果您没有看到此选项，请确保您拥有必要的权限

1. 创建新的私人应用程序

- 点击“创建私人应用” - 为您的应用程序命名（例如，“HubSpot MCP服务器”） - 添加应用程序将用于什么的描述

1. 配置作用域

- 选择以下范围（最低要求）： - crm.objects.contacts.read - crm.objects.contacts.write - crm.objects.companies.read - crm.objects.companies.write - crm.objects.deals.read - crm.objects.deals.write - crm.objects.custom.read - crm.objects.custom.write - crm.associations.read - crm.associations.write - timeline.read - timeline.write

1. 保存并获取API密钥

- 点击“创建应用” - 立即复制生成的访问令牌 - 请安全存放，因为它只会显示一次

可用工具

联系人管理

• “我接到（415）555-0123的电话，请问是谁？”
• “将John Smith的职位更新为Acme Corp的销售副总裁”
• “给我找TechStart公司的Emma Wilson的电子邮件”

公司管理

• “显示旧金山地区的所有公司”
• “创造IT行业‘云技术解决方案’的新公司记录”
• “将微软的年收入更新为2000亿美元”

交易管理

• “‘企业云迁移’交易的状态如何？”
• “为价值15万美元的‘人工智能集成项目’创造新协议”
• “将‘数字化转型’交易移至‘合同发送’阶段”

自定义对象

• “显示‘产品开发’管道中的所有活动项目”
• “为‘服务器停机’问题创建新的支持工单”
• “将“移动应用程序启动”项目的优先级更新为高”

协会

• “哪些联系人与‘企业解决方案’公司有关联？”
• “将Sarah Johnson与‘云迁移’项目联系起来”
• “删除Mark Davis与‘遗留系统’项目之间的关联”

时间线事件

• “显示本月与谷歌安排的所有会议”
• “下周二与亚马逊建立新的跟进电话”
• “用Microsoft更新昨天产品演示的描述”

发展

环境设置

创建一个 .env 包含以下内容的项目根目录中的文件：

HUBSPOT_API_KEY=your_hubspot_api_key_here

建设项目

npm run build

发展模式

要在监视模式下运行项目，请执行以下操作：

npm run watch

依赖项

• @hubspot/api-client:hubspot api客户端
• @modelcontextprotocol/sdk：模型上下文协议sdk
• dotenv：环境变量管理
• zod：模式验证

许可证

该项目根据 MIT许可证.

免责声明

软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权持有人均不对因软件或软件的使用或其他交易而产生或与之相关的任何索赔、损害赔偿或其他责任承担责任，无论是在合同、侵权或其他诉讼中。

作者

Naor哼哼\ 人工智能集成专家与软件工程师\ 热衷于构建能够改变业务工作流程的智能系统。\ 让我们联系并探索人工智能如何彻底改变您的HubSpot体验！

| 领英 | 电子邮件

贡献

这个项目是用❤️ 以及通过人工智能使HubSpot更易访问的热情。\ 如果你想贡献、有疑问或只是想聊聊人工智能驱动的工作流程，请随时联系我们！