【MCP Server】Gemini CLI からAdobe Analytics のデータにリアルタイムで接続する方法

CData Connect AI のリモートMCP Server を活用し、Gemini CLI からAdobe Analytics に安全にアクセスして、データの読み取りやアクション実行を可能にします。

Gemini CLI は、Google のGemini AI モデルへのアクセスを提供するコマンドラインインターフェースツールです。コード生成、テキスト分析、会話型AI 機能を利用できます。コーディングで活用している方も多いのではないでしょうか。CData Connect AI と組み合わせることで、Gemini CLI をAdobe Analytics とリアルタイムに連携できるようになります。この記事では、Connect AI を使用したAdobe Analytics への接続方法と、Adobe Analytics と対話するためのGemini CLI の構成手順をご紹介します。

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

ステップ1: Gemini CLI 用の Adobe Analytics 接続を構成

それでは早速、Gemini CLI から Adobe Analytics への接続を設定していきましょう。Gemini CLI から Adobe Analytics と対話するには、まずCData Connect AI でAdobe Analytics 接続を作成して構成します。

  1. Connect AI にログインし、「Connections」をクリックして「 Add Connection」をクリックします
  2. 「Add Connection」パネルから「Adobe Analytics」を選択します
  3. Adobe Analytics に接続するために必要な認証情報を入力しましょう。

    Adobe Analytics への接続

    それでは、Adobe Analytics に接続していきましょう。接続するには、GlobalCompanyId およびRSID を識別する必要があります。デフォルトでは、ドライバーが会社とレポートスイートの識別を自動で試みますが、これらの値を明示的に指定することも可能です。詳しい手順については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「Adobe Analytics への接続」セクションをご確認ください。

    Adobe Analytics への認証

    続いて、認証方法を設定しましょう。Adobe Analytics はOAuth 認証標準を利用しており、OAuth またはサービスアカウントで認証できます。

    ユーザーアカウント（OAuth）

    ユーザーアカウントでの認証では、すべてのフローでAuthScheme をOAuth に設定する必要があります。詳しい認証手順については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「Adobe Analytics への認証」セクションをご参照ください。

    サービスアカウント

    サービスアカウントではサイレント認証が利用でき、ブラウザでのユーザー認証が不要です。このフローを使用するには、アプリケーションを作成する必要があります。アプリケーションの作成および認可については、ドキュメントの「カスタムOAuth アプリの作成」をご確認ください。これにより、サービスアカウントにアクセス権があるAdobe Analytics データに接続できるようになります。

    サービスアカウントを使用したServer-to-Server OAuth で認証するには、AuthScheme をOAuthClient に設定します。接続には以下のプロパティを設定してください。

    • InitiateOAuth：GETANDREFRESH に設定
    • OAuthClientId：アプリケーション設定のクライアントId に設定
    • OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定

    接続すると、CData 製品がサービスアカウントでのOAuth フローを以下の手順で完了します。

    1. クライアントクレデンシャルOAuth フローで指定されたOAuthClientId およびOAuthClientSecret を使用して、アクセストークンを取得します
    2. OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします
    3. トークンが期限切れになった際に、新しいアクセストークンを要求します
    「Create & Test」をクリックします
  4. 「Add Adobe Analytics Connection」ページの「Permissions」タブに移動し、ユーザーベースの権限を更新します。

パーソナルアクセストークンを追加する

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

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

これで、Gemini CLI からAdobe Analytics に接続する準備が整いました！

ステップ 2: CData Connect AI 用に Gemini CLI を構成

それでは、CData Connect AI に接続するための Gemini CLI を構成していきましょう。

  1. システムに Gemini CLI がインストールされていることを確認します。インストールされていない場合は、npm を使用してインストールしましょう。 
    npm install -g @google/gemini-cli
  2. Gemini CLI の設定ファイルを見つけましょう。ファイルが存在しない場合は新規作成してください。
    • Linux/Unix/Mac: ~/.gemini/settings.json
    • Windows: %USERPROFILE%\.gemini\settings.json
  3. 設定ファイルの「mcpServers」オブジェクトに CData Connect AI を追加します。YOUR_EMAIL とYOUR_PAT を、Connect AI のメールアドレスと先ほど作成したPAT に置き換えてください。 
    {
  "mcpServers": {
    "cdata-connect-cloud": {
      "httpUrl": "https://mcp.cloud.cdata.com/mcp",
      "headers": {
        "Authorization": "Basic YOUR_EMAIL:YOUR_PAT"
      }
    }
  }
}
    例えば、メールアドレスが [email protected] で、PAT が Uu90pt5vEO... の場合、Authorization ヘッダーは次のようになります: 
    "Authorization": "Basic [email protected]:Uu90pt5vEO..."
  4. 設定ファイルを保存します。これで、Gemini CLI はデータ操作に CData Connect AI MCP Server を使用するようになります。

ステップ 3: 自然言語でライブの Adobe Analytics のデータ をクエリする

Gemini CLI が構成され、CData Connect AI に接続されたので、自然言語クエリを使用して Adobe Analytics と対話できるようになりました。MCP 統合により、質問をして Adobe Analytics データソースからリアルタイムで応答を受け取ることができます。

Gemini CLI を使ってデータの探索を始めてみましょう:

  1. ターミナルを開いて、Gemini CLI セッションを開始します: 
    gemini
  2. これで、自然言語を使って Adobe Analytics をクエリできます。例えば:
    • 「過去 30 日間のすべての顧客を表示して」
    • 「最もパフォーマンスの良い製品は何ですか?」
    • 「第 4 四半期の売上トレンドを分析して」
    • 「すべてのアクティブなプロジェクトとその現在のステータスをリスト表示して」
  3. Gemini CLI は、自然言語クエリを適切な SQL クエリに自動的に変換し、CData Connect AI MCP Server を通じて Adobe Analytics データに対して実行します。

Gemini CLI の自然言語処理機能と CData Connect AI の堅牢なデータ接続機能を組み合わせることで、複雑な SQL クエリを記述したり、基礎となるデータ構造の深い技術知識を必要とすることなく、Adobe Analytics を探索して分析できます。

CData Connect AI を入手する

クラウドアプリケーションから 300 以上の SaaS、ビッグデータ、NoSQL ソースへのライブデータアクセスを取得するには、今すぐ CData Connect AI をお試しください!

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

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

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

この記事の内容

関連記事