Hubspot Ma MCP

HubSpot MA MCP服务器

让AI成为HubSpot的营销人员。

   

端点： https://hubspot-ma-mcp.vercel.app/api/mcp LP： daisukehori.ithub.io/hubspot-ma-mcp

只要说“下个月我会做研讨会，请多关照”，AI就会一直执行活动制作、表单制作、列表制作、邮件发送、工作流设计。

129个MCP工具+Knowledge Store（隐式知识记忆）+Claude Skill（行为规范）的三层结构，不仅仅是API包装器了解贵公司HubSpot的MA负责人中所述修改相应参数的值。

两种用法

🔧 用作API包装（无天空）

只需连接MCP服务器。您可以直接从AI操作HubSpot129API。

「山田さんのコンタクト情報を教えて」
「先月作成された取引を一覧して」
「このフォームのフィールドを確認して」
「セミナー申込者リストにメンバーを追加して」

不需要天空。不需要知识库。是连接后马上就能使用的最新的支持HubSpot API v3/v4的MCP服务器。

🧠 作为AI营销者使用（追加Skill）

添加Claude Skill后，AI将作为“理解你公司HubSpot的营销者”而自食其力。

「来月セミナーやるからよろしく」
→ 過去パターン参照 → 命名規則遵守 → 禁止事項チェック → 80%自分で組んで提案

「今月の進捗どう？」
→ ボトルネック特定 → 既存顧客LTV分析 → N1分析 → 戦略的な改善提案

在知识库中学习和使用隐式知识越聪明。

为什么需要

还有其他MCP服务器可以从AI操作HubSpot API。但是如果你只是打API，你就不能成为MA负责人。

真正的MA负责人是：

• 知道“我们的HubSpot没有使用管道（理由：○○）”
• 有“研讨会的时候总是按照这个顺序做”的模式
• 可以遵守“这个属性会在WF自动更新，所以不要碰”的禁止事项
• 遵守“邮件的主题以【公司名】开头”的品牌规则

这个MCP服务器是这样的将隐式知识保存到HubSpot本身进行学习的机制内置。用的越多，就越了解你们公司的做法。

体系结构

┌──────────────────────────────────────────┐
│  Claude Skill（固定・全企業共通）           │
│  MA担当者としての判断規範                   │
│  - Knowledge Storeを毎回読め               │
│  - 自分で調べ尽くしてから人に聞け           │
│  - 施策後は必ず記録しろ                    │
├──────────────────────────────────────────┤
│  Knowledge Store（可変・企業固有）           │
│  HubSpot CRMノートに保存。追加インフラ不要    │
│  12カテゴリ（設計判断・命名規則・手順書等）    │
│  hubspot_knowledge_build で自動構築          │
│  施策実行のたびに自動成長                    │
├──────────────────────────────────────────┤
│  MCP Tools（130ツール）                    │
│  HubSpot API v3/v4 を完全カバー            │
│  CRM / フォーム / リスト / メール / WF 等    │
│  全Zodスキーマがpassthrough対応             │
│  重要ツールは実物API構造で完全型サポート     │
└──────────────────────────────────────────┘

没有Skill也可以使用。 如果只连接MCP服务器，则作为130工具的API包装器发挥作用。追加Skill的话，会增加作为“MA负责人”的判断力。

架构质量策略

每个MCP工具的输入Zod架构采用以下策略构建：

• 重要工具（form_create/form_update等）通过实物API结构实现完全型化：实机的 *_get 基于响应结构，HubSpot Marketing Forms v3/Automation v4/CMS API要求的所有字段（validation、options、defaultValues、useCountryCodeSelect、notifyRecipients、recaptchaEnabled、embedType 等）用Zod网罗。
• 所有object架构 .passthrough()：允许所有object架构中的未知密钥，以允许HubSpot API的未来字段添加或通过此处未指明的隐藏字段。
• 自动完成隐藏必填字段：form_create / form_update 是HubSpot API要求的 createdAt / updatedAt 已在服务器端自动完成。用户不必每次都指定时间戳。

添加、修改工具时必须 docs/development-checklist.md 来修改标记元素的显示属性。 总结了公式OpenAPI spec的取得方法、required/enum的完全网罗、测试步骤。 过去の事故事例（form_create configuration不足、postSubmitAction.typeの redirect 错误，theme的 none 错误，workflow batch_read的type不足）的回顾也包含在内。

使用例

ユーザー: 「来月セミナーやるからよろしく」

AI: Knowledge Storeを確認しています...

    playbooksに「セミナー施策」の標準パターンがあります。
    過去のセミナーフォーム（registration_seminar_202601）を参考に、
    以下の構成で進めます：

    📌 キャンペーン: seminar_202604_spring
    📝 フォーム: registration_seminar_202604
       フィールド: メール（必須）・氏名（必須）・会社名・参加形式
    📋 リスト: seminar_202604_applicants（手動リスト）
    📧 メール: 告知 → 3日前リマインド → 当日リマインド
    ⚡ WF: seminar_registration_flow を複製

    確認事項:
    - セミナー名と日時を教えてください
    - 対象は全コンタクトでよいですか？
    - フォームに追加したいフィールドはありますか？

ユーザー: 「4/20の14時から、オンライン。対象は全員で。フォームはそれでいい」

AI: 承知しました。作成を開始します。
    ✅ キャンペーン作成完了（ID: abc-123）
    ✅ フォーム作成完了（ID: def-456）
    ✅ リスト作成完了（ID: 789）
    ✅ 告知メール下書き作成完了
    ✅ 全アセットをキャンペーンに紐付け完了

    告知メールの件名は「【○○】4/20 オンラインセミナーのご案内」
    で作成しました。内容を確認しますか？

🔒 安全性

Q:可以在公开端点发送HubSpot令牌吗？

• 所有的通讯 HTTPS（TLS暗号化） 保护
• 服务器是无状态是。令牌仅在请求处理期间使用不保存也不记录输出
• 服务器上没有数据库。它只是作为HubSpot API的代理
• 源代码是全部公开进行调试。 app/api/mcp/route.ts 和 lib/hubspot/auth-context.ts 中查看连接状态

如果仍然感到不安： 可以部署到自己的Vercel中，在api_key模式下运行（后述）。

快速启动（3步）

💡 首先给想尝试的人： HubSpot测试帐户 中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。

步骤1:制作HubSpot Private App

HubSpot→ 设置→ 集成→ 私人应用程序→ 创建

所需范围：

｜作用域｜用途｜必需/推荐｜ |:--|:--|:--| | crm.objects.contacts.read/write 联系管理✅ 必需 | crm.objects.companies.read/write | 会社管理 | ✅ 必須 | | crm.objects.deals.read/write |取引管理|✅ 必须| | crm.schemas.contacts.read 模式读取✅ 必需 | automation 工作流✅ 必需 | content CMS营销邮件✅ 必需 | forms 窗体✅ 必需 | crm.lists.read/write 列表/段✅ 必需 | tickets ｜票证｜推荐｜ | sales-email-read 邮件娱乐｜推荐｜ | crm.objects.custom.read/write ｜自定义对象｜推荐｜ | marketing.campaigns.read/write ｜促销活动｜推荐｜ | marketing-email |单次发送|企业必須 | | analytics.behavioral_events.send ｜自定义事件发送｜企业必需｜ | behavioral_events.event_definitions.read_write 事件定义｜企业必需｜ | crm.objects.marketing_events.read/write ｜市场活动｜推荐｜

即使没有推荐的作用域，基本功能也会移动，但调用该工具时会出错。

步骤2:连接MCP服务器

公共服务器（hubspot-ma-mcp.vercel.app），或者可以部署自己专用的服务器。

💡 要部署自己的专用服务器： 自己部署请使用节中的一键部署。可以安全配置以在服务器端管理令牌。

克劳德·艾（网络）： 设置→ MCP → Add:

• 网址： https://hubspot-ma-mcp.vercel.app/api/mcp
• Header名: Authorization値: Bearer あなたのHubSpotトークン

克劳德桌面/光标/VS代码/风帆：

{
  "mcpServers": {
    "hubspot-ma": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://hubspot-ma-mcp.vercel.app/api/mcp"],
      "env": {
        "HEADER_Authorization": "Bearer あなたのHubSpotトークン"
      }
    }
  }
}

克劳德代码：

claude mcp add --transport http hubspot-ma https://hubspot-ma-mcp.vercel.app/api/mcp \
  --header "Authorization: Bearer あなたのHubSpotトークン"

步骤3:安装Claude Skill（推荐）

1. 下载hubspot-ma-operator.zip
2. Claude.ai→ 设置→ 定制→ 技能→ 上传

即使没有天空，130个工具也可以直接使用。加入Skill的话，会加入作为“MA负责人”的判断力（知识存储活用、自我验证循环、对策模式）。

首次登岸（5-10分钟）

在设置后的第一次对话中自动执行：

1. AI扫描HubSpot的所有设置 —批量读取属性、WF、流水线、表单、邮件等
2. 运行自验证循环 —递归检查“这个疑问不能自己追加调查吗？”，深入挖掘WF的详细结构、格式的字段、邮件主题模式等。自力更生的答案全部解决
3. 只有真正不明白的事情用Yes/No确认 —例：“因为过去邮件的70%以【○○】开头，所以作为主题规则进行记录。对吗？”
4. 根据回答确定知识库 —在以后的所有对话中，AI参照该知识

⚠️ 重要注意事项

知识库存储自动创建

第一次设置如下在HubSpot帐户中自动创建:

|作成物|详细| |:--|:--| ①联系方式 mcp-knowledge@system.internal（生命周期：other）｜ 最大10件CRM笔记本电脑。[MCP_KNOWLEDGE:xxx] 已标记

⚠️ 不要删除此联系人和笔记本。 删除会丢失知识库的全部内容。在接触列表中用过滤器 @system.internal 中所述修改相应参数的值。

发送邮件

工具｜注意｜ |:--|:--| | marketing_email_publish 发送给配送列表全体人员。不可撤销。 | | single_send_email 发送一封。收件人不存在联系人 自动创建联系人 单击功能区上自动配置市场联系人 来修改标记元素的显示属性。 |

更新・削除操作

工具｜注意｜ |:--|:--| | form_update | PUT（全体置換）。 省略的字段组将被删除。 | | form_patch | 补丁（部分更新） 仅覆盖指定的字段，省略的部分保留现有值。configuration.notifyRecipients 的明细栏样式中定义的设置。 | | workflow_update（启用）｜符合条件 立即对所有记录执行操作 的可能性。 | | *_delete 全般 | confirm: true 必需。大部分是垃圾箱移动（可复原）。不过 email_delete 啊 永久削除（复元不可）。 |

Enterprise必须机能

marketing_email_publish、single_send_email、custom_event_define/send 啊 营销中心企业 中所述修改相应参数的值。

API速率限制

应用HubSpot标准限制：Private App500000请求/天，Search 4请求/秒。hubspot_context_snapshot 中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。

12类知识库

｜类别｜内容｜ |:--|:--| | design_decisions 设计判断及其理由 | naming_conventions |命名规则| | property_annotations ｜属性的用途、更新方法、从属对象｜ | workflow_annotations WF的目的、模板/个别、依存关系 | playbooks 实施措施的执行步骤书 | guardrails |禁止事项・注意事项| | history ｜过去措施的记录和学习｜ | contacts_segments 分段策略 | brand_voice ｜音调、文体、主题规则｜ | integrations |外部连携・技术构成| | goals ｜市场营销KPI目标（数值目标、达成标准）｜ | calendar 实施日历（日程、准备任务）

工具列表（130工具）

API操作工具（124工具）

｜类别｜API｜工具数｜操作｜ |:--|:--|:--|:--| |CRM联系人/公司/交易/门票| v3 | 20 |完整CRUD×4| |约定：笔记/任务/电子邮件/会议/电话|v3|25|完整CRUD×5| |协会| v4 |4|列出/创建/删除/标签| |属性|v3|4|列表/创建/更新/删除| |管道|v3|4|列表/创建/更新/删除| |产品/行项目|v3|10|全CRUD×2| | Quotes | v3 | 2 | search / get（読取専用） | |工作流程| 自动化v4 |6 |列表/获取/创建/更新/删除/批读取| |CMS博客和页面|v3|5|列表/更新/ replace_form_widget（form_id替换专用）｜ |所有者|v3|2|列表/获取| |表单|营销表单v3|6|列表/获取/创建/更新/ 补丁（部分更新） / delete | |列表/分段|v3|7|创建/搜索/获取/删除/成员管理 | |营销电子邮件|v3|7|列表/获取/创建/更新/删除/克隆/发布| |单次发送| v4 |2|发送/状态| |活动|v3|5|列表/获取/创建/更新/asset_associate| |自定义事件|v3|4|定义/发送/列出定义/获取事件| |目标|v3（获取应用）|3|列表/获取/搜索| |营销活动|v3|8|列表/获取/创建/更新/删除/出席/完成/参与|

知识库存储和修订工具（6个工具）

工具｜说明｜ |:--|:--| | hubspot_knowledge_setup 初次设置 | hubspot_knowledge_build |既存设定の自动分析→自己検证→下书き+质问| | hubspot_knowledge_get 读取知识 | hubspot_knowledge_update ｜知识更新（replace/append）｜ | hubspot_context_snapshot 全部设置的批量快照 | hubspot_marketing_review ｜市场业绩合计→与goals对比进行进展审查｜

克劳德技能

skill/SKILL.md 中选择另一种天花板类型。无企业固有信息・全企业共通。

定义属性：

• 营销思维：森冈毅的概率思考（认知×接触×首选），足立光的现有顾客最大化，适用西口一希的N1分析。在增加措施之前确定瓶颈并验证战略前提
• 每次的初动/自验证循环/判断的划线/确认带假说是/否
• 主动建议协议/工具图/知识库培训/错误响应

第ai条： 下载天空 → 设置→ 定制→ 技能→ 上传 克劳德代码： cp -r skill/ .claude/skills/hubspot-ma-operator/

小组使用

• 相同的HubSpot标记- 共享相同的知识库（所有人参照相同的隐含知识）
• 不同的HubSpot帐户- 完全分离（独立的知识库存储）

常见问题

Q:如果错误地更新了知识库存储？ → hubspot_knowledge_update(category: "xxx", mode: "replace", content: "正しい内容") 中所述修改相应参数的值。

Q:如果错误删除了mcp-knowledge联系人？ → hubspot_knowledge_setup 重新启动交互渲染。但是以前的内容会丢失。

Q:HubSpot的Free计划也能用吗？ →CRM操作、属性、管线、表单、知识库等大部分都是可用的。“发送电子邮件”、“单个-Send定制事件”是企业必需的。

Q:没有Skill也能用吗？ →是的。仅MCP服务器就作为130工具的API包装器发挥作用。添加Skill会增加MA负责人的判断力。

Q:认证模式选择哪一种？ → 个人利用・検证： hubspot_token模式（默认）。不需要配置，每个人都在标题上发送令牌。 → 团队运营和生产： api_key模式下部署到我的验证。在服务器端管理令牌。

验证模式

模式｜用途｜设置｜ |:--|:--|:--| | hubspot_token（默认）｜个人使用·验证｜不需要设置。在授权题头上发送令牌 | api_key ｜团队运营、正式生产｜ AUTH_MODE=api_key, API_KEY=xxx, HUBSPOT_ACCESS_TOKEN=xxx |

自己部署

验证（默认值）

git clone https://github.com/DaisukeHori/hubspot-ma-mcp.git
cd hubspot-ma-mcp
cp .env.example .env.local
# .env.local を編集
npm install
npm run dev


Cloudflare Workers（代替）

相同的 lib/（130工具+HubSpot客户端）在Cloudflare Workers上运行的结构。由于I/O等待时间不收费，因此在外部API调用较多的应用中成本效率较高。

git clone https://github.com/DaisukeHori/hubspot-ma-mcp.git
cd hubspot-ma-mcp
npm install
npx wrangler login        # Cloudflare アカウントにログイン
npm run deploy:cf          # wrangler deploy


设置环境变量（密码）：

# hubspot_token モード（デフォルト）: 設定不要。クライアントがBearerでトークンを渡す
# api_key モード: 以下を設定
npx wrangler secret put MCP_API_KEY
npx wrangler secret put HUBSPOT_ACCESS_TOKEN
# AUTH_MODE は wrangler.jsonc の vars で変更

MCP接続先:

• Vercel版: https://hubspot-ma-mcp.vercel.app/api/mcp
• Workers版: https://hubspot-ma-mcp..workers.dev/mcp

认证方法、工具和行为都相同。

技术栈

Next.js 15/Cloudflare Workers/TypeScript/Cloudflare Agents SDK/MCP SDK/HubSpot API v3-v4/Zod

许可证

MIT许可证

______________________________________________________________________

相关MCP服务器

堀公开的MCP服务器群。全部可从Claude.ai/Cursor/ChatGPT等MCP客户端使用。

｜服务器｜工具数｜说明｜ |:--|:--:|:--| | b2cloud api 大和B2云发票发行API/MCP | 云闪mcp |69 | Cloudflare統合（隧道/DNS/工人/页面/R2/KV/SSL/访问）| | 马mcp ← 今ここ | 129 | HubSpot MA（客户关系管理/营销/知识库）| | msgraph mcp服务器 |48 | Microsoft Graph API（Exchange/Teams/OneDrive/SharePoint）| | 剧作家devtools mcp 浏览器自动化 | proxmox mcp服务器 | 35 | Proxmox VE反想化基盘操作| | 打印机mcp服务器 ｜—｜CUPS网络打印机控制（Kyocera TASKalfa）｜ | yamato打印机mcp服务器 '-大和发票热敏打印机（胶皮+WS-420B） | ssh-mcp服务器 10个SSH客户端（会话管理/异步命令） | mac远程mcp \[34\]\[macOS远程控制（Shell/GUI/文件/应用程序）\] | 双子座图像mcp | 4 | Gemini/Imagen 画像生成 | | runpod mcp |36 | RunPod GPU FaaS（Pod/端点/作业）| | 耐火材料 \_自动主机网络扫描 | 广告运营mcp | 62 |廣告运用自动化（Google Ads/Meta/GBP/X）|