Sourcegraph Amp からライブ NetSuite データに接続する方法（CData Connect AI 経由）

Sourcegraph Amp は、ステートフルな推論、自動コンテキスト管理、ネイティブ MCP（Model Context Protocol）統合を備えた、インテリジェントで本番環境対応のアシスタントを構築するための最新の AI エージェント環境です。CData Connect AI と組み合わせることで、Amp を活用してNetSuite のデータに自然言語または SQL ベースのクエリでリアルタイムにやりとりするエージェントを作成できます。

CData Connect AI はNetSuite のデータにアクセスするためのセキュアなクラウド間インターフェースを提供します。Connect AI Remote MCP Server を介して、Amp は NetSuite に直接接続し、レプリケーションなしでライブデータのクエリと操作を実行できます。最適化されたプッシュダウン機能により、CData Connect AI はフィルタ、集計、JOIN を含む SQL 操作を NetSuite で直接実行し、高速なリアルタイムパフォーマンスを実現します。

この記事では、Amp エージェントを設定して自然言語または SQL を使ってNetSuite のデータを会話的に探索する方法を説明します。Connect AI を使用すると、NetSuite を含む数百のエンタープライズデータソースにセキュアかつリアルタイムにアクセスできるエージェントを簡単に構築できます。

前提条件

1. アクティブな CData Connect AI アカウント
2. Sourcegraph Amp VS Code 拡張機能または Amp CLI がインストールされていること
3. Node.js v20 以上がインストールされていること
4. NetSuite へのアクセス

はじめに

---

ステップ 1：Sourcegraph Amp 用に NetSuite への接続を設定

Amp から NetSuite への接続は CData Connect AI Remote MCP を介して行います。Amp でNetSuite のデータを操作するには、まず CData Connect AI で NetSuite への接続を作成・設定します。

1. Connect AI にログインして「Sources」をクリック、次に「 Add Connection」をクリック

2. 接続を追加パネルから「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. 「Save & Test」をクリック

ステップ 2：CData Connect AI 用に Amp を設定

MCP エンドポイントをコピー

Amp はホストされた MCP エンドポイントを介して Connect AI と通信します。

https://mcp.cloud.cdata.com/mcp

このエンドポイントにより、Amp と Connect AI ワークスペース間のセキュアなクラウド間通信が可能になります。

Base64 資格情報を生成

Amp で Connect AI に認証するには、Base64 エンコードされた資格情報を生成します。例えば PowerShell では以下のようになります。

{Convert}::ToBase64String{(Text.Encoding)}::ASCII.GetBytes("[email protected]:yourPAT")

[email protected] を Connect AI のメールアドレスに、yourPAT を Personal Access Token に置き換えてください。

Amp に MCP Server を登録

Base64 文字列を取得したら、以下のコマンドで CData Connect AI MCP サーバーを Amp に登録します。

amp mcp add cdata-connect-ai -- npx -y mcp-remote@latest https://mcp.cloud.cdata.com/mcp --header "Authorization: Basic "

これにより Connect AI の設定が Amp の設定ファイルに追加され、CData Connect AI との通信が有効になります。

接続を確認してデータを探索

新しいスレッドを作成

新しい Amp セッションを開始してデータとのやりとりを始めます。

amp thread new



インタラクティブチャットに入る

以下のコマンドで新しいスレッドに接続します:

amp



MCP サーバーを確認

Amp シェル内で登録された MCP サーバーを確認します:

list mcp



データソースを確認

getCatalogs

を実行して、接続されたNetSuite のデータがカタログとして表示されることを確認します。

ステップ 3：ライブ NetSuite データアクセスでインテリジェントエージェントを構築

Amp アプリケーションが設定され CData Connect AI に接続されたので、自然言語を使ってNetSuite のデータとやりとりする高度なエージェントを構築できます。MCP 統合により、エージェントに強力なデータアクセス機能が提供されます。

エージェントで利用可能な MCP ツール

Amp アプリケーションは以下の CData Connect AI MCP ツールにアクセスできます。

• getCatalogs: すべてのデータソースカタログを一覧表示（例: NetSuite1）
• getSchemas: 接続されたカタログ内のデータベーススキーマを返却
• getTables: 指定したスキーマで利用可能なすべてのテーブルとビューを一覧表示
• getColumns: 特定のテーブルまたはビューのカラム定義を返却
• queryData: SQL クエリ（SELECT、INSERT、UPDATE、DELETE）を実行
• getProcedures: ストアドプロシージャまたは API エンドポイントを一覧表示
• getProcedureParameters: ストアドプロシージャのパラメータメタデータを返却
• executeProcedure: ストアドプロシージャを実行（例: NetSuite アクション）

Amp の主な機能

Amp はインテリジェントでデータ対応の AI エージェント構築に最適な、本番環境対応の機能を提供します。

• 自動コンテキスト管理: Amp は会話コンテキストを自動的に維持・呼び出し、手動での状態追跡なしにシームレスなマルチターンインタラクションを実現
• ステートフルな会話: 複数のクエリにわたってコンテキストとメモリを保持し、自然で人間らしい会話を作成
• ネイティブ MCP 統合: Amp は Model Context Protocol（MCP）をネイティブサポートし、CData Connect AI や他の MCP 対応サーバーからライブデータにセキュアかつリアルタイムにアクセス可能
• ツール指向アーキテクチャ: ツールは管理された呼び出し、入力検証、エラー処理を備えたファーストクラスコンポーネントとして扱われる
• 効率的なコンテキスト処理: Amp はプロンプトを動的に最適化し、モデルのトークン制限に近づいても関連情報を保持
• クロスソースクエリ: 単一の会話ワークフロー内で複数の接続データソースを組み合わせてクエリ可能
• きめ細かいアクセス許可制御: ツールアクセスレベルを定義・適用してデータガバナンスとセキュアな統合を維持
• 開発者フレンドリーな CLI と SDK: Amp CLI または VS Code 拡張機能から MCP 接続の管理、エージェントの設定、ワークフローのテストを簡単に実行

使用例

CData Connect AI を通じたライブデータアクセスで Amp エージェントができることの例を紹介します。

• データ分析エージェント:NetSuite のデータのトレンドや異常を特定
• レポート生成エージェント: 自然言語プロンプトからレポートを生成
• インタラクティブチャットボット: ライブデータを使ってインサイトを会話形式で説明
• データ品質エージェント: リアルタイムでデータの不整合を監視・フラグ付け
• 自動化ワークフローエージェント: 定義されたデータ条件に基づいてアラートをトリガー

エージェントのテスト

エージェントが動作したら、自然言語クエリでやりとりできます。例えば:

• 「過去 30 日間のすべての新規リードを表示して」
• 「今四半期で最もパフォーマンスの高いキャンペーンは？」
• 「売上の成長を分析して異常を特定して」
• 「現在のオポチュニティのサマリーレポートを生成して」
• 「ステータスが承認待ちのすべてのレコードを検索して」

CData Connect AI を入手

Amp エージェント環境から直接 300 以上の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを取得するには、CData Connect AI をお試しください。