Создание HubSpot MCP auth app для OpenConnector

Текущий провайдер HubSpot в OpenConnector использует remote MCP OAuth flow HubSpot. Создайте MCP auth app в HubSpot, скопируйте client ID и client secret, затем сохраните их для сервиса hubspot в OpenConnector.

Сервис OpenConnector

ID сервиса	Провайдер	Тип авторизации
`hubspot`	Remote MCP server HubSpot	OAuth2 с PKCE

Провайдер HubSpot подключается через https://mcp.hubspot.com. MCP auth app HubSpot контролирует разрешения на стороне HubSpot и процесс авторизации аккаунта.

Предварительные требования

Запущенный runtime OpenConnector.
Аккаунт HubSpot с доступом к Developer Platform и MCP Auth Apps.
Разрешение на создание MCP auth app для подключаемого аккаунта HubSpot.
Origin OpenConnector, который пользователи открывают в браузере, например http://localhost:3000 или https://connect.example.com.

Шаг 1. Настройте callback URL OpenConnector

Добавьте /oauth/callback к origin OpenConnector. Для локального тестирования используйте http://localhost:3000/oauth/callback. Для публичного deployment задайте OOMOL_CONNECT_ORIGIN, перезапустите OpenConnector и используйте публичный callback URL, например https://connect.example.com/oauth/callback.

Шаг 2. Создайте HubSpot MCP auth app

В HubSpot:

Откройте аккаунт HubSpot, который хотите подключить.
Откройте Development.
Откройте MCP Auth Apps.
Создайте новую MCP auth app.
Введите узнаваемое название app.
Укажите точный callback URL OpenConnector как redirect URL.
Сохраните app.

Официальное руководство HubSpot: Integrate AI tools with the HubSpot MCP server.

Шаг 3. Скопируйте client credentials

В сведениях о HubSpot MCP auth app скопируйте:

Значение HubSpot	Поле OpenConnector
Идентификатор клиента	`clientId`
Секрет клиента	`clientSecret`

Шаг 4. Сохраните клиент HubSpot в OpenConnector

Используйте web console OpenConnector:

Откройте web console OpenConnector, например http://localhost:3000.
Откройте Providers и выберите HubSpot.
Выберите Configure OAuth Client или Edit OAuth Client.
Вставьте client ID и client secret HubSpot.
Выберите Save OAuth Client.

Шаг 5. Подключите и проверьте

После сохранения OAuth client выберите Connect на странице провайдера HubSpot. Выберите аккаунт HubSpot, подтвердите доступ, вернитесь в OpenConnector и убедитесь, что аккаунт отображается как подключённый.

Перед выполнением CRM actions, например hubspot.list_properties, просмотрите сведения об action в console.

Устранение неполадок

Симптом	Что проверить
HubSpot сообщает о недействительном client ID	Убедитесь, что скопировали Client ID из MCP auth app, а не из другого типа app HubSpot.
Ошибка redirect или callback	Redirect URL в HubSpot должен точно совпадать с `<openconnector-origin>/oauth/callback`.
Ошибка обмена токена	Убедитесь, что HubSpot MCP auth app поддерживает OAuth с PKCE, а OpenConnector использует текущий провайдер HubSpot.
Выбран неверный аккаунт HubSpot	Выйдите из лишних аккаунтов HubSpot в браузере или используйте отдельный профиль для авторизации.
Actions возвращают ошибки разрешений	Проверьте разрешения подключённого пользователя HubSpot и текущие правила доступа HubSpot MCP app.