连接器指南阅读约 3 分钟14 个 MCP 工具7 种语言

如何通过 MCP 将 HubSpot 连接到 Meta Muse

让你的 AI 在 HubSpot CRM 中工作:搜索和更新联系人、公司、交易和工单,查看记录之间的关联,查看管道和负责人,并记录备注和任务。通过你自己创建的服务密钥连接一个账户。

HC作者:HelpCode 团队更新于 3 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

HubSpot

HubSpot

Let your AI work in HubSpot CRM: search and update contacts, companies, deals and tickets, see who is linked to what, check pipelines and owners, and log notes and tasks. One account, through a service key you create yourself.

个工具

14

区域

INTL

类别

CRM

身份验证

Bearer Token

所需环境变量

HUBSPOT_ACCESS_TOKEN
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

跳过安装。2 分钟内即可运行。

在 cloud.anythingmcp.com 开始免费试用,一键添加 HubSpot,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。

开始免费试用

摘要

让你的 AI 在 HubSpot CRM 中工作:搜索和更新联系人、公司、交易和工单,查看记录之间的关联,查看管道和负责人,并记录备注和任务。通过你自己创建的服务密钥连接一个账户。

试试这样问

HubSpot 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

HubSpot · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → HubSpot、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无 git clone、无本地服务器。

HubSpot + Meta Muse

让你的 AI 在 HubSpot CRM 中工作:搜索和更新联系人、公司、交易和工单,查看记录之间的关联,查看管道和负责人,并记录备注和任务。通过你自己创建的服务密钥连接一个账户。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

HUBSPOT_ACCESS_TOKEN

步骤 1 — 获取凭证

  1. 在 HubSpot 中,打开左侧边栏的 Development,进入 Keys → Service keys,然后点击 Create service key。你需要是超级管理员,或拥有 Developer tools 访问权限的用户。
  2. 为密钥命名(例如 "AnythingMCP"),点击 Add new scope,勾选下面列出的权限范围,然后点击 Update 和 Create。
  3. 打开该密钥,点击 Show,再点击 Copy。服务密钥以 pat- 开头(例如 pat-eu1-...)。
  4. 把密钥填入 HUBSPOT_ACCESS_TOKEN,不要带 Bearer 字样,然后安装连接器。
  5. 先运行 hubspot_get_account:它会显示该密钥属于哪个 HubSpot 账户(Hub ID),以及该账户的时区和货币。

旧版私有应用:较早的账户可能仍在使用私有应用(Development → Legacy apps,以前位于 Settings → Integrations → Private Apps)。它的访问令牌用法相同:填入 HUBSPOT_ACCESS_TOKEN 即可。

权限范围:

  • 读取:crm.objects.contacts.read(也涵盖备注和任务)、crm.objects.companies.read、crm.objects.deals.read、crm.objects.tickets.read、crm.objects.owners.read。
  • 写入:crm.objects.contacts.write(备注和任务也需要它)、crm.objects.companies.write、crm.objects.deals.write、crm.objects.tickets.write。

只读设置:只给密钥授予读取权限范围,并停用 hubspot_create_object、hubspot_update_object、hubspot_associate_records、hubspot_create_note 和 hubspot_create_task。

安装时默认关闭:hubspot_archive_object。只有在 AI 需要删除记录时才打开它。归档的记录会进入 HubSpot 的回收站,可在 90 天内从那里恢复。

数据隐私设置:如果你的 HubSpot 账户开启了数据隐私(GDPR)设置,HubSpot 会要求每个新联系人都带有数据处理的法律依据,即属性 hs_legal_basis。请告诉 AI 创建联系人时使用哪种法律依据;否则 HubSpot 会返回 "The following required properties were missing"。

限制:在 Free 和 Starter 版本中,HubSpot 允许每个密钥每 10 秒 100 个请求(Professional 和 Enterprise 版本更多),每个账户每天 250,000 个请求,以及每秒 5 次搜索。超出限制时 HubSpot 返回 429:等几秒再试即可。

常见错误:401 表示密钥错误、已过期或已轮换:请重新复制。403 会指出缺少的权限范围:在密钥的 Edit 中添加。404 表示 id 或对象类型错误。400 VALIDATION_ERROR 会指出出错的属性或筛选条件,例如未知的属性名,或不属于下拉选项的值。

连接器不处理营销邮件、表单、列表、工作流、文件、报价和行项目定价、记录合并或批量写入。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Muse 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Muse 以自定义连接器的形式添加远程 MCP 服务器,并通过 OAuth 登录。

  1. 在 Muse 中打开 Settings → Connectors,选择 Add custom connector。
  2. 粘贴 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
  3. Muse 会打开 AnythingMCP 的登录页面:登录并批准访问。
  4. 在聊天中,向 Muse 提出需要用到 HubSpot 的工具的请求。

你也可以在聊天中完成设置,适用于网页版、iOS 和 Android 应用以及 WhatsApp。给 Muse 发送这条消息:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Muse 从 Meta 的云端连接,因此 localhost 无法使用。

可用工具

ToolWhat it does
hubspot_list_ownersList the HubSpot users who can own records (owners): owner id, user id, email, first and last name, teams and whether archived
hubspot_get_accountGet the HubSpot account the token belongs to: portal id (Hub ID), account type, time zone and UTC offset, company currency and additional…
hubspot_search_objectsSearch CRM records of one object type (contacts, companies, deals, tickets, notes, tasks, ...) by free text and/or property filters, with…
hubspot_list_objectsList CRM records of one object type page by page, oldest id first, with the chosen properties and optionally the ids of associated records
hubspot_get_objectGet one CRM record by id (or by a unique property such as a contact's email with id_property), with the chosen properties, optional…
hubspot_create_objectCreate a CRM record (contact, company, deal, ticket, ...) with property values, optionally associated with existing records
hubspot_update_objectChange property values of one CRM record; only the given properties change, and an empty string clears a value
hubspot_archive_objectArchive (delete) one CRM record: it moves to the recycling bin, where it can be restored for 90 days
hubspot_get_associationsList the records of one type associated with a record, with their association types and labels, e.g. all deals of a company or all contacts…
hubspot_associate_recordsLink two existing records with HubSpot's default (unlabeled) association, e.g. a contact to a company or a deal to a contact
hubspot_list_pipelinesList the pipelines of deals or tickets with their stages: pipeline id and label, and per stage its id, label, display order and metadata…
hubspot_list_propertiesList the properties of an object type, default and custom: internal name, label, type, field type, group, description, whether read-only…
hubspot_create_noteAdd a note to the CRM timeline, associated with contacts, companies, deals or tickets
hubspot_create_taskCreate a task (to-do, call or email reminder) with a due date, optionally assigned to an owner and associated with records

示例提示

  • “销售管道中哪些交易预计在本月成交?负责人分别是谁?”
  • “找到联系人 [email protected],显示她所在的公司和她未完成的交易。”
  • “把 Acme Corp 的交易推进到下一阶段,并添加一条备注,总结今天的通话内容。”
  • “在 Globex 的交易上给我创建一个跟进任务,下周五到期。”

FAQ

Muse 在哪些地区可用? Meta 目前在美国和加拿大提供 Muse,可在网页版、iOS 和 Android 应用以及 WhatsApp 中使用。

Meta 会审核这个连接器吗? 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为此 MCP 服务器启用的工具,你也可以随时在 Settings → Connectors 中断开它。

下一步

这份指南对你有帮助吗?

你的 HubSpot 智能体只差一次点击。

安装连接器,粘贴密钥,向 Meta Muse 提问。免费试用 7 天,无需信用卡。

相关指南

连接器

如何通过 MCP 将 HubSpot 连接到 ChatGPT

让你的 AI 在 HubSpot CRM 中工作:搜索和更新联系人、公司、交易和工单,查看记录之间的关联,查看管道和负责人,并记录备注和任务。通过你自己创建的服务密钥连接一个账户。

连接器

如何通过 MCP 将 HubSpot 连接到 Claude

让你的 AI 在 HubSpot CRM 中工作:搜索和更新联系人、公司、交易和工单,查看记录之间的关联,查看管道和负责人,并记录备注和任务。通过你自己创建的服务密钥连接一个账户。

连接器

如何通过 MCP 将 HubSpot 连接到 Cursor

让你的 AI 在 HubSpot CRM 中工作:搜索和更新联系人、公司、交易和工单,查看记录之间的关联,查看管道和负责人,并记录备注和任务。通过你自己创建的服务密钥连接一个账户。

连接器

如何通过 MCP 将 HubSpot 连接到 Gemini

让你的 AI 在 HubSpot CRM 中工作:搜索和更新联系人、公司、交易和工单,查看记录之间的关联,查看管道和负责人,并记录备注和任务。通过你自己创建的服务密钥连接一个账户。

连接器

HubSpot 接入 MCP:从任意 AI 代理驱动 HubSpot

让你的 AI 在 HubSpot CRM 中工作:搜索和更新联系人、公司、交易和工单,查看记录之间的关联,查看管道和负责人,并记录备注和任务。通过你自己创建的服务密钥连接一个账户。

连接器

如何通过 MCP 将 Kommo 连接到 Meta Muse

让你的 AI 在 Kommo CRM 中工作:跨管道查找和更新线索,查询联系人和公司,跟进任务和备注,并记录新的任务和备注。通过私有集成的长期令牌连接一个账户。