HubSpot MCP 服务器

一个用于 HubSpot 的模型上下文协议 (MCP) 服务器实现，提供了一个用于与 HubSpot API 交互的标准化接口。

概述

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

使用示例

想知道 AI 如何改变您的 HubSpot 工作流程吗？ 观看这些真实场景如何通过简单的对话变为现实：

💡 销售和项目管理

"我刚刚与 TechCorp 的 Sarah 举行了一次很棒的会议，讨论了他们的云迁移项目。创建一个 25 万美元的新交易，将其与他们的公司记录相关联，并安排下周与他们的 CTO 进行后续电话会议，讨论实施时间表。"

🚀 客户入职

"我们最大的客户 Enterprise Solutions 正在扩大他们的团队。为他们的新 CTO 创建一个新的联系人，将他们链接到“数字化转型”项目，并在接下来的两周内与我们的技术团队安排一系列入职会议。"

⚡ 项目交接

"“AI 集成”项目正在进入最后阶段。更新交易状态，为交接过程创建一个新的支持工单，并安排下个月与客户团队的培训课程，确保包括他们 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

前提条件

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

配置

获取 HubSpot API 密钥

要开始使用 HubSpot MCP 服务器，您需要获取一个 API 密钥。 以下是详细指南：

1. 登录到您的 HubSpot 帐户

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

2. 导航到私有应用

   • 转到设置 > 帐户设置 > 集成 > 私有应用
   • 如果您没有看到此选项，请确保您具有必要的权限

3. 创建一个新的私有应用

   • 点击“创建私有应用”
   • 为您的应用提供一个描述性名称（例如，“HubSpot MCP 服务器”）
   • 添加应用将用于的用途的描述

4. 配置范围

   • 选择以下范围（最低要求）：
     • 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

5. 保存并获取您的 API 密钥

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

可用工具

联系人管理

• "我接到了 (415) 555-0123 的电话，这是谁？"
• "将 John Smith 的角色更新为 Acme Corp 的销售副总裁"
• "帮我找到 TechStart Inc 的 Emma Wilson 的电子邮件"

公司管理

• "向我展示旧金山地区的所有公司"
• "为 IT 行业的 'CloudTech Solutions' 创建一个新的公司记录"
• "将 Microsoft 的年收入更新为 2000 亿美元"

交易管理

• "'企业云迁移'交易的状态是什么？"
• "为价值 15 万美元的 'AI 集成项目' 创建一个新的交易"
• "将 '数字化转型' 交易移至 '合同已发送' 阶段"

自定义对象

• "向我展示 '产品开发' 管道中的所有活动项目"
• "为 '服务器停机' 问题创建一个新的支持工单"
• "将项目 '移动应用发布' 的优先级更新为高"

关联

• "哪些联系人与 'Enterprise Solutions' 公司相关联？"
• "将 Sarah Johnson 链接到 '云迁移' 项目"
• "删除 Mark Davis 和 '遗留系统' 项目之间的关联"

时间线事件

• "向我展示本月与 Google 安排的所有会议"
• "安排下周二与亚马逊的新的后续电话"
• "更新昨天与 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 Hemed AI 集成专家和软件工程师 热衷于构建改变业务工作流程的智能系统。 让我们联系并探索 AI 如何彻底改变您的 HubSpot 体验！

GitHub | LinkedIn | Email

贡献

这个项目是用 ❤️ 和对通过 AI 使 HubSpot 更易于访问的热情构建的。 如果您想贡献、有疑问或只是想聊聊 AI 驱动的工作流程，请随时联系！