如何通过 MCP 将 HubSpot 连接到 Gemini

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

HubSpot + Gemini

让你的 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 — 在 Gemini 中添加连接器

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

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 HubSpot 的工具。

可用工具

示例提示

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

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Meta Muse