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 サービス

サービス ID	プロバイダー	認証方式
`hubspot`	HubSpot リモート MCP サーバー	PKCE を使用する OAuth2

HubSpot provider は https://mcp.hubspot.com を介して接続します。HubSpot MCP auth app が HubSpot 側の permissions と account authorization flow を管理します。

前提条件

実行中の OpenConnector runtime。
Developer Platform と MCP Auth Apps にアクセスできる HubSpot account。
接続する HubSpot account 用の MCP auth app を作成する permission。
users が browser で開く OpenConnector origin（http://localhost:3000、https://connect.example.com など）。

手順 1：OpenConnector callback URL を設定する

OpenConnector origin に /oauth/callback を追加して callback URL を作成します。local test では http://localhost:3000/oauth/callback を使用します。public deployment では OOMOL_CONNECT_ORIGIN を設定して OpenConnector を再起動し、https://connect.example.com/oauth/callback などの public callback URL を使用します。

手順 2：HubSpot MCP auth app を作成する

HubSpot で次の操作を行います。

接続する HubSpot account を開きます。
Development を開きます。
MCP Auth Apps を開きます。
新しい MCP auth app を作成します。
識別しやすい app name を入力します。
redirect URL に OpenConnector callback URL を正確に設定します。
app を保存します。

HubSpot の公式ガイドは Integrate AI tools with the HubSpot MCP server です。

手順 3：client credentials をコピーする

HubSpot MCP auth app details から次の値をコピーします。

HubSpot の値	OpenConnector のフィールド
クライアント ID	`clientId`
クライアントシークレット	`clientSecret`

手順 4：HubSpot client を OpenConnector に保存する

OpenConnector web console を使用します。

http://localhost:3000 などの OpenConnector web console を開きます。
Providers を開いて HubSpot を選択します。
Configure OAuth Client または Edit OAuth Client を選択します。
HubSpot client ID と client secret を貼り付けます。
Save OAuth Client を選択します。

手順 5：接続してテストする

OAuth client を保存した後、HubSpot provider page で Connect を選択します。HubSpot account を選び、access を承認して OpenConnector に戻り、provider page に account が connected と表示されることを確認します。

hubspot.list_properties などの CRM actions を実行する前に、console の action details を確認してください。

トラブルシューティング

症状	確認事項
HubSpot が client ID を invalid と表示する	別の HubSpot app type ではなく、MCP auth app の Client ID をコピーしたことを確認します。
Redirect または callback が失敗する	HubSpot の redirect URL が `<openconnector-origin>/oauth/callback` と完全に一致している必要があります。
Token exchange が失敗する	HubSpot MCP auth app が OAuth with PKCE に対応し、OpenConnector が現在の HubSpot provider を使用していることを確認します。
誤った HubSpot account が選択される	browser で不要な HubSpot accounts からサインアウトするか、authorization 用に別の browser profile を使用します。
Actions が permission errors を返す	接続した HubSpot user の permissions と、HubSpot MCP app の現在の access rules を確認します。