NetSuiteをBreezeアシスタントに連携する

NetSuiteをBreezeアシスタントに連携させると、HubSpotを離れることなくNetSuiteのレコードにアクセスして操作できます。NetSuiteを連携させた後、BreezeアシスタントにNetSuiteから情報を取得させたり、NetSuiteのレコードに対して対応しているアクションを実行させたりすることができます。

たとえば、Breezeアシスタントに、アカウントの NetSuite 取引履歴を要約したり、NetSuite のデータを使って要約やレポートを作成したり、支払い履歴や未決済の請求書など、NetSuite から財務情報を取得したりするよう依頼することができます。

始める前に

NetSuiteをBreezeアシスタントに接続する前に、以下の要件と注意事項を確認してください。

要件を理解する

• NetSuiteをBreezeアシスタントに接続する前に、NetSuiteの管理者はNetSuite内で以下の手順を完了する必要があります。
• Breezeアシスタントを使用するための要件を確認してください。

制限事項と考慮事項について

• NetSuiteはサードパーティのサービスです。このコネクタをご利用の際は、オラクルのデータおよびプライバシーポリシーが適用されます。詳細については、「 Oracleに関連付けられたリスク、統制、およびリスク軽減策」をご覧ください。
• NetSuite AI Connector Service は、HIPAA への準拠について評価されておらず、電子保護医療情報（ePHI）の保存、処理、または送信には使用しないでください。HubSpotアカウントで「センシティブデータ」機能が有効になっている場合は、このコネクタを使用しないことをお勧めします。NetSuite と HIPAAについて詳しくはこちらをご覧ください。
• 変更を確定する前に、Breezeアシスタントが提案した変更内容を確認してください。
• コネクタを介してNetSuiteのデータを削除することはできません。
• デフォルトでは、認証トークンの有効期間は48時間です。NetSuite では、この有効期間を最大 30 日まで延長することができます。トークンの有効期限が切れた場合は、接続を再度認証する必要があります。

NetSuiteにおける管理者の手順

NetSuiteをBreezeアシスタントに接続する前に、NetSuiteの管理者はNetSuite内で以下の手順を完了する必要があります。

1. 必要なNetSuite機能を有効にする

BreezeアシスタントでNetSuiteコネクタを使用する前に、NetSuiteの管理者が必要なSuiteCloud機能を有効にする必要があります。

1. NetSuite で、「設定」→「> 」→「会社」→「> 」→「機能の有効化」の順に選択します。
2. 「SuiteCloud」サブタブをクリックします。
3. 「SuiteScript」セクションでは：
• [ Client SuiteScript] チェックボックスを選択します。プロンプトが表示されたら、「同意する」をクリックして、SuiteCloudの利用規約に同意してください。
• [ Server SuiteScript] チェックボックスを選択します。プロンプトが表示されたら、「同意する」をクリックして、SuiteCloudの利用規約に同意してください。

4. ［認証を管理］セクションで、［OAuth 2.0］チェックボックスを選択してオンにします。プロンプトが表示されたら、「同意する」をクリックして、SuiteCloudの利用規約に同意してください。
5. ［SuiteTalk（ウェブサービス）］セクションで、［RESTウェブサービス］チェックボックスを選択してオンにします。

6. ［保存］をクリックします。

2. コネクタ用のNetSuiteロールを設定する

コネクタへのアクセスが必要な各ユーザーは、必要な権限を持つNetSuiteのロールを持っている必要があります。より広範なアクセス権を持つ既存のロールにこれらの権限を追加するのではなく、コネクタ専用のロールを作成することを検討してください。

ロールの権限を設定する

1. NetSuite で、[ 設定 ]> [ ユーザー/ロール ]> [ロールの管理 ] の順に選択します。
2. 既存のロールを設定するには、そのロールの横にある [ 編集 ] をクリックします。ロールを作成するには、「新規」をクリックします。
3. [ 権限 ] サブタブをクリックし、[ 設定 ] をクリックします。
4. 以下の権限を追加してください：
   • MCP サーバーへの接続：「フルアクセス」を選択します。この権限により、ユーザーはAIコネクタサービスに接続できるようになります。
   • OAuth 2.0 アクセストークンを使用してログインするには、「完全なアクセス権」を選択してください。この権限により、OAuth 2.0 認証が可能になります。
   • REST Web サービス：ユーザーが MCP Standard Tools SuiteApp を通じてレコードの作成、取得、または更新を行う場合は、「フルアクセス」を選択してください。

5. ［保存］をクリックします。

ご注意：NetSuiteのロールを作成した後、そのロールが利用可能になるまで多少時間がかかる場合があります。その役割が利用可能になるまで待ってから、設定を続行してください。

ロールにレコードへのアクセス権限を追加する

Breezeアシスタントに取得させたい NetSuite オブジェクト（受注、請求書、顧客からの入金など）に対して、レコードへのアクセス権限を追加してください。

1. NetSuite で、管理者ロールに切り替えます。
2. 「設定」→「> 」→「ユーザー/ロール」→「> 」→「ロールの管理」の順に選択します。
3. NetSuiteコネクタ用に作成したロールを開きます。
4. 「権限」→「> 」→「トランザクション」に移動します。
5. Breezeアシスタントに取得させたい NetSuite オブジェクトの権限を追加し、各権限のアクセスレベルを「フル」に設定してください。たとえば、受注、請求書、顧客からの入金、またはその他のNetSuiteオブジェクトに対する権限を追加することができます。 
6. ［保存］をクリックします。

ユーザーにロールを割り当てる

1. NetSuite で、「リスト」> 「従業員」> 「従業員」の順に選択します。
2. ロールを割り当てたいユーザーの横にある「編集」をクリックします。
3. ［アクセス］タブに移動します。
4. [ ロール ] で、前の手順で設定したロールを検索して選択します。
5. ［追加］をクリックします。
6. 続いて［保存］をクリックします。

ご注意： NetSuite AI Connector Serviceは、管理者ロール、またはNetSuiteの機能へのフルアクセス権を持つロールでは実行できません。このセキュリティ対策により、外部のAIクライアントのセキュリティが侵害された場合でも、意図しない結果が生じるのを防ぐことができます。

3. MCP Standard Tools SuiteApp をインストールする

BreezeアシスタントでNetSuiteコネクタを使用するには、MCP Standard Tools SuiteAppをインストールしてください。SuiteApp を使用すると、Breezeアシスタント内で自然言語を使って NetSuite のデータを照会することができます。

SuiteAppは、ユーザーの既存のNetSuiteのロールと権限に基づいて、ユーザーがアクセスできるデータや操作を決定します。

1. NetSuiteの管理者としてNetSuiteにログインしてください。
2. [ SuiteApps ] タブをクリックします。
3. 「Search SuiteApps」フィールドに「MCP Standard Tools」と入力してください。
4. 「MCP Standard Tools」アイコンをクリックします。
5. SuiteApp ページの右上にある [ インストール ] をクリックします。
6. インストールが完了するまでお待ちください。

4. OAuth 2.0 連携レコードを作成する

NetSuite に連携レコードを作成し、NetSuite と HubSpot 間の OAuth 2.0 認証を設定します。詳細については、NetSuiteのドキュメントをご覧ください。

1. NetSuite で、[ 設定 ] → [> 連携 ] (> ) → [ 連携の管理 ] (> ) → [ 新規 ] の順に選択します。
2. 連携の名前を入力してください。
3. [ State] フィールドを [ Enabled ] に設定します。
4. 「OAuth 2.0 のスコープ」セクションでは：

• • [ 認証コードの付与 ] チェックボックスを選択します。

• • [ パブリッククライアント ] チェックボックスのチェックを外してください。NetSuiteとHubSpotを連携させるには、クライアントシークレットが必要です。
  • 「リダイレクト URI」フィールドに、HubSpot のリダイレクト URIを入力してください。URIには必ず「https://oauth-redirect.hubspot.com/callback/netsuite_mcp」を使用する必要があります。

• • [ NetSuite AI Connector Service ] のチェックボックスを選択します。
  • 「RESTlets」、「REST Web Services」、「SuiteAnalytics Connect」を含む、その他のOAuthスコープのチェックボックスをすべてオフにしてください。

5. 「トークンベースの認証」および「クライアント認証情報」セクションにあるすべてのチェックボックス（「クライアント認証情報（M2M）グラント」チェックボックスを含む）のチェックを解除してください。
6. ［保存］をクリックします。
7. 生成されたクライアントIDとクライアントシークレットをコピーし、安全に保管してください。

ご注意：クライアントIDとクライアントシークレットは、連携レコードを初めて保存した後にのみ表示されます。これらの値を保存しない場合は、新しい認証情報を生成するために、連携レコードでこれらの値をリセットする必要があります。

5. NetSuite MCP サーバーの URL を確認する

MCPサーバーのURLは、お客様のNetSuiteアカウントごとに固有のものであり、この接続を通じて利用可能なツールを決定します。

アカウントIDを確認する

1. NetSuite で、「設定」> 「会社」> 「会社情報」の順に選択します。
2. ページの上部にあるアカウントIDを見つけてください。
3. [ 会社のURL]タブをクリックして、アカウント固有の SuiteTalk URL を確認してください。

適切なMCPサーバーのURLを設定してください

• MCP Standard Tools SuiteApp を使用するには、以下の URL を使用してください：
  https:// <accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools
• 利用可能なすべてのSuiteAppsおよびアカウントのカスタマイズプロジェクトを表示するには、以下を使用してください：
  https:// <accountid>.suitetalk.api.netsuite.com/services/mcp/v1/all
• 特定のSuiteAppを公開するには、以下を使用します：
  https:// <accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/ <publisherid>. <projectid>
• NetSuiteアカウントIDを<accountid>を、ご自身のNetSuiteアカウントIDに置き換えてください。

NetSuiteをBreezeアシスタントに連携する

NetSuiteの管理者が NetSuiteでコネクタの設定を完了したら、NetSuiteをBreezeアシスタントに接続してください。開始する前に、NetSuite MCPのサーバーURL、クライアントID、およびクライアントシークレットを用意しておいてください。

1. HubSpotアカウントにて、上部のナビゲーションバーに表示されるマーケットプレイスアイコン をクリックし、［HubSpotマーケットプレイス］を選択します。
2. NetSuiteコネクタを検索して選択します。
3. ［インストール］をクリックします。
4. 表示されるダイアログボックスで、次の操作を行います。
   • 「NetSuite MCP サーバー URL」フィールドに、お使いの NetSuite アカウントのNetSuite MCP サーバー URLを入力してください。
   • 「クライアント ID」フィールドには、NetSuite 連携レコードから生成されたクライアント IDを入力してください。
   • 「クライアントシークレット」フィールドには、NetSuite 連携レコードから生成されたクライアントシークレットを入力してください。
5. 「netsuite_mcp」への接続をクリックしてください。

6. NetSuiteのページにリダイレクトされます。必要なMCP権限を持つ管理者以外のロールでログインし、HubSpotがNetSuiteにアクセスできるよう承認してください。
7. 認証が完了すると、HubSpot にリダイレクトされ、接続が確立されます。

Breezeアシスタントでコネクタを使用する

接続が完了したら、BreezeアシスタントにNetSuite内の情報を取得したり、操作を実行したりするよう依頼してください。

1. 上部のナビゲーションバーで、「Breezeアシスタント」をクリックします。 
2. 「+」をクリックし、「コネクタ」に移動します。
3. クリックして、NetSuiteコネクタのスイッチをオンにしてください。
4. 次に、プロンプトを入力してください。
   例えば、次のような操作が可能です： 

• • Breezeアシスタントに、NetSuite内の特定の会社に関する直近5件の販売注文（商品項目、金額、現在のステータスを含む）を表示するよう依頼してください。
  • Breezeアシスタントに、NetSuite内のすべての子会社において、支払期限から60日以上経過している未払いの請求書を、金額順に並べ替えてすべて表示するよう依頼してください。
  • Breezeアシスタントに、NetSuiteで今週作成され、まだ「履行待ち」ステータスのままのすべての販売注文を表示するよう依頼してください。
  • Breezeアシスタントに、NetSuiteにおける今年第1四半期と第2四半期の子会社別総収益を比較するよう依頼してください。
  • Breezeアシスタントに、NetSuiteの特定の子会社において、過去6か月以内にNetSuiteでの初回注文を行ったすべての顧客を表示するよう依頼してください。
  • Breezeアシスタントに、NetSuite内の特定の会社に関する、すべての注文、請求書、支払い、および未解決事項を含む完全なアカウント概要を表示するよう依頼してください。

5. 右下の「送信」アイコンをクリックしてください。
6. Breezeアシスタントは、お客様のNetSuiteデータに基づいて回答を生成します。