---
author: OOMOL
author_url: https://oomol.com/ja/about/
title: OpenConnector 用の HubSpot MCP auth app を作成する
description: HubSpot MCP auth app を作成して OpenConnector redirect URL を設定し、OAuth で
  HubSpot を接続します。
lang: ja
canonical_url: https://oomol.com/ja/docs/openconnector-hubspot-oauth-app/
markdown_url: https://oomol.com/ja/docs/openconnector-hubspot-oauth-app.md
---

# 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 で次の操作を行います。

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](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server) です。

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

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

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

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

OpenConnector web console を使用します。

1. `http://localhost:3000` などの OpenConnector web console を開きます。
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 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 を確認します。 |