跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 HubSpot，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
让你的 AI 在 HubSpot CRM 中工作：搜索和更新联系人、公司、交易和工单，查看记录之间的关联，查看管道和负责人，并记录备注和任务。通过你自己创建的服务密钥连接一个账户。
试试这样问
HubSpot 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → HubSpot、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
HubSpot + ChatGPT
让你的 AI 在 HubSpot CRM 中工作：搜索和更新联系人、公司、交易和工单，查看记录之间的关联，查看管道和负责人，并记录备注和任务。通过你自己创建的服务密钥连接一个账户。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
HUBSPOT_ACCESS_TOKEN
步骤 1 — 获取凭证
- 在 HubSpot 中，打开左侧边栏的 Development，进入 Keys → Service keys，然后点击 Create service key。你需要是超级管理员，或拥有 Developer tools 访问权限的用户。
- 为密钥命名（例如 "AnythingMCP"），点击 Add new scope，勾选下面列出的权限范围，然后点击 Update 和 Create。
- 打开该密钥，点击 Show，再点击 Copy。服务密钥以
pat-开头（例如pat-eu1-...）。 - 把密钥填入
HUBSPOT_ACCESS_TOKEN，不要带 Bearer 字样，然后安装连接器。 - 先运行
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 — 在 ChatGPT 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 通过开发者模式（Developer mode）将 MCP 服务器作为自定义应用接入，仅付费套餐可用，免费套餐不可用。在 Business 和 Enterprise 工作区中，可能需要管理员先开启。
- 在 ChatGPT 中打开 Settings → Security and login，开启 Developer mode。
- 前往 chatgpt.com/plugins，点击 +。
- 填写名称和简短描述，例如 Name:
HubSpot。 - 在 Connection 下填入 MCP 服务器 URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID，然后创建连接。 - ChatGPT 提示时，登录 AnythingMCP（OAuth）并允许访问。
可用工具
| Tool | What it does |
|---|---|
hubspot_list_owners | List the HubSpot users who can own records (owners): owner id, user id, email, first and last name, teams and whether archived |
hubspot_get_account | Get the HubSpot account the token belongs to: portal id (Hub ID), account type, time zone and UTC offset, company currency and additional… |
hubspot_search_objects | Search CRM records of one object type (contacts, companies, deals, tickets, notes, tasks, ...) by free text and/or property filters, with… |
hubspot_list_objects | List 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_object | Get 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_object | Create a CRM record (contact, company, deal, ticket, ...) with property values, optionally associated with existing records |
hubspot_update_object | Change property values of one CRM record; only the given properties change, and an empty string clears a value |
hubspot_archive_object | Archive (delete) one CRM record: it moves to the recycling bin, where it can be restored for 90 days |
hubspot_get_associations | List 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_records | Link two existing records with HubSpot's default (unlabeled) association, e.g. a contact to a company or a deal to a contact |
hubspot_list_pipelines | List 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_properties | List the properties of an object type, default and custom: internal name, label, type, field type, group, description, whether read-only… |
hubspot_create_note | Add a note to the CRM timeline, associated with contacts, companies, deals or tickets |
hubspot_create_task | Create 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
ChatGPT 免费套餐能用自定义 MCP 连接器吗? 不能。自定义 MCP 连接需要开发者模式，只有付费套餐提供。
下一步
这份指南对你有帮助吗?
