【MCP Server】n8n からNetSuite のデータと連携しよう！

加藤龍彦
加藤龍彦
デジタルマーケティング
CData Connect AI のリモートMCP Server で n8n から NetSuite へのリアルタイムアクセスを実現。ワークフロー自動化でデータの読み取りとアクション実行を簡単に。

n8n は、さまざまなアプリケーションやサービスを接続してタスクやプロセスを自動化できる、オープンソースのワークフロー自動化ツールです。CData Connect AI のリモートMCP と組み合わせることで、n8n を活用して NetSuite とリアルタイムでやり取りできます。この記事では、Connect AI Remote MCP を使用して NetSuite に接続し、n8n で NetSuite とやり取りする基本的なワークフローを作成する方法をご紹介します。

CData Connect AI は、NetSuite のデータに接続するための専用クラウド間インターフェースを提供します。CData Connect AI Remote MCP Server により、Google ADK エージェントと NetSuiteの間でセキュアな通信が可能になります。これにより、ネイティブ対応データベースへのデータレプリケーションを必要とせずに、エージェントから NetSuite のデータ の読み取りや操作を実行できます。CData Connect AIは最適化されたデータ処理機能を備えており、フィルタや JOIN を含むサポート対象のすべての SQL 操作を効率的に NetSuiteへ直接送信します。サーバーサイド処理を活用することで、要求されたNetSuite のデータ を迅速に取得できます。

この記事では、n8n でシンプルなチャットエージェントを構築して、データを会話形式で探索（Vibe Query）する方法をご紹介します。ここで紹介する接続の原則は、あらゆる n8n ワークフローに適用できます。Connect AI を使用すれば、NetSuite に加えて、数百の他のデータソースにもアクセスできるワークフローやエージェントを構築できます。

NetSuite データ連携について

CData は、Oracle NetSuite のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています：

  • Standard、CRM、OneWorld を含む、すべてのエディションの NetSuite にアクセスできます。
  • SuiteTalk API（SOAP ベース）のすべてのバージョンと、SQL のように機能し、より簡単なデータクエリと操作を可能にする SuiteQL に接続できます。
  • Saved Searches のサポートにより、事前定義されたレポートとカスタムレポートにアクセスできます。
  • トークンベースおよび OAuth 2.0 で安全に認証でき、あらゆるユースケースで互換性とセキュリティを確保します。
  • SQL ストアドプロシージャを使用して、ファイルのアップロード・ダウンロード、レコードや関連付けのアタッチ・デタッチ、ロールの取得、追加のテーブルやカラム情報の取得、ジョブ結果の取得などの機能的なアクションを実行できます。

お客様は、Power BI や Excel などのお気に入りの分析ツールからライブ NetSuite データにアクセスするために CData ソリューションを使用しています。また、CData Sync を直接使用するか、Azure Data Factory などの他のアプリケーションとの CData の互換性を活用して、NetSuite データを包括的なデータベースやデータウェアハウスに統合しています。CData は、Oracle NetSuite のお客様が NetSuite からデータを取得し、NetSuite にデータをプッシュするアプリを簡単に作成できるよう支援し、他のソースからのデータを NetSuite と統合することを可能にしています。

当社の Oracle NetSuite ソリューションの詳細については、ブログをご覧ください：Drivers in Focus Part 2: Replicating and Consolidating ... NetSuite Accounting Data


はじめに


ステップ 1：n8n 用の NetSuite 接続を設定する

n8n から NetSuite への接続は、CData Connect AI のリモートMCP を通じて実現されます。n8n から NetSuite とやり取りするために、まず CData Connect AI で NetSuite 接続を作成・設定していきましょう。

  1. Connect AI にログインし、「Sources」をクリックして、「Add Connection」をクリックします
  2. 「Add Connection」パネルから「NetSuite」を選択します
  3. NetSuite に接続するために必要な認証プロパティを入力します。

    NetSuiteへの接続

    NetSuite では、2種類のAPI でデータにアクセスできます。どちらのAPI を使用するかは、Schema 接続プロパティで以下のいずれかを選択して指定してください。

    • SuiteTalk は、NetSuite との通信に使用されるSOAP ベースの従来から提供されているサービスです。幅広いエンティティをサポートし、INSERT / UPDATE / DELETE の操作も対応しています。ただし、SuiteQL API と比べるとデータの取得速度が劣ります。また、サーバーサイドでのJOIN に対応していないため、これらの処理はCData 製品がクライアントサイドで実行します。
    • SuiteQL は、より新しいAPI です。JOIN、GROUP BY、集計、カラムフィルタリングをサーバーサイドで処理できるため、SuiteTalk よりもはるかに高速にデータを取得できます。ただし、NetSuite データへのアクセスは読み取り専用となります。

    データの取得のみが目的でしたらSuiteQL をお勧めします。データの取得と変更の両方が必要な場合は、SuiteTalk をお選びください。

    NetSuite への認証

    CData 製品では、以下の認証方式がご利用いただけます。

    • トークンベース認証（TBA）はOAuth1.0に似た仕組みです。2020.2以降のSuiteTalk とSuiteQL の両方で利用できます。
    • OAuth 2.0 認証（OAuth 2.0 認可コードグラントフロー）は、SuiteQL でのみご利用いただけます。
    • OAuth JWT 認証は、OAuth2.0 クライアント認証フローの一つで、クライアント認証情報を含むJWT を使用してNetSuite データへのアクセスを要求します。

    トークンベース認証（OAuth1.0）

    トークンベース認証（TBA）は、基本的にOAuth 1.0 の仕組みです。この認証方式はSuiteTalk とSuiteQL の両方でサポートされています。管理者権限をお持ちの方がNetSuite UI 内でOAuthClientId、OAuthClientSecret、OAuthAccessToken、OAuthAccessTokenSecret を直接作成することで設定できます。 NetSuite UI でのトークン作成手順については、ヘルプドキュメントの「はじめに」セクションをご参照ください。

    アクセストークンを作成したら、以下の接続プロパティを設定して接続してみましょう。

    • AuthScheme = Token
    • AccountId = 接続先のアカウント
    • OAuthClientId = アプリケーション作成時に表示されるコンシューマーキー
    • OAuthClientSecret = アプリケーション作成時に表示されるコンシューマーシークレット
    • OAuthAccessToken = アクセストークン作成時のトークンID
    • OAuthAccessTokenSecret = アクセストークン作成時のトークンシークレット

    その他の認証方法については、ヘルプドキュメントの「はじめに」をご確認ください。

  4. 「Create & Test」をクリックします
  5. 「Add NetSuite Connection」ページの「Permissions」タブに移動し、ユーザーベースの権限を更新します。

パーソナルアクセストークンの追加

パーソナルアクセストークン（PAT）は、n8n から Connect AI への接続を認証するために使用されます。アクセス制御の粒度を維持するために、サービスごとに個別の PAT を作成することをおすすめします。

  1. Connect AI アプリの右上にある歯車アイコン（）をクリックして、設定ページを開きます。
  2. 設定ページの「Access Tokens」セクションに移動し、「Create PAT」をクリックします。
  3. PAT に名前を付けて「Create」をクリックします。
  4. パーソナルアクセストークンは作成時にのみ表示されますので、必ずコピーして安全な場所に保管してください。

これで接続の設定と PAT の生成が完了しました。n8n から NetSuite に接続する準備が整いました。

ステップ 2：n8n を CData Connect AI に接続する

以下の手順に従って、n8n で CData Connect AI に接続していきましょう：

  1. n8n.io にサインインするか、新しいアカウントを作成します。
  2. MCP Client ツールを使用するワークフローをn8n で作成します。以下の例では、チャットボットとして機能するワークフローを作成しています。チャットモデルには OpenAI を使用し、Memory には Simple Memory を使用しました。
  3. ワークフロー内の MCP Client ノードを設定します：
    • Endpoint をhttps://mcp.cloud.cdata.com/mcp に設定します（Connect AI の「Connect Data to AI」リボンに記載されています）。
    • Server Transport を HTTP Streamable に設定します。
    • Authentication を Header Auth に設定し、以下のプロパティを設定して Basic 認証を使用します。
      • Name を Authorization に設定します。
      • Value を Basic EMAIL:PAT に設定し、EMAIL と PAT をConnect AI のメールアドレスと先ほど作成した PAT に置き換えます。例：Basic [email protected]:Uu90pt5vEO...

オプション：AI エージェントにコンテキストを提供する

このステップでは、AI Agent ノードの System Message パラメータを通じて、AI エージェントの役割を確立し、会話のコンテキストを提供します。エージェントに MCP Server エキスパートとしての役割と利用可能なツールのリストを明示的に伝えるシステムメッセージを提供することで、エージェントの理解と応答の精度を高めることができます。例えば、System Message を以下のように設定できます。 

あなたは、CData Connect AI MCP Server に接続された MCP Client ツールの使用エキスパートです。常に徹底的に検索し、各クエリに最も関連性の高い MCP Client ツールを使用してください。以下は、利用可能なツールとそれぞれの説明です：
queryData: 接続されたデータソースに対して SQL クエリを実行し、結果を取得します。queryData ツールを使用する場合は、テーブル名に次の形式を使用してください：catalog.schema.tableName
execData: 接続されたデータソースに対してストアドプロシージャを実行します
getCatalogs: CData Connect AI から利用可能な接続のリストを取得します。接続名は、他のツールや CData Connect AI へのクエリでカタログ名として使用する必要があります。特定のカタログで利用可能なスキーマのリストを取得するには、`getSchemas` ツールを使用してください。
getColumns: 特定のカタログ、スキーマ、テーブルの CData Connect AI から利用可能なデータベース列のリストを取得します。
getExportedKeys: 特定のカタログ、スキーマ、テーブルの CData Connect AI から外部キー関係のリストを取得します。
getImportedKeys: 特定のカタログ、スキーマ、テーブルの CData Connect AI から外部キー関係のリストを取得します。
getIndexes: 特定のカタログ、スキーマ、テーブルの CData Connect AI からインデックスのリストを取得します。
getPrimaryKeys: 特定のカタログ、スキーマ、テーブルの CData Connect AI からプライマリキーのリストを取得します。
getProcedures: 特定のカタログとスキーマの CData Connect AI からストアドプロシージャのリストを取得します
getProcedureParameters: 特定のカタログ、スキーマ、プロシージャの CData Connect AI からストアドプロシージャパラメータのリストを取得します。
getSchemas: 特定のカタログの CData Connect AI から利用可能なデータベーススキーマのリストを取得します。特定のカタログとスキーマで利用可能なテーブルのリストを取得するには、`getTables` ツールを使用してください。
getTables: 特定のカタログとスキーマの CData Connect AI から利用可能なデータベーステーブルのリストを取得します。特定のテーブルで利用可能な列のリストを取得するには、`getColumns` ツールを使用してください。

ステップ 3：n8n でNetSuite のデータをリアルタイムで探索

n8n でワークフローを作成してMCP Client を接続できたので、n8n を使用して NetSuite と連携できるようになりました。MCP Client ノードを使用すると、NetSuite データソースにクエリを送信し、リアルタイムでレスポンスを受信できます。

n8n でワークフローを開いて実行し、NetSuite とのやり取りを開始してください。MCP Client ノードを使用して、NetSuite に質問したり、データを取得したり、アクションを実行したりできます。

CData Connect AI でビジネスシステムのデータ活用を今すぐスタート

いかがでしたか？Mistral AI から NetSuite へのデータ接続が簡単に完了したのではないでしょうか。業務に使えそう、と感じてくださった方は、14 日間の無償トライアルで AI ツールからビジネスシステムへのリアルタイムデータ接続をぜひお試しください。

はじめる準備はできましたか？

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアル お問い合わせ

この記事の内容

関連記事