Claude でエンタープライズ管理型認証を設定する

エンタープライズ管理型認証（EMA）を利用すると、管理者は自身のClaude組織向けにHubSpotコネクタを設定できます。対象となるメンバーは、コネクタをインストールしたり、別途接続を承認したりすることなく、Claude上でHubSpotがすでに接続されていることを確認できます。

Claudeが発行する管理型認証では、管理者がClaude内で自動的にアクセス権を付与する対象を選択し、HubSpot内でコネクタのアクセス権を管理します。各メンバーは、自身のHubSpotユーザーとして、既存のHubSpotの権限のまま接続します。 

始める前に

認証を設定する前に、以下のロールと前提条件となる手順を確認してください：

• HubSpotコネクタで、Claudeから発行された管理型認証を利用可能なClaude TeamまたはEnterprise組織。
• Claudeでコネクタを管理できる管理者、および承認済みアプリを管理できるHubSpotのスーパー管理者。必要に応じて、1人でこの2つの役割を兼任することも可能です。
• HubSpotコネクタは、Claude組織の「コネクタ設定」からご利用いただけます。
• 接続対象のHubSpotアカウントの管理者によって、HubSpotコネクタがインストールされています。他のチームメンバー用にEMAを設定する前に、この既存の接続から始めることができます。
• コネクタを使用する各チームメンバーごとに、有効なHubSpotユーザーアカウントが必要です。各メンバーのClaudeのメールアドレスは、HubSpotで認証済みのメールアドレスと一致している必要があります。

管理者が対象のHubSpotアカウントにコネクタをインストールしていない場合は、以下の手順に従ってClaude用のHubSpotコネクタを設定し、初期接続を完了させてください。その後、続行する前に、アプリの承認およびアクセス設定を確認してください。

HubSpot において、各チームメンバーに適切な権限セットが設定されていることを確認してください。現在サポートされているツールについては、コネクタで許可されているスコープおよびデータ権限の範囲内で、チームメンバーはClaudeにおいてHubSpotと同じ権限および利用権限を使用します。

クロードの管理対象の承認設定とロール制御について、詳しくはこちらをご覧ください。

ClaudeとHubSpotの設定にアクセスする

以下の表は、ClaudeとHubSpotにおけるさまざまなアクセス設定の概要を示しています：

Claudeのコネクタへのアクセス権を誰かに付与しても、その人物のHubSpotユーザーアカウントは作成されず、HubSpotの権限も拡大されることはありません。チームで接続を有効にする前に、両方のサービスでのアクセス権限を確認してください。

Claudeは、コネクタの管理者とユーザーが、設定済みのメールアドレスを持つ、あなたのClaude組織の現在のメンバーであることを確認します。これは、別のIDプロバイダーによるログインを確認するものではなく、そのプロバイダーの多要素認証（MFA）要件やHubSpotのログインルールを確認するものでもありません。Anthropicは、Claudeにおいてシングルサインオン（SSO）を適用することを推奨しています。

管理型認証の設定

以下の手順では、現在のコネクタの権限を確認し、Claudeの設定で組織の発行者URLを確認し、EMAを有効にして、その接続をテストする方法について説明します。

1. HubSpot でコネクタのアクセス権限を確認する

まず、Claude用のHubSpotコネクタの現在の権限を確認してください：

1. HubSpotアカウントにて、上部のナビゲーションバーに表示される設定アイコンをクリックします。
2. 左側のサイドバーメニューから、「連携」→「>」→「接続済みアプリ」の順に選択します。
3. [ 承認済みアプリ ] タブをクリックします。
4. 「Claude」用のHubSpotコネクタを見つけて、「アクセス権の管理」をクリックしてください。
5. [ インストール済み権限 ] タブをクリックし、アプリに接続できるユーザーを確認してください。Claudeへの自動アクセス権を付与すべきHubSpotユーザーを追加してください。また、メンバーはClaude内のコネクタにアクセスできる権限を持ち、管理型認証の対象として選択されたロールに所属している必要があります。
6. [ データ権限 ] タブをクリックし、コネクタがアクセスできるデータと API を確認してください。チームに必要な権限を追加し、変更を保存してください。

HubSpotのアプリデータ権限は、管理者を含むすべてのユーザーに適用されます。必要な権限は無効にすることはできません。アプリのアクセス権限の管理について詳しくはこちらをご覧ください。

別のタブでClaudeアカウントにアクセスする間は、このHubSpotのページを開いたままにしておいてください。

2. Claude組織の発行者URLを取得する

次に、Claudeの設定から「発行者URL」を見つけてコピーします。これは、HubSpotがメンバーを接続する際に信頼するClaude組織を特定するものです。

1. In Claudeでは、[ 組織設定 ]> [ コネクタ ] に移動し、HubSpotを選択します。
2. 私コネクターの設定で、「管理された認証」を見つけ、その設定を開きます。
3. 「ID ソース」で、「Claude-issued」を選択します。
4. 設定画面に表示されている発行元の完全なURL（）をコピーしてください。「Claude」に「手動で設定」と表示されている場合は、それを展開してURLを確認してください。

この設定ページを、別のブラウザウィンドウまたはタブで開いたままにしておいてください。HubSpotでEMAを有効にした後、再びこの画面に戻ります。

3. HubSpotでEMAを有効にする

コピーした発行元URLを使用して、HubSpotでEMAを設定してください：

1. ReturHubSpotのコネクタの「アクセス管理」パネルに戻ります。
2. [ 詳細設定 ] タブをクリックします。
3. 「エンタープライズ管理認証（EMA）」のスイッチをクリックして、設定画面を開きます。
4. Cパネルに表示されているアカウントIDをコピーしてください。これが接続するHubSpotアカウントです。これをClaudeでのテナントIDとして使用します。
5. Claudeから取得した完全なURLを「発行元URL」フィールドに貼り付けてください。
6. 「EMAを有効にする」をクリックします。
7. Cステータスが「オン」になっていること、および保存されている発行元URLが正しいことを確認してください。

EMAの設定が見つからない場合は、以下のトラブルシューティングのセクションをご確認ください。

4. Claudeで接続をテストし、有効にする

EMAの設定が完了したので、Claudeで接続を確認してみましょう：

1. RClaudeの管理対象認証設定画面に戻る。
2. 以下のTJAant ID」フィールドに、コピーしたHubSpotアカウントIDを入力してください。Claudeはこの項目を「任意」と表示していますが、HubSpotとの連携を行う場合は、必ず入力してください。
3. 「テストを実行」をクリックし、すべてのステージが成功したことを確認してください。
4. Cをクリックして、「ロールの設定」を開き続けます。マネージド認証を介して接続させる役割を選択してください。組織でこの設定を有効にする前に、選択内容を確認してください。
5. Click 有効にする。
6. 「コネクタ」のd詳細パネルで、「管理された承認」がオンになっていること、および「適用されたロール」に選択したロールが一覧表示されていることを確認してください。
7. 「管理対象の認証」で、「スコープ」の横にある「編集」をクリックし、Claudeがリクエストできる権限を確認・更新します。
8. を参照し、対象のメンバーがコネクタを見つけて接続できることを確認できるアクセス権を持つビューを確認してください。このアクセス権を変更する必要がある場合は、「編集」をクリックしてください。

Claudeのロール設定は両方とも重要です。メンバーはコネクタへのアクセス権が必要であり、自動的に接続するためには、そのロールが管理対象の認証に含まれている必要があります。また、メンバーは、前述のHubSpotアカウント、Eメール、およびインストール権限に関する要件を満たしている必要があります。クロードの役割設定について詳しくは、こちらのクロードサポート記事をご覧ください。

会員体験を確認する

組織に変更内容を発表する前に、数名のチームメンバーに接続状況を確認してもらってください：

1. OpJA管理された承認が有効になっている組織内のクロード。
2. で、HubSpot が接続されていることを確認してください。必要に応じて、そのコミュニケーションのコネクタを有効にしてください。
3. まずは、データを変更しないリクエストから始めてみましょう。例えば、のようなものです。現在、どのHubSpotアカウントとユーザーとしてログインしていますか？いかなるデータも変更しないでください。
4. C応答に、対象となるHubSpotアカウントおよび（利用可能な場合は）チームメンバーのユーザー詳細が正しく記載されていることを確認してください。
5. Try a HubSpotでチームメンバーがアクセス可能なレコードを読み取るリクエスト。

一部のユーザー情報については、追加の権限が必要となります。それらの詳細情報が利用できない場合でも、接続されたアカウントの確認や、許可されたレコードの読み取りは可能です。オプションの詳細情報が不足しているだけでは、認証に失敗したとは限りません。このチェックを完了させるためだけに、不必要なアクセス権を付与しないでください。

アクセス要件を満たしているチームメンバーは、HubSpotへの個別のサインインや接続同意画面の手続きを行う必要はありません。EMAでは、CRMレコードの更新など、個々のツール操作に対して設定した承認プロンプトは削除されません。

セットアップ後のアクセス管理

セットアップ後にチームメンバーのアクセス権を更新するには：

1. Claudeアカウントで、「Claude Connector」の詳細パネルを開きます。
2. [ 管理型認証 ] で、[ 適用済みロール ] の横にある[編集]をクリックし、管理型認証を使用するロールを変更します。
3. コネクタを検索・接続できるユーザーを変更するには、「アクセス権を持つロール」の横にある[編集]をクリックします。
4. 「スコープ」の横にある「編集」をクリックして、クロードがリクエストできる権限を管理してください。

HubSpotでは、「インストール権限」タブを確認して、アプリへの接続を許可するユーザーを変更し、「データ権限」タブを確認して、アプリがアクセスできるデータやAPIを管理してください。各メンバーは、引き続き各自のHubSpotの権限を使用します。

この記事では、コネクタの一般的な機能や使用方法について詳しく解説しています。

メンバーのアクセス権を削除する

ClaudeとHubSpotの両方で、所属組織の離職手続きに従ってください。クロード組織から人物を削除すると、クロードはその人物に対して新しい身元アサーションを発行しなくなります。一度発行されたアクセストークンは、有効期限が切れるか取り消されるまで引き続き使用可能です。したがって、メンバーシップの変更だけでアクセス権が直ちに削除されるとは考えないでください。

元メンバーのメールアドレスを他のユーザーに割り当てる前に、組織の離職手続きを通じて、その元メンバーをHubSpotユーザーから削除してください。そのコネクタへのアクセス権のみを削除しても、そのメールアドレスに関連付けられている古いHubSpotユーザーは削除されません。

EMAをオフにする

EMAをオフにするには：

1. In Claudeでは、HubSpotコネクタの「管理された認証」設定を開き、「無効にする」をクリックします。
2. HubSpotアカウントにて、上部のナビゲーションバーに表示される設定アイコンをクリックします。
3. 左側のサイドバーメニューから、「連携」>、「接続済みアプリ」>、「承認済みアプリ」の順に選択します。
4. コネクタを見つけ、「アクセス管理」をクリックし、「詳細設定」を選択します。
5. 「エンタープライズ管理認証（EMA）」の切り替えボタンをクリックしてオフにし、次に「無効にする」をクリックして確定してください。

管理された認証を無効にすると、自動接続が終了します。まだコネクタが必要なメンバーは、所属組織の設定およびHubSpotのインストール権限に従い、個別に接続する必要があります。既存のアクセストークンは、有効期限が切れるか、取り消されるまで有効なままとなる場合があります。

トラブルシューティング

以下のセクションでは、セットアップの過程で発生しがちなエラーについて、対処法の指針を示します。

EMAの設定は利用できません

HubSpotのスーパー管理者であること、正しいHubSpotアカウントにログインしていること、およびClaude用に承認済みのHubSpotコネクタを管理していることを確認してください。「詳細設定」に「エンタープライズ管理認証（EMA）」が依然として表示されない場合は、HubSpotサポートに連絡し、お客様のアカウントおよびコネクタでの利用可否を確認してください。

クロードの接続テストが失敗しました

接続に失敗した段階に応じた確認事項の詳細については、以下の表を参照してください：

単なるinvalid_grantエラーだけでは根本原因を特定することはできません。テストをやり直す前に、アカウント、発行元URL、メールアドレスの一致状況、およびアクセス設定を確認してください。

チームメンバーがHubSpotを見つけられない、または依然としてConnectのプロンプトが表示される

まず、そのメンバーが対象のクロード組織に所属しているかどうかを確認してください。「Claude」の設定画面の「コネクタの詳細」ページで、コネクタが見つからない場合は「アクセス権を持つロール」、管理された認証を経由して接続していない場合は「適用されているロール」を確認してください。

HubSpot で、そのユーザーが有効なユーザーアカウントを持っていること、認証済みのメールアドレスが Claude のメールアドレスと一致していること、および接続に必要な権限が設定されていることを確認してください。

チームメンバーが接続はできたものの、期待したデータにアクセスできない

Claudeアカウントでコネクタのスコープ、HubSpotのアプリにおけるデータ権限、およびチームメンバーのHubSpot権限を確認してください。自動接続によって、そのメンバーがHubSpotで利用できないレコードやアクションへのアクセス権が付与されることはありません。

問題が解決しない場合は、失敗した操作の内容と発生時刻を明記の上、サポートまでご連絡ください。サポートリクエストには、アクセストークンや署名付きIDアサーションを含めないでください。