📦 Hubspot mcp — Hubspot 营销认证专业人员（MCP）

HubSpot 快速入门 始终通过 bash 调用 {baseDir}/scripts/invoke.sh —— 绝不直接调用 mcporter。 该包装器在需要时从环境提供的令牌中初始化 OAuth 密钥库，然后调用 mcporter。 bash {baseDir}/scripts/invoke.sh call maverick-hubspot.search_crm_objects objectType=contacts query="alice" bash {baseDir}/scripts/invoke.sh call maverick-hubspot.get_pipeline_stages objectType=deals 为了获得结构化输出（同时将传输错误作为 JSON 封装返回 —— 用于解决 mcporter #153）： bash {baseDir}/scripts/invoke.sh call --output json maverick-hubspot.search_crm_objects objectType=contacts query="alice" | jq '.result.content' 发现可用的工具和模式： bash {baseDir}/scripts/invoke.sh list maverick-hubspot --schema 安全 写入操作（create_crm_object、update_crm_object、关联更改、管道或阶段更改和活动日志记录）会修改连接的门户可见的 HubSpot CRM 数据。 在调用写入工具之前，请确认用户有明确的意图 —— 搜索和读取工具可以自由调用以进行探索。 在更新属性或关联之前，请先读取当前 CRM 对象，并使用内部属性名称（如 firstname、email、dealstage 和 hubspot_owner_id）。 身份验证 令牌会自动提供和轮换。 如果调用返回 HTTP 401 并且在几秒钟内无法恢复，则表示 OAuth 授权已被撤销 —— 重新授权集成以刷新凭据。 数据流 工具调用通过 HTTPS 访问 HubSpot 的托管 MCP 服务（https://mcp.hubspot.com），并通过 OAuth 进行身份验证。 HubSpot 可以看到每个调用引用的联系人、公司、交易、票据、关联、所有者和管道数据。 仅将此技能用于 HubSpot 相关工作；不要通过这些工具传递无关的敏感内容。 依赖项 mcporter (github.com/steipete/mcporter) —— 用于调用 HubSpot 托管 MCP 服务器的 MCP CLI。 如果 PATH 中缺少，则通过 npm install -g --ignore-scripts mcporter 自动安装（参见前置安装规范）。 安装规范使用未固定版本的 mcporter（npm 最新版本）；具有严格供应链控制的运营商应覆盖安装以固定特定版本（例如 mcporter@）。 jq (stedolan.github.io/jq) —— 由密钥库初始化器使用的 JSON 处理器。 系统依赖项；通过操作系统包管理器安装（apt install jq、brew install jq 等）。 flock (util-linux 的一部分) —— 用于序列化并发密钥库写入的文件锁定。 在 Linux 上默认可用；在 macOS 上通过 brew install flock 安装。 shasum (Perl，随 Digest::SHA 发布) —— 计算用于派生 mcporter 密钥库密钥和提供的令牌标记的 SHA-256 哈希值。 在 macOS 和 Debian/Ubuntu（包括部署的 cloudflare/sandbox Ubuntu 22.04 镜像）上预安装；在最小 Linux 镜像上安装 perl-Digest-SHA。 脚本调用 shasum -a 256，而不是 GNU sha256sum，因此可以在不需要 coreutils 的 stock macOS 上运行。 API CLI GitHub npm jq flock shasum mcporter OAuth MCP HubSpot JSON SHA-256 Perl Digest::SHA util-linux cloudflare Ubuntu macOS Linux Debian coreutils GNU