为 OpenConnector 创建 HubSpot MCP auth app

OpenConnector 当前 HubSpot provider 使用 HubSpot remote MCP OAuth flow。你需要在 HubSpot 中创建 MCP auth app，复制它的 client ID 和 client secret，然后把这些值保存到 OpenConnector 的 hubspot service。

OpenConnector service

HubSpot provider 通过 https://mcp.hubspot.com 连接。HubSpot 侧的权限和账号授权流程由 MCP auth app 管理。

前置条件

• 一个正在运行的 OpenConnector runtime。
• 可以访问 HubSpot Developer Platform 和 MCP Auth Apps 的 HubSpot 账号。
• 有权限为目标 HubSpot account 创建 MCP auth app。
• 用户在浏览器中打开的 OpenConnector origin，例如 http://localhost:3000 或 https://connect.example.com。

第 1 步：确定 OpenConnector callback URL

在 OpenConnector origin 后拼接 /oauth/callback，得到 callback URL。本地测试使用 http://localhost:3000/oauth/callback。公开部署时，请先设置 OOMOL_CONNECT_ORIGIN，重启 OpenConnector 后使用公开 callback URL，例如 https://connect.example.com/oauth/callback。

第 2 步：创建 HubSpot MCP auth app

在 HubSpot 中：

1. 打开要连接的 HubSpot account。
2. 打开 Development。
3. 打开 MCP Auth Apps。
4. 创建新的 MCP auth app。
5. 输入一个容易识别的 app name。
6. 将 redirect URL 设置为 OpenConnector 的准确 callback URL。
7. 保存 app。

HubSpot 官方文档见 Integrate AI tools with the HubSpot MCP server。

第 3 步：复制 client credentials

从 HubSpot MCP auth app 详情中复制：

第 4 步：在 OpenConnector 中保存 HubSpot client

优先使用 OpenConnector Web 控制台：

1. 打开 OpenConnector Web 控制台，例如 http://localhost:3000。
2. 打开 Providers，选择 HubSpot。
3. 点击 Configure OAuth Client 或 Edit OAuth Client。
4. 粘贴 HubSpot client ID 和 client secret。
5. 点击 Save OAuth Client。

第 5 步：连接并测试

保存 OAuth client 后，在 HubSpot provider 页面点击 Connect。选择 HubSpot account，批准访问，回到 OpenConnector，并确认 provider 页面显示账号已连接。

运行 hubspot.list_properties 等 CRM action 前，先查看控制台里的 action 详情。

排查建议