HubSpot MCP 新定价:公开评论回写 CRM,取数实测加写入示例

按 HubSpot 无头定价,让 Claude 把客户公开评论写回 CRM:200 个客户每周接口费最多 $0.90,重试不另扣费;写入部分是配置示例。

手绘插图:纸白方格底上,左边一列是两只对话气泡和一张评论卡,点线把它们引到中间一只敞口的卡片箱,箱里竖插着六张索引卡,只有一张卡的标签是黄色;箱子上方悬着一枚橡皮章,章面下压着一道黄色印痕,右下角挂着一把黄色钥匙。

同一条 Reddit 招聘帖被一个人发进 7 个版块,正文里同时提到 Zapier 和 Calendly,于是在我们 2026-11-22 中午取的两家客户的数据里各出现 7 次:不按内容 ID 去重,Claude 会在 HubSpot 两家公司的记录上把同一段话各写 7 遍,共 14 条。这是我们给 3 家假设的 CRM 客户(Calendly、Zapier、Typeform)取公开评论和帖子时看到的,取数走 EveryInfra 的 linkedin/company_posts、trustpilot/reviews、reddit/search,每家 3 次调用,接口费 $0.0045,返回 81,122 到 101,389 字节。写回走 HubSpot MCP server:HubSpot 在 2026 年 11 月 17 日公布的无头定价把这件活分成三种计费,Claude 连接器里的日常读写随席位附送,自建 agent 调 API 占套餐自带的 API 额度、不扣 HubSpot Credits,HubSpot 正在做的受管环境按 Credits 计费(HubSpot:HubSpot is headless. Here's how we'll price it)。按我们的实测换算,每周给 200 个客户各取一次是 600 次调用、接口费最多 $0.90;HubSpot 一侧走批量 API 约 6 次请求,占入门版每日 25 万次额度的 0.0024%,走 Claude 连接器则要分 40 批、每批最多 10 条记录。取数是真实调用;HubSpot 一侧的写入和去重按 HubSpot 公开文档写成配置示例,我们没有在真实 HubSpot 账号上跑过。

示意插图:左边一条传送带运来许多印着对话气泡和星星的小卡片,其中几摞是一模一样的副本;中间一台分拣机读取每张卡上的铜牌,相同的副本掉进旁边的废料箱,每种只放行一张;右边一只木制卡片柜拉开一格,新卡片放进去;一条回流滑道从分拣机绕回传送带,滑道上的小闸门是关着的。
取数、去重、写回:重发的卡片在闸门前被拦下,同一条内容只进柜一次。

HubSpot 无头定价:三条路各按什么计费

HubSpot 把「不打开 HubSpot 界面、从别的 AI 工具里用 HubSpot」叫作无头(headless)。2026-11-17 发在公司新闻页的那篇定价说明开头只有三句话:每个席位自带足够的无头访问,日常工作在 Claude 或 ChatGPT 里完成不另收费;第三方 agent 接 HubSpot 现有的 API,占套餐已经包含的 API 额度,不消耗 Credits;想给第三方 agent 加强治理、完整追踪和专用工具的团队,这部分用量按 HubSpot Credits 计费(HubSpot:pricing-headless)。

路线接的是什么怎么计费写入限制(公开文档)
连接器日常使用Claude、ChatGPT、Gemini、Microsoft Copilot 的 HubSpot 连接器,HubSpot MCP server,Agent CLI随 HubSpot 席位附送;用量超出席位自带部分时,以后可以用 Credits 扩容Claude 连接器批量建或改记录每次最多 10 条;不能删除;写入记进审计日志
自建或买来的 agent 调 API现有 CRM API,和普通集成一样占套餐自带的每日 API 额度,不扣 Credits;额度不够可以加购私有应用每 10 秒 100 或 190 次;每天 25 万到 100 万次
受管环境(在建)HubSpot 专为 agent 做的 API 和权限、日志规模化工作(例如补全记录、个性化外联)按 Credits 计费公告没有给出费率、名称和上线日期

公告没有给任何价格。Credits 的单价在 HubSpot 的 Credits 页和产品目录里:每个 $0.010,1,000 个一包每月 $10,或者按用量付费、以 10 个为单位开票(HubSpot Credits;HubSpot 产品与服务目录)。Sales Hub 入门版、专业版、企业版每月自带 500、3,000、5,000 个 Credits,月底清零、不结转(HubSpot:Sales Hub 定价)。公告没有说「日常使用」到多少次算超出,也没有给受管环境的费率;IMPACT 的作者在 11 月的文章里提了同一个问题:一位销售经理每天早上让 Claude 分析 100 个交易,算不算日常(IMPACT)。

把「回写评论」这件活放进三条路

这件活的输入是 CRM 里 200 家客户公司的域名和 LinkedIn 主页短名,输出是每家公司一条「本周公开动态」笔记,加三个公司属性(低分评价数、最近一次写入的周次、本周摘要笔记的 ID)。取数不经过 HubSpot:评论和帖子来自 LinkedIn、Trustpilot、Reddit 这些公开网站,由 EveryInfra 的接口取回,HubSpot 只负责存。按 HubSpot 的分法,同一件活可以落在两条路上:坐在 Claude 里点着做,属于第一条,随席位附送;写成每周自动跑的脚本,用服务密钥(service key)调 CRM API,属于第二条,占 API 额度。服务密钥 2026 年起取代了旧版私有应用的位置,按对象授权 scope,和私有发布的应用共用同一套限额;一个账号里应用、服务密钥和 MCP 连接器合计最多 100 个(HubSpot 开发者文档:service keys;Authentication overview)。第三条要等 HubSpot 的受管环境上线,现在用不上。

两条路的差别在写入的批量和确认方式上。HubSpot 的 Claude 连接器帮助页写明,批量创建或更新记录每次只能 10 条,建议把写工具设成「需要批准」,否则编辑可能不经确认直接发生(HubSpot 知识库:Set up and use the HubSpot connector for Claude)。200 家公司要更新属性、各加一条笔记,在连接器里是 20 批属性加 20 批笔记,共 40 次批准。CRM API 的批量接口每次收 100 条,同样的写入是 2 次属性更新、2 次笔记写入(新建或修改),再加 2 次按属性筛公司的搜索请求(HubSpot:Search the CRM),一周 6 次请求。

横向条形图,对数刻度,每格 10 倍:HubSpot 每日 API 额度入门版 250,000 次、专业版开发者文档写 625,000 次、产品目录写 650,000 次、企业版 1,000,000 次;最下面一根是本文每周回写 200 个客户用到的 6 次请求,比入门版每日额度小四个数量级以上。

两份 HubSpot 页面对专业版额度写法不同

开发者文档「API usage guidelines and limits」的表里,私有应用的每日额度是入门版及免费版 250,000 次、专业版 625,000 次、企业版 1,000,000 次,每 10 秒的突发上限是 100、190、190 次,突发上限按应用算,每日额度由同一账号的所有应用共享;买了 API 加量包的,每 10 秒 250 次,每包每天再加 1,000,000 次,最多买两包(HubSpot 开发者文档:API usage guidelines)。产品目录的「Technical Limits」页写的是专业版 650,000 次,加一包 1,650,000 次、加两包 2,650,000 次,每包每月 $500;同一页的表把加包后的突发上限写成 350、600、440、690 次每 10 秒,表上面的一句话又说加包后是每 10 秒 250 次(HubSpot 产品目录:Technical Limits)。以上是我们 2026-11-22 读到的两页内容,PPC Land 的报道也指出了目录里突发上限的前后矛盾。这些差别对这件活没有影响:一周 6 次请求,离最小的每日额度也差四个数量级以上。要按额度做容量规划的团队,以账号里「开发 → 监控 → API 调用用量」页显示的数为准,429 响应里的 policyName 会说明碰到的是每日上限还是每 10 秒上限。

档位每 10 秒(每个私有应用)每天(开发者文档)每天(产品目录)加一包后每天
免费版、入门版100250,000250,0001,250,000
专业版190625,000650,0001,650,000
企业版1901,000,0001,000,0002,000,000
上架应用市场的公开 OAuth 应用110(每个安装账号)———

开发者文档还有两条和 agent 有关:每日额度按账号时区的午夜重置;出错的请求不应超过每日总请求的 5%,想上架应用市场必须守住这条线(HubSpot 开发者文档:usage guidelines)。一个每周跑一次的回写脚本,5% 这条线比额度更容易碰到:写错一个属性名、关联类型 ID 填错,整批都会报错。

HubSpot MCP server 是什么:URL、授权和能写什么

HubSpot MCP server 的地址是 https://mcp.hubspot.com,2026-04-13 结束测试、对所有账号开放,同时加了写权限(HubSpot 开发者 changelog,2026-04-13)。HubSpot 自己给 Claude、ChatGPT、Gemini、Microsoft Copilot 做的连接器也跑在这台服务器上(HubSpot 开发者文档:Using the HubSpot MCP server)。它和开发者 MCP server 是两样东西:开发者 MCP server 在本机跑,帮你写 HubSpot 应用和 CMS 代码,不读写 CRM 记录(HubSpot 开发者文档:developer MCP server)。在 GitHub 或 npm 上搜「hubspot mcp server」找到的,多半是后者或第三方项目。

授权只有 OAuth 一种。集成文档要求 OAuth 2.1 加 PKCE,和 MCP 规范的授权一节一致(MCP 规范:Authorization;RFC 7636),客户端要先在 HubSpot 账号的「开发 → MCP 连接器」里建一个连接器,拿到客户端 ID 和密钥,填好回调地址(HubSpot 开发者文档:Integrate AI tools with the HubSpot MCP server,2026-11-20 修改)。HubSpot 开发者博客 2026-11-12 那篇教程补了一句:MCPJam 的表单把客户端密钥标成可选,HubSpot 这台服务器其实要求填(HubSpot 开发者博客:Connect HubSpot's MCP Server With Any AI Tool Securely)。我们在 2026-11-22 12:43(新加坡时间)不带令牌请求了一次 https://mcp.hubspot.com/,拿到 401,响应头指向它的受保护资源元数据;元数据里 scopes_supported 是空数组,授权服务器元数据只接受 S256 的 PKCE、密钥用 client_secret_post 传,授权方式除了 authorization_code 和 refresh_token,还列了 client_credentials 和 JWT bearer。文档没有讲后两种怎么用,本文只按授权码流程写。自己接其他 MCP 客户端前,可以先用 MCP Inspector 连一次,看授权流程能不能走通、工具清单里有什么。自助建 MCP 连接器这个入口 2026-01-20 以公开测试版上线(HubSpot changelog:Self-Service MCP Auth Apps);Claude 连接器能读的对象 2025-08-28 起扩到了报价、发票、订单、产品等(HubSpot changelog:Claude connector additional objects)。

终端截图:2026-11-22 12:43 不带令牌 POST https://mcp.hubspot.com/ 返回 HTTP 401,www-authenticate 头指向受保护资源元数据;下面是元数据原文,scopes_supported 为空数组,code_challenge_methods_supported 只有 S256,token_endpoint_auth_methods_supported 是 client_secret_post,青绿框标出这三处。
HubSpot MCP server 的 401 和 OAuth 元数据,2026-11-22 新加坡时间 12:43 的真实返回,截图已去掉 Cloudflare Cookie。 | source: 本文实测 https://mcp.hubspot.com/.well-known/oauth-authorization-server

权限范围不在连接器上配。集成文档写得很直接:建 MCP 连接器时你不指定 scope,可用的 scope 由安装时服务器上有哪些工具、用户在授权页勾了哪些权限两件事决定;服务器加了新工具、scope 变了,已经装好的用户要重新安装才能拿到新权限。所有操作都受用户自己在 HubSpot 里的权限约束,看不到的记录 Claude 也看不到。账号开了敏感数据功能的,通话、邮件、会议、笔记、任务这些活动对象会被 MCP server 挡住,这条只针对 MCP server,普通 CRM API 不受影响(HubSpot changelog,2026-04-13)。本文要写的笔记就是活动对象,开了敏感数据的账号只能走 API 那条路。

对象MCP server 读MCP server 写Claude 连接器写本文用到
公司是建、改建、改,不能删改三个属性
笔记(活动)是建、改建、改,不能删每家公司每周一条摘要
属性是建自定义属性建,不能改建 3 个属性
社交帖子读已连接的社交账号草稿、排期建、改不用:HubSpot 只看得到你自己连接的社交账号

社交帖子这一行不用,原因是 HubSpot MCP server 能读的社交数据只有你自己连到 HubSpot 的社交账号、你自己排期和发布的帖子及其表现(HubSpot 集成文档)。客户公司在 LinkedIn 上发了什么、用户在 Trustpilot 和 Reddit 上怎么说这家公司,HubSpot 里没有,要从公开网站取回来。

在 Claude 里同时接 HubSpot MCP 和 EveryInfra MCP

在 Claude 里有两种装法。网页版、桌面版、手机版 Claude 用 HubSpot 自己的连接器:Claude 设置 → 连接器 → 浏览 → 搜 HubSpot → 连接,登录 HubSpot 账号,在授权页勾权限;要求是付费的 Claude 账号(Pro、Max、Team 或 Enterprise),账号里不是超级管理员的用户,要先等超级管理员批准这个连接器、选好它能访问哪些数据(HubSpot 知识库:Claude 连接器;HubSpot 知识库:Manage access to apps)。EveryInfra 在 Claude 里按自定义连接器加,地址填 https://api.everyinfra.com/mcp(Claude 帮助中心:custom connectors;EveryInfra MCP 接入)。Claude Pro 按月付是每月 $20,按年付折合每月 $17(Claude 定价,2026-11-22 读取)。

Claude Code 里两台服务器都用命令加。HubSpot 不支持动态注册客户端,要用预先建好的连接器凭据;Claude Code 的 --client-id 加 --client-secret 会在终端里遮着输入密钥,密钥存进 macOS 钥匙串或凭据文件,不写进配置;回调端口要和你在 HubSpot 连接器里填的回调地址一致,形如 http://localhost:8080/callback(Claude Code 文档:MCP)。下面是配置示例,HubSpot 一侧我们没有在真实账号上跑:

bash
# 1) HubSpot MCP server:先在 HubSpot「开发 → MCP 连接器」建连接器,回调地址填 http://localhost:8080/callback
claude mcp add --transport http \
  --client-id "$HUBSPOT_MCP_CLIENT_ID" --client-secret --callback-port 8080 \
  hubspot https://mcp.hubspot.com/
# 之后在 Claude Code 里输入 /mcp,按浏览器提示登录 HubSpot、勾权限

# 2) EveryInfra 远程 MCP:Key 只放在环境变量里,配置文件里写变量名
export EVERYINFRA_API_KEY=...   # 写进 shell 配置或密码管理器,不进仓库
claude mcp add-json everyinfra \
  '{"type":"http","url":"https://api.everyinfra.com/mcp","headers":{"Authorization":"Bearer ${EVERYINFRA_API_KEY}"}}'

${EVERYINFRA_API_KEY} 由 Claude Code 在连接时展开,.mcp.json 可以提交进仓库而不带出 Key。文档提醒一种坑:远程服务器的 url 和 headers 里,ANTHROPIC_AUTH_TOKEN 这类 Claude 自己的凭据变量会被读成空值,目的是防止一个项目的配置把你的 Claude 凭据发给它指定的服务器;自己起的变量名不受影响(Claude Code 文档:MCP)。权限按工具收窄:HubSpot 的读工具放行,写工具一律设成询问;EveryInfra 的 everyinfra_call_api 会扣费,也可以设成询问,everyinfra_list_capabilities、everyinfra_get_job 不扣费,可以放行(Claude Code 文档:permissions)。

Claude Code 对远程 MCP 每次请求到首字节有一个计时器,取 60 秒、工具超时和 MCP_TIMEOUT 三者里最大的一个(Claude Code 文档:MCP)。我们这轮三家客户 9 次正常取数,同步返回用时 4.2 到 13.0 秒,都在线内;同一类能力取 200 条以上时,按目录说明加 "mode":"async",拿到 job_id 后用免费的 everyinfra_get_job 取结果。

实测:3 家客户的公开评论和帖子

三轮调用都用 EveryInfra 的 REST 接口,Key 只经环境变量注入,原始响应全部留存;目录在 2026-11-22 12:42(新加坡时间)读取,当时 106 个平台、714 项能力、683 项可用。三家公司都是公开的软件公司,只当作「CRM 里的客户」样本,和本文的 HubSpot 配置没有关系。三轮调用分在 12:43、12:45 到 12:50、13:03 到 13:07 三个时段,前后 24 分钟,共 31 次请求,其中 18 次扣费,合计 $0.0196;其余 13 次是 429 限速、422 参数错误、409 幂等冲突、幂等回放和空结果,都没有扣费。每家取三样:LinkedIn 公司主页最近 20 条动态(linkedin/company_posts,每次 $0.002319)、Trustpilot 最近 30 天的评价(trustpilot/reviews,每次 $0.001389,date=last30days)、Reddit 最近一个月提到品牌名的帖子(reddit/search,每次 $0.000792,sort=newest)。

新加坡时间客户LinkedIn 动态Trustpilot 30 天评价Reddit 帖子返回字节接口费
12:43–12:44Calendly20 条,2026-08-28 到 11-18,公司自己发 13 条26 条,1 星 5 条,公司回复 014 条,标题带品牌名 1 条81,122$0.0045
12:45–12:49Zapier20 条,2026-11-17 到 11-21,公司自己发 8 条9 条,全部 1–2 星,公司回复 025 条,标题带品牌名 10 条90,841$0.0045
13:03–13:07Typeform20 条,2026-10-09 到 11-20,公司自己发 9 条;第一次按短名 typeform 取到的是同名的另一家公司19 条,1 星 5 条,公司回复 10 条22 条,标题带品牌名 0 条,16 条只是正文贴了表单链接101,389$0.0045
分组柱状图:三家客户各三类公开数据的条数。Calendly:LinkedIn 20、Trustpilot 26、Reddit 14;Zapier:LinkedIn 20、Trustpilot 9、Reddit 25;Typeform:LinkedIn 20、Trustpilot 19、Reddit 22。每家合计 54 到 60 条,三家接口费都是 $0.0045。

第一轮里有一次故意写错的请求:12:44(新加坡时间)把 Trustpilot 的 date 写成 last14days,0.74 秒回 422,错误体列出 5 个允许值,did_you_mean 给了 last7days 和 last30days,next_steps 第一句是只改 date 再发、这次没有扣费。第二轮开始碰上了限速:这把测试 Key 每分钟 10 次,和同一时段其他测试共用,12:45 到 12:50 之间有 8 次请求回 429,每次 0.12 到 0.17 秒返回,响应头带 retry-after,都没有扣费;脚本等 60 秒后重发,全部拿到了结果。

一家公司一周会冒出几条新内容

回写的频率由新内容的速度决定。Calendly 的 20 条 LinkedIn 动态横跨 2026-08-28 到 11-18,最近 7 天只有 1 条;Zapier 的 20 条全落在 11-17 到 11-21 这 5 天里,最近 7 天就有 20 条,按每周取 20 条会漏。Trustpilot 那边,Calendly 30 天 26 条里最近 7 天 11 条,Zapier 30 天 9 条里最近 7 天 4 条。所以 limit 不能一刀切:按上一周的新增条数调,新增数等于上限的,下次加大上限或改成每三天取一次。linkedin/company_posts 按次计费,取 10 条和取 50 条都是 $0.002319,对 Zapier 这类发帖密的公司,直接按 50 条取;目录说明里写着部分请求最多只返回 20 条,返回数等于 20 时也按「可能漏了」处理。

LinkedIn 公司动态还有一个要过滤的地方。Calendly 的 20 条里 7 条、Zapier 的 20 条里 12 条,作者是员工或合作公司,公司页只是把帖子转发出来,author_username 和公司短名对不上、author_type 多为 profile。写进 CRM 时要分开:公司自己的公告放「公司动态」,员工个人的帖子要么丢掉,要么只记链接,不把员工的观点写成公司的表态。员工姓名属于个人信息,笔记里只写「员工帖」和链接。

Trustpilot:低分评价没有人回

Calendly 最近 30 天的 26 条评价里,19 条 5 星、5 条 1 星,18 条是公司邀请来的(verification_level: invited);5 条 1 星都是用户自己找上门写的,讲的是工单拖了几个月、升级后找不到功能、不列颠哥伦比亚省时区切换出错、核心功能宕机没人回、取消订阅难。Zapier 30 天里只有 9 条,全是 1 到 2 星,讲取消订阅、未用月份不退款、认证合作伙伴不负责。两家 35 条评价里,有公司回复的是 0 条。Typeform 的情况不同:19 条里 10 条有公司回复,回复全落在 11-13 及更早的评价上,最近 7 天的 6 条(含 2 条 1 星)还没有回复。客户成功团队可以据此在续约前看到:这家客户的用户在公开评价里集中提到哪些问题、公司有没有回应。

Typeform 的数据还说明一件事:公司回复会晚到一两周。同一条评价这周取到时没有回复,下周再取可能就有了。按评价 ID 记在脚本的本地库里,下周重取时更新同一行,把「公司已回复」补进下一期摘要;只看「本周新增」、不回头更新的,记录里会永远写着「未回复」。所以单条内容的去重键用「平台 + 内容 ID」,不用「客户 + 周次」。

Reddit:同一条帖子出现在两家客户名下

reddit/search 按品牌名搜最近一个月的帖子,命中规则是标题或社区名里有关键词,或者正文里凑齐这些词。Calendly 的 14 条里只有 1 条标题带「Calendly」,是一个开源排程工具的讨论;Zapier 的 25 条里 10 条标题带「Zapier」。两家结果里都有同一组帖子:一个自由职业者把「[FOR HIRE] AI Workflow Automation (Zapier and Make.com)」发进 7 个求职版块,正文里列了 Calendly 和 Zapier 两个技能。按内容 ID 比,Calendly 和 Zapier 的 Reddit 结果重叠 7 条;按标题加正文前 400 字的哈希分组,Calendly 14 条只有 8 种不同内容,Zapier 25 条有 19 种。

堆叠条形图:三家客户 Reddit 结果的去重情况。Calendly 14 条去重后 8 种内容,Zapier 25 条去重后 19 种,Typeform 22 条去重后 19 种,其中 16 条只是正文里贴了 typeform.com 的表单链接;Calendly 和 Zapier 之间有 7 条是同一组帖子。

只按「客户 + 帖子 ID」去重,两家公司的记录上各写 7 条,共 14 条内容相同;按「平台 + 帖子 ID」全局去重,脚本里只剩 7 条,每条标上两家客户。这 7 条是同一段文字发在不同版块,再按正文哈希合并,只剩 1 条,附 7 个链接。哪一层合并由你的用途决定:做声量统计的,7 个版块算 7 次曝光;做客户档案的,1 条就够,还要判断这条招聘帖跟客户公司有没有关系,多数情况下没有,直接丢掉。

Typeform 的 Reddit 结果是另一种噪声。22 条里标题带「Typeform」的是 0 条,16 条只是正文里贴了一个 typeform.com 的问卷或报名表链接:社区调查、招聘报名、产品内测登记。按名字讨论这家公司的只有 6 条:3 条是同一份第三方整理的企业清单帖,Typeform 在名单里;1 条是某个 AI 助手产品新上线的连接器名单;1 条是表单工具对比;1 条是用户说自己用别的工具换掉了 Typeform。筛选规则要加一条:品牌名只出现在链接里的帖子直接丢掉。第三方清单这类没有出处可核的帖子,转给客户负责人看,不写成事实。

LinkedIn 短名:按公司名取,取到了同名公司

Typeform 这一家的第一次调用出了岔子。13:03(新加坡时间)我们按公司名传 company: typeform,linkedin/company_posts 返回 0 条,reason 是 empty_result_refunded,没有扣费。为了弄清原因,13:05 用 linkedin/company_profile($0.000556)查了这个短名:它属于都柏林一家 1983 年成立的平面设计公司,官网 typeform.ie,25 名员工、1,800 个关注者,跟做表单的 Typeform 没有关系。搜索 LinkedIn 后,表单公司的短名是 typeform-,结尾多一个连字符;13:07 换成这个短名重取,拿到 20 条动态。

这次返回空结果,没扣费。如果同名公司正好在发帖,脚本会把另一家公司的新闻写进你的客户记录,没有任何报错。避免的办法是把 LinkedIn 主页 URL 当成 CRM 里的一个公司属性(例如 ei_linkedin_slug)单独存,不从公司名推;第一次取数前先调一次 linkedin/company_profile,拿返回的 website 跟 HubSpot 公司记录的 domain 比,对不上就不写,标给人核对。按每次 $0.000556 算,200 家客户这样核一遍是 $0.11,只做一次,之后每周只核新加入名单的客户。

一家客户回写前有多少字节

三家客户每家三次调用返回 81,122 到 101,389 字节,按 4 字节约 1 个 token 粗算,约 2.0 万到 2.5 万 token。200 个客户原样塞进 Claude 的上下文是 400 万 token 以上,一个对话放不下,也没必要:写进 CRM 的只是每家一段几百字的摘要和几条链接。把取数和筛选放在脚本里做(按 ID 去重、丢掉非公司作者、只留最近 7 天),每家只把筛完的几条交给 Claude 写摘要,上下文能降到每家几千 token。

堆叠条形图:每家客户三次调用返回的字节数。Calendly:LinkedIn 26,613、Trustpilot 23,288、Reddit 31,221,合计 81,122;Zapier:35,688、13,429、41,724,合计 90,841;Typeform:31,376、22,731、47,282,合计 101,389。按 4 字节约 1 token,每家约 2 万 token。

我们另外经远程 MCP 调了一次,确认 Claude 那条路上拿到的是同一份数据。13:05:24(新加坡时间)我们用 JSON-RPC 的 tools/call 调 everyinfra_call_api,取 Zapier 最近 7 天的 Trustpilot 评价:返回 4 条、全部 1 星,扣 $0.001389,和 REST 单价相同,字段也一样。这次用了 74.6 秒,同一能力走 REST 的三次是 8.6 到 13.0 秒。只有一次样本,不能说明 MCP 一定更慢,但它已经超过 Claude Code 默认的 60 秒首字节计时器(这次响应是一次性返回的 JSON,首字节和总用时差不多)。在 Claude Code 里接 EveryInfra,把 MCP_TIMEOUT 设到 120000 毫秒,或者对评价、动态这类能力加 "mode":"async",再用 everyinfra_get_job 取结果。

终端截图:2026-11-22 13:05:24 用 JSON-RPC 的 tools/call 调 everyinfra_call_api,参数是 trustpilot reviews、zapier.com、last7days;13:06:39 返回 HTTP 200,总用时 74.6 秒,count 4,charged_usd 0.001389;下面 4 条评价都是 1 星,评价人姓名打码。青绿框标出用时和计费两行。
经 EveryInfra 远程 MCP 的一次真实往返,个人姓名已打码。 | source: 本文实测 https://api.everyinfra.com/mcp

重试不重复扣费:EveryInfra 一侧

每周跑的回写脚本一定会遇到重试:429 限速、网络断开、Claude Code 的首字节计时器到点、HubSpot 写入失败后整批重来。EveryInfra 的规则有三层。第一层,失败和空结果不扣费:12:50(新加坡时间)我们拿一个凑出来的词搜 Reddit,返回 0 条,charged_usd 为 0,reason 是 empty_result_refunded,预扣的 57 个单位当场退回;429、422、409 都没有扣费(EveryInfra OpenAPI;失败退费对账)。

第二层是 Idempotency-Key 请求头。OpenAPI 的说明是:每个逻辑请求用一个新键,1 到 255 个可见 ASCII 字符;同步调用在 24 小时内用同一个键、同样的平台、能力和参数再发,回放第一次成功的响应,replayed: true,响应头 Idempotent-Replayed: true,不再执行、不再扣费;参数不同回 409 idempotency_conflict;第一次还没跑完回 409 idempotency_in_progress 并带 Retry-After;第一次没成功的,键会释放(EveryInfra OpenAPI)。我们在 12:49 实测了三步:

bash
K="hs-weekly-2026w47-zapier-profile"   # 周次 + 客户 + 能力,同一周重跑用同一个键
curl -s https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $K" \
  -d '{"platform":"linkedin","action":"company_profile","params":{"company":"zapier"}}'
# 12:49:16 第一次:200,9.32 秒,id req_253a4b3503e5441a,charged_usd 0.000556
# 12:49:34 同键同参数重发:200,0.58 秒,同一个 id,replayed: true,响应头 idempotent-replayed: true
# 12:49:43 同键换成 calendly:409 idempotency_conflict,0.13 秒,next_steps 写明没有扣费
终端截图:三次带同一个 Idempotency-Key 的真实请求。第一次 200、9.32 秒、charged_usd 0.000556;第二次 200、0.58 秒、同一个请求 id、replayed true、响应头 idempotent-replayed: true;第三次换了参数,409 idempotency_conflict,错误说明写着没有扣费。青绿框标出 replayed 和 409 两处。
同一个键重发拿回原响应,换参数被拒,2026-11-22 新加坡时间 12:49 的真实返回。 | source: 本文实测 https://api.everyinfra.com/api/v1/social

回放的响应里 billing.charged_usd 仍是 0.000556,那是第一次响应的原样副本,id 也和第一次相同;账单上只有一笔。键怎么起名决定了「什么算同一次」:用「周次 + 客户 + 能力」,同一周内无论重跑几次都只扣一次,下一周换键重新取;用随机 UUID,每次重跑都是新请求,等于没加。IETF 的 HTTP API 工作组正在把这个请求头写成标准,草案第 9 版 2026-11-21 发布,定义和我们的用法一致:键由客户端生成,服务端用它认出同一请求的重试(IETF:draft-ietf-httpapi-idempotency-key-header-09)。HTTP 语义规范把 POST 列为非幂等方法,所以不带键的 POST 重发,服务端只能当成新请求(RFC 9110)。

第三层在远程 MCP 上。everyinfra_call_api 这个工具的参数里没有幂等键,Claude 在对话里重试同步调用,每次都算一次新请求;异步提交(mode: async)在 5 分钟内参数完全相同的会合并,返回原来那个任务,不另扣费。每周的批量回写放在脚本里走 REST 加 Idempotency-Key,Claude 只负责读筛完的数据、写摘要、提交 HubSpot 写入。

HubSpot 一侧怎么防重复写入:按文档的写法,未实跑

HubSpot 的 CRM API 没有请求级的幂等键。r/hubspot 一位用 Claude Code 跑了三周 HubSpot 的用户把这条列在他的 7 个坑里:建自定义属性时属性已存在就回 409,服务端没有幂等键,只能自己吞掉 409;同一帖子还提到,PATCH 一个交易时只带一个字段,其他两个相关字段被清空,笔记的 hs_timestamp 不是带 Z 的 UTC 格式会失败(Reddit r/hubspot,2026)。这些是一位用户的经验,后两条我们在 HubSpot 文档里没有找到对应说明,配置前先在测试账号上复现。

HubSpot 文档里能直接拿来去重的有三样。第一样是记录 ID:每条记录建好就有 hs_object_id,按 ID 更新同一条记录不会新增;公司还有域名,公司文档建议建公司时总带上 domain,它是避免重复公司的主要唯一标识(HubSpot:Companies API)。第二样是唯一值属性:属性文档写明每个对象最多 10 个唯一 ID 属性,建属性时把 hasUniqueValue 设为 true,之后可以用 idProperty 按它取记录(HubSpot 开发者文档:Properties API);知识库补充说这个设置只能在建属性时打开,目前不支持反馈提交、营销活动和产品三类对象(HubSpot 知识库:Set validation rules for a property)。第三样是搜索:笔记属于可搜索的活动对象,搜索接口能用 associations.company 这个伪属性筛出挂在某家公司上的记录;文档也提醒,新建或刚改过的记录要过一会儿才出现在搜索结果里,搜索接口每个账号每秒限 5 次(HubSpot:Search the CRM)。

笔记上能不能建唯一值属性,文档没有写明。笔记有一个「按唯一属性值批量 upsert」的接口(HubSpot:Upsert notes),知识库的排除名单里也没有笔记,但没有一页明说可以在笔记上建 hasUniqueValue 自定义属性;我们没有 HubSpot 账号,没有试。所以下面的主方案只用有明文的做法:单条内容在脚本本地去重,每家公司每周写一条摘要笔记,笔记 ID 和周次记在公司的自定义属性上,重跑时按笔记 ID 改同一条。

写什么去重键写入方式重跑一次的结果
一条公开内容平台 + 内容 ID,例如 reddit:t3_1y2fct9,存在脚本本地库不单独写进 HubSpot,进当周摘要本地库已有就只更新状态,例如「公司已回复」
笔记:本周摘要公司记录 ID + 周次;笔记 ID 记在公司属性 ei_digest_note_id本周还没有:notes/batch/create,建时带公司关联;已有:notes/batch/update 按笔记 ID 改改同一条笔记,不新增
公司:ei_low_reviews、ei_digest_week、ei_digest_note_id公司记录 ID(hs_object_id)companies/batch/update同值覆盖,无副作用
笔记和公司的关联新建笔记时在请求体里带上类型 ID 190(笔记到公司),只在新建时带改笔记不重建关联
text
# 1) 第一步的公司搜索里一并带回:本周写过没有、摘要笔记 ID 是多少
POST https://api.hubapi.com/crm/objects/2026-09/companies/search
{ "filterGroups": [ { "filters": [ { "propertyName": "ei_linkedin_slug", "operator": "HAS_PROPERTY" } ] } ],
  "properties": [ "domain", "ei_linkedin_slug", "ei_digest_week", "ei_digest_note_id" ], "limit": 100 }

# 2a) ei_digest_week 不是本周:新建摘要笔记,建的同时关联到公司
POST https://api.hubapi.com/crm/objects/2026-09/notes/batch/create
{ "inputs": [ { "properties": { "hs_timestamp": "2026-11-22T04:45:00Z",
      "hs_note_body": "2026-W47 · Zapier · 本周公开动态:……" },
    "associations": [ { "to": { "id": "8812345" },
      "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 190 } ] } ] } ] }

# 2b) ei_digest_week 已是本周:按 ei_digest_note_id 改同一条
POST https://api.hubapi.com/crm/objects/2026-09/notes/batch/update
{ "inputs": [ { "id": "<ei_digest_note_id>", "properties": { "hs_note_body": "2026-W47 · Zapier · ……" } } ] }

# 3) 把笔记 ID、周次和低分评价数写回公司
POST https://api.hubapi.com/crm/objects/2026-09/companies/batch/update
{ "inputs": [ { "id": "8812345", "properties": {
    "ei_digest_week": "2026-W47", "ei_digest_note_id": "<新笔记 ID>", "ei_low_reviews": "4" } } ] }

上面是配置示例,没有在 HubSpot 账号上跑过。这套写法有一个空档:脚本在 2a 建完笔记、还没走到第 3 步就中断,公司上没有记下笔记 ID,重跑会再建一条。补法是重跑时对 ei_digest_week 不是本周的公司,先按 associations.company 加本周的 hs_timestamp 范围搜一次笔记,找到正文以「2026-W47 ·」开头的,就把它的 ID 补写回公司、改走 2b;搜索结果有延迟,中断后隔几分钟再重跑。如果你的测试账号能在笔记上建 hasUniqueValue 属性,可以换成 notes/batch/upsert 加 idProperty,一步写完、没有这个空档,用之前先在测试账号里确认。笔记正文最长 65,536 个字符,时间字段 hs_timestamp 必填;关联到公司用 HUBSPOT_DEFINED 类别、类型 ID 190,关联到交易是 214(HubSpot 开发者文档:Notes API)。

在测试账号里验这套写法,看三件事,任何一条不成立,就先别接生产账号。

检查怎么做通过的标准
同周重跑同一周把脚本连跑两次第二次只发 notes/batch/update、没有 notes/batch/create;公司时间线上本周摘要仍是 1 条
中断补位在 2a 和第 3 步之间停掉脚本,隔几分钟重跑搜索补回了笔记 ID,没有多出第二条
跨周换成下一周的周次再跑新建了一条新摘要,上一周那条没有被改

开发者测试账号是免费的,带 90 天的多数企业版功能试用,一个开发者账号最多建 10 个(HubSpot 开发者文档:Account types)。

走 Claude 连接器写入时,这些键同样适用,只是写法换成提示词:让 Claude 先读公司的 ei_digest_week 和 ei_digest_note_id,本周已有摘要就改那一条,没有才新建、建完把笔记 ID 写回公司,每批不超过 10 条,写之前列出要写的记录给你批准。HubSpot 建议先改一条记录再批量改,并在 Claude 的连接器工具设置里把写工具设成「需要批准」(HubSpot 知识库:Claude 连接器)。用 Claude 建或改的记录,会在 HubSpot 的审计日志里同时记到用户和 Claude 连接器名下,出了问题能查到是哪一次对话写的。

时间线流程图:每周一次回写,左边是 EveryInfra 取数,三种结果分三条线:成功的带 Idempotency-Key 写入本地缓存,重发时回放、不扣费;空结果和失败退费;429 等待后重发。右边是 HubSpot 写入(按文档的配置示例):公司上记着本周摘要笔记的 ID,重跑按 ID 改同一条,不新增;公司属性按记录 ID 覆盖。

每周脚本按什么顺序跑

一次每周回写按六步走。第一步,用服务密钥按属性搜出要处理的公司,带上记录 ID、域名、ei_linkedin_slug、ei_digest_week 和 ei_digest_note_id。第二步,对新加入名单、还没核过 LinkedIn 短名的公司,先调一次 linkedin/company_profile,官网域名和 HubSpot 的 domain 对不上的,标给人核对,本周不取。第三步,按「周次 + 客户 + 能力」生成 Idempotency-Key,依次调三种能力;遇到 429 按 retry-after 等,遇到 422 按 did_you_mean 改参数,改了参数就换一个新键。第四步,在脚本里去重和筛选:按「平台 + 内容 ID」全局去重,丢掉非公司作者的 LinkedIn 动态和只贴了表单链接的 Reddit 帖子,只留最近 7 天。第五步,每家只把筛完的几条交给 Claude 写摘要,人看一遍汇总。第六步,本周还没有摘要的公司批量新建笔记、建时带上公司关联,已有的按笔记 ID 批量改,再把笔记 ID、周次和低分评价数批量写回公司。

中途任何一步失败,整个脚本从头再跑一遍就行:第三步的同一个键回放原响应、不再扣费,第六步按公司上记的笔记 ID 改同一条、不新增,中断在建笔记和写回公司之间的,按上一节的搜索补上。HubSpot 那条「错误请求不超过 5%」的线,靠第六步之前的一次自检守住:先用一条记录试写,确认属性名、关联类型 ID 都对,再提交整批。

每周 200 个客户:两边各花多少

EveryInfra 一侧按目录单价算:每家客户每周一次 linkedin/company_posts($0.002319)、一次 trustpilot/reviews($0.001389)、一次 reddit/search($0.000792),合计 $0.0045。200 家每周 600 次调用、最多 $0.90,按一年 52 周折算每月最多 $3.90、一年最多 $46.80。「最多」是因为空结果不扣费:一家没有 Trustpilot 页面的客户,那次调用不花钱。三家实测各扣 $0.0045,没有出现空结果。

项目每周每月(×52/12)出处
EveryInfra 接口费,200 个客户 × 3 次最多 $0.90最多 $3.90目录 price_usd,三家实测各 $0.0045
HubSpot API 请求,走批量接口约 6 次约 26 次本文写法;入门版每天 250,000 次
HubSpot Claude 连接器写入批次40 批,每批最多 10 条约 173 批Claude 连接器帮助页
HubSpot Credits00不走受管环境就不扣
Claude Pro 一个席位—$20(按年 $17)Claude 定价页,2026-11-22 读取
HubSpot API 加量包用不到$500 一包产品目录 Technical Limits
横向条形图,每月美元:EveryInfra 接口费 200 个客户最多 $3.90;Claude Pro 一个席位 $20;HubSpot API 加量包一包 $500(这件活用不到);HubSpot Credits 0(不走受管环境)。

连接器路线每周 40 次批准;脚本路线把写入放进 6 次 API 请求,人只看一份汇总。同一周里一部分公司写过、一部分没写时,第六步的笔记要分新建和修改两批,200 家最多 3 批,一周合计最多 7 次请求,仍是额度的零头。HubSpot 的公告没有说一个席位的「日常使用」上限是多少,一个人每周让 Claude 改 200 家公司、建 200 条笔记,算不算超出、超出后扣多少 Credits,要等 HubSpot 公布费率。在那之前,量大的回写按 API 额度算账,额度有公开数字。

三条路怎么选

按这件活的量,可以这样分。每周只盯十几家重点客户、每条都想自己看一眼再写的,用 Claude 连接器,一周十几次批准,费用随席位。每周固定 200 家、要能随时重跑的,写脚本走 API,用一把带名字的服务密钥,每周 6 次请求,HubSpot 一侧不花额外的钱。账号开了敏感数据功能的,笔记写不进 MCP,只能走 API。受管环境上线后,要看三件事再决定要不要换过去:每次写入或每条记录扣多少 Credits;扣的是套餐自带的 Credits 还是要另买;HubSpot 会不会把现在算作 API 用量的某些 agent 用法划进受管环境。公告里这三件都还没有答案。

一条周报笔记写成什么样

笔记正文最长 65,536 个字符,够放一整周的东西,但给客户负责人看的笔记越短越好。我们给这件活定的格式是:第一行写周次和一句话结论,接着按平台分三段,每段最多 3 条,每条只写日期、要点和链接,最后一行写这次取数的请求 id,方便对账。下面是按 Zapier 这周的真实数据写的示例(评价人姓名不写):

text
2026-W47 · Zapier · 本周公开动态:Trustpilot 4 条新评价全是 1 星,主题是取消和退款;公司未回复。
LinkedIn(公司发 8 条):11-17、11-18 两条自家 AutomationBench 模型排名;11-19 纽约线下活动报名;其余 5 条是轻松内容,只记链接。
Trustpilot:11-22 1★ 自动化流程报错、未用月份不退款;11-20 1★ 取消订阅难;11-18 1★ 希望公司换工具;11-17 1★ 体验差。
Reddit:10 条标题提到 Zapier,7 条是同一自由职业者的招聘帖(已合并为 1 条,未关联客户)。
来源请求:req_b2ebb0fd3327401a(2026-11-22 13:05 SGT)

公司属性里能筛选的数有两个:ei_low_reviews 记本周 1 到 2 星评价数,ei_digest_week 记最近一次写入的周次;第三个属性 ei_digest_note_id 只给脚本防重复用。客户成功团队在 HubSpot 里按 ei_low_reviews 排序,就能看到这周哪几家客户的公开差评最多。

视频里演示了、文档里没写的

我们用 youtube/search 搜「hubspot mcp」(2026-11-22 13:03,新加坡时间),取了 5 条视频的英文字幕(每条 $0.000556,每次 3.9 到 6.1 秒):搜索结果前三条,加两条不在前十里的 Claude 加 HubSpot 入门和测评视频,其中入门那条和前三条内容重复,没有用。前三条是一位 RevOps 顾问 2025-06 发的 10 分钟演示(19,601 次观看),一位 GTM 工程师 2026-08 发的 15 分钟实测(85,382 次观看,前十条里最多),HubSpot 开发者频道 2025-10 发的 6 分钟开发者 MCP 教程(2,920 次观看)。

第一条视频教的是旧装法:在 HubSpot 设置里建私有应用,作者建议「把所有 scope 都勾上」,再把令牌贴进 Claude 桌面版的 claude_desktop_config.json,跑的是 npm 上的本地包。这条路现在走不通了:HubSpot 文档写明,2026-10-26 起不能再新建旧版私有应用,已有的继续可用(HubSpot 开发者文档:Legacy private apps)。就算还有旧应用,全 scope 的令牌也不该交给 Claude。这条视频还演示了让 Claude 上网查一家公司的 8 位高管、直接在 CRM 里建成联系人,中间没有批准步骤,同一句话重跑一次,CRM 里就多出 8 个重复联系人。

第二条视频补了三件文档没写全的事。一是写工具「manage CRM objects」上线时,作者没有在 changelog 里看到通知,于是自己写了个每小时拉一次工具清单、有变化就提示的小工具;脚本里不写死工具名,每次先看 get_user_details 的返回。二是服务密钥可以起名,用这把密钥建或改的记录,在活动面板和审计日志里显示这个名字;回写脚本单独建一把带名字的服务密钥,出了问题按名字就能查。三是个人访问密钥(personal access key)对 CRM 对象只读,写入要用服务密钥或应用。演示里他把 Claude 的工具权限设成「总是允许」来跳过批准,跟 HubSpot 建议的「需要批准」相反,生产账号不要照抄。他还猜测 MCP 连接器的回调地址写本机地址会不稳,Claude Code 文档的示例用的是本机回调,这点他没验证,我们也没有验证。

第三条讲的是开发者 MCP server:先在「产品更新 → 测试版」里报名,再在终端跑 hs mcp setup 选 IDE,它帮你建项目、查构建错误,不碰 CRM 数据,搜「hubspot mcp」的人点进去容易装错。补看的那条测评说当时 MCP server 读不到笔记;现在的集成文档写的是只有开了敏感数据的账号,笔记这类活动对象才会被挡住,连上后用 get_user_details 看对象清单就能确认自己的账号是哪种情况。

做不了、要注意的地方

HubSpot 一侧的配置本文没有在真实账号上跑,全部是配置示例;HubSpot 的数字来自 2026-11-22 读取的公开文档和公告。防重复写入那套写法是按 HubSpot 文档推出来的,笔记上能不能建唯一值属性文档没写明,都要先在测试账号里跑一遍。HubSpot 一侧每周 6 到 7 次请求、连接器 40 批写入,都是按文档里每批 100 条、每批 10 条的上限推算出来的,没有实发过。HubSpot 连接器和 MCP server 的工具清单因订阅、权限和账号配置而不同,文档建议连上后先调 get_user_details 看自己能用哪些工具和对象,我们没有授权的账号,没法列出工具名(HubSpot 集成文档)。

EveryInfra 一侧的边界:三家客户各取一次,样本小,「一周新增几条」只代表 2026 年 11 月下旬这几天;reddit/search 只搜最近一个月、只搜帖子不搜评论,品牌名是常用词的公司误命中会更多;LinkedIn 公司动态的作者字段有时为空。远程 MCP 只调了一次,74.6 秒说明不了常态。视频只看了 4 条,代表的是创作者的演示,不代表 HubSpot 文档里的做法。数据来自公开网页,写进 CRM 之前先确认你所在地区对客户公开信息的使用规则,本文不提供法律意见。

不要把客户的公开评论当成客户本人的意见写进联系人记录:一条 Trustpilot 评价是这家公司的某个用户写的,跟你 CRM 里这家公司的联系人通常不是同一个人。笔记里写清楚来源平台、日期和链接,评价人的姓名不进 CRM。

行业动向

  • 2026-11-12,HubSpot 开发者博客发布自定义 MCP 连接器教程,用 MCPJam 演示连接、只读授权和「I accept the risk」确认(HubSpot 开发者博客)。对读者:没有现成连接器的 AI 工具,现在可以按这篇自己接。
  • 2026-11-17,HubSpot 公布无头定价(HubSpot)。对读者:连接器日常使用不另收费,自建 agent 占 API 额度,量大的活先算 API 额度。
  • 2026-11-21,IETF HTTP API 工作组发布 Idempotency-Key 请求头草案第 9 版(IETF)。对读者:自己写的回写服务也可以按这个草案接受幂等键,Claude 重试时就不会重复写。

常见问题

HubSpot MCP server 的 URL 是什么?

https://mcp.hubspot.com,传输方式是 Streamable HTTP,授权是 OAuth 2.1 加 PKCE(S256),要用你在 HubSpot「开发 → MCP 连接器」里建的连接器的客户端 ID 和密钥(HubSpot 集成文档)。

HubSpot MCP server 要另外付费吗?

按 2026-11-17 的无头定价,在 Claude、ChatGPT 等连接器里的日常使用随 HubSpot 席位附送;自建 agent 调 API 占套餐 API 额度,不扣 Credits;只有 HubSpot 在建的受管环境按 Credits 计费,每个 $0.010(HubSpot)。AI 工具本身的订阅另算,例如 Claude Pro 每月 $20。

hubspot mcp claude code 怎么配?

HubSpot 不支持动态注册客户端,用 claude mcp add --transport http --client-id <ID> --client-secret --callback-port 8080 hubspot https://mcp.hubspot.com/,回调地址和 HubSpot 连接器里填的一致,然后在 Claude Code 里输入 /mcp 登录(Claude Code 文档)。

HubSpot MCP 有哪些工具?

工具清单因订阅、用户权限和账号配置而不同,连上后先调 get_user_details,它会返回你的用户、账号和可用对象及工具(HubSpot 集成文档)。

GitHub 上的 HubSpot MCP server 和 mcp.hubspot.com 是一回事吗?

不是同一个东西。mcp.hubspot.com 是 HubSpot 托管的远程服务器,读写 CRM;HubSpot 的开发者 MCP server 随 HubSpot CLI 在本机运行,帮你开发应用和 CMS,不读写 CRM 记录(HubSpot 开发者 MCP 文档;HubSpot CLI 仓库)。

HubSpot 现在还能建私有应用吗?

不能新建了。HubSpot 文档写明,2026-10-26 起旧版私有应用不能再创建,已有的继续可用;新的集成用服务密钥或开发者平台上的应用,服务密钥和私有发布的应用共用同一套限额(HubSpot 开发者文档:Legacy private apps)。2025 年的一些教程还在教建私有应用、勾全部 scope,照做会找不到入口。

HubSpot MCP 能看到客户在 LinkedIn、Trustpilot、Reddit 上的公开内容吗?

看不到。它的社交功能只覆盖你自己连接到 HubSpot 的社交账号和你自己的帖子(HubSpot 集成文档)。客户公司的公开动态和评价要从外部取,例如用 EveryInfra 的 linkedin/company_posts 和 trustpilot/reviews。

上手步骤

  1. 在 EveryInfra 快速上手 注册并拿到 Key,放进环境变量 EVERYINFRA_API_KEY;在 MCP 接入页 按 Claude 或 Claude Code 的写法加 https://api.everyinfra.com/mcp。
  2. 在 HubSpot 建 MCP 连接器(Claude 网页版用 HubSpot 自己的连接器就不用建),写工具设成需要批准。
  3. 在 HubSpot 测试账号给公司建三个自定义属性:ei_digest_week、ei_digest_note_id、ei_low_reviews。
  4. 先拿一家客户跑通:取 LinkedIn 公司动态、Trustpilot 评价、Reddit 帖子,每次请求带 Idempotency-Key(周次 + 客户 + 能力),去重后让 Claude 写摘要,批准后写入这家公司本周的摘要笔记。
  5. 把同一个请求再跑一遍,确认 EveryInfra 账单没有新扣费、HubSpot 里没有多出笔记;再扩到 200 家,按 价格页 和目录单价核对账单。

更多同类做法:Atlassian MCP server 竞品工单周报、Outreach MCP 销售跟进、ActiveCampaign 接社媒评论、错误自愈。

参考资料

  1. HubSpot is headless. Here's how we'll price it,HubSpot,2026-11-17,https://www.hubspot.com/company-news/pricing-headless
  2. Integrate AI tools with the HubSpot MCP server,HubSpot 开发者文档,2026-11-20 修改,https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server
  3. Using the HubSpot MCP server,HubSpot 开发者文档,2026-09-18,https://developers.hubspot.com/docs/build-with-ai/remote-mcp-server
  4. Remote HubSpot MCP server is now generally available,HubSpot 开发者 changelog,2026-04-13,https://developers.hubspot.com/changelog/remote-hubspot-mcp-server-is-now-generally-available
  5. Connect HubSpot's MCP Server With Any AI Tool Securely,HubSpot 开发者博客,2026-11-12,https://developers.hubspot.com/blog/connect-hubspots-mcp-server-with-any-ai-tool-securely
  6. API usage guidelines and limits,HubSpot 开发者文档,2026-11-22 读取,https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines
  7. Technical Limits,HubSpot 产品与服务目录,2026-11-22 读取,https://legal.hubspot.com/hubspot-product-and-services-catalog/technical-limits
  8. HubSpot Product & Services Catalog,HubSpot,2026-11-22 读取,https://legal.hubspot.com/hubspot-product-and-services-catalog
  9. HubSpot Credits,HubSpot,2026-11-22 读取,https://www.hubspot.com/products/artificial-intelligence/credits
  10. Sales Software Pricing,HubSpot,2026-11-22 读取,https://www.hubspot.com/pricing/sales
  11. Set up and use the HubSpot connector for Claude,HubSpot 知识库,2026-11-22 读取,https://knowledge.hubspot.com/integrations/set-up-and-use-the-hubspot-connector-for-claude
  12. Manage access to apps,HubSpot 知识库,https://knowledge.hubspot.com/integrations/manage-access-to-apps
  13. Properties API,HubSpot 开发者文档,https://developers.hubspot.com/docs/api-reference/latest/crm/properties/guide
  14. Set validation rules for a property,HubSpot 知识库,2026-11-22 读取,https://knowledge.hubspot.com/properties/set-validation-rules-for-properties
  15. Companies API,HubSpot 开发者文档,2026-11-16 修改,https://developers.hubspot.com/docs/api-reference/latest/crm/objects/companies/guide
  16. Create or update a batch of companies by unique property values,HubSpot 开发者文档,2026-11-16 修改,https://developers.hubspot.com/docs/api-reference/latest/crm/objects/companies/batch/upsert-companies
  17. Create or update a batch of notes by unique property values,HubSpot 开发者文档,https://developers.hubspot.com/docs/api-reference/latest/crm/activities/notes/batch/upsert-notes
  18. Notes API,HubSpot 开发者文档,2026-11-16 修改,https://developers.hubspot.com/docs/api-reference/latest/crm/activities/notes/guide
  19. Update a batch of companies,HubSpot 开发者文档,https://developers.hubspot.com/docs/api-reference/latest/crm/objects/companies/batch/update-companies
  20. Developer MCP server,HubSpot 开发者文档,https://developers.hubspot.com/docs/developer-tooling/local-development/mcp-server
  21. HubSpot CLI,GitHub,https://github.com/HubSpot/hubspot-cli
  22. HubSpot won't charge extra when Claude or ChatGPT works its CRM,PPC Land,2026-11-19,https://ppc.land/hubspot-wont-charge-extra-when-claude-or-chatgpt-works-its-crm/
  23. HubSpot Just Announced New Headless Pricing,IMPACT,2026-11,https://www.impactplus.com/learn/hubspot-just-announced-new-headless-pricing-what-this-means-in-plain-english
  24. Connect to local MCP servers / MCP,Claude Code 文档,2026-11-22 读取,https://code.claude.com/docs/en/mcp
  25. Permissions,Claude Code 文档,https://code.claude.com/docs/en/permissions
  26. Getting started with custom connectors using remote MCP,Claude 帮助中心,https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp
  27. Plans & pricing,Claude,2026-11-22 读取,https://claude.com/pricing
  28. Authorization,MCP 规范 2026-07-28,https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization
  29. RFC 7636:Proof Key for Code Exchange,IETF,https://datatracker.ietf.org/doc/html/rfc7636
  30. The Idempotency-Key HTTP Header Field,draft-09,IETF,2026-11-21,https://datatracker.ietf.org/doc/draft-ietf-httpapi-idempotency-key-header/
  31. RFC 9110:HTTP Semantics,IETF,https://www.rfc-editor.org/rfc/rfc9110.html
  32. EveryInfra 能力目录,2026-11-22 12:42 读取,https://api.everyinfra.com/api/v1/social/catalog
  33. EveryInfra OpenAPI,2026-11-22 读取,https://api.everyinfra.com/openapi.json
  34. 3 weeks running HubSpot from Claude Code CLI instead of MCP,Reddit r/hubspot,https://www.reddit.com/r/hubspot/comments/1ss3ma7/3_weeks_running_hubspot_from_claude_code_cli/
  35. Anyone using HubSpot MCP?,Reddit r/hubspot,https://www.reddit.com/r/hubspot/comments/1r1d23e/anyone_using_hubspot_mcp/
  36. MCP Inspector,GitHub,https://github.com/modelcontextprotocol/inspector
  37. Authentication overview,HubSpot 开发者文档,https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/overview
  38. Make API requests using a service key,HubSpot 开发者文档,2026-10-28,https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/account-service-keys
  39. HubSpot Account Types,HubSpot 开发者文档,https://developers.hubspot.com/docs/getting-started/account-types
  40. Legacy private apps,HubSpot 开发者文档,2026-10-30 修改,https://developers.hubspot.com/docs/apps/legacy-apps/private-apps/overview
  41. Search the CRM,HubSpot 开发者文档,https://developers.hubspot.com/docs/api-reference/latest/crm/search-the-crm
  42. Public Beta: Self-Service MCP Auth Apps for the HubSpot Remote MCP Server,HubSpot 开发者 changelog,2026-01-20,https://developers.hubspot.com/changelog/public-beta-self-service-mcp-auth-apps-for-the-hubspot-remote-mcp-server
  43. HubSpot connector for Claude: Additional Object Access and Admin Controls,HubSpot 开发者 changelog,2025-08-28,https://developers.hubspot.com/changelog/claude-connector-additional-objects-and-admin-controls

引用编号 BL-209

Google Analytics 同意才加载 隐私