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

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

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

ステップ1: Gemini CLI 用の Zoho CRM 接続を構成

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

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

   Zoho CRM への接続

   それでは、Zoho CRM に接続していきましょう。データに接続するには、以下の接続パラメータを設定します。

   • Region：Zoho CRM サーバーURL のドメインに関連付けられたリージョン
   • Schema：Zoho CRM のバージョン（v2、v2.1、またはv4）。Zoho CRM のバージョンごとに独自のデータモデルがあります

   これらのプロパティに加えて、認可時にサンドボックスまたは開発者インスタンスのいずれかを選択した場合は、InstanceType 接続プロパティでも同じ設定を行ってください。

   Zoho CRM への認証

   Zoho CRM では、データへの認証に2つの方法が用意されています。お使いの環境に応じて適切な方法を選択てください。

   デスクトップ経由で自分のローカルデータに認証を行う場合（非ブラウザ接続）：CData 製品が提供する埋め込みOAuth アプリケーションを使用

   CData 製品はすでにZoho CRM にOAuth アプリケーションとして登録されています。そのため、デスクトップアプリケーションを介したローカルデータへの接続では、自動的に組み込みアプリケーションが使用されます。 OAuth 交換の繰り返しを避け、ローカルデータにアクセスするたびにOAuthAccessToken を手動で設定する手間を省くには、InitiateOAuth をGETANDREFRESH に設定してください。

   ネットワーク経由で共有データに認証を行う場合（ブラウザ接続）：カスタムOAuth アプリケーションを使用

   すべてのOAuth フローで、この認証を有効にするにはAuthScheme をOAuth に設定する必要があります。

   より詳細な認証手順については、ヘルプドキュメントの「Zoho CRM への認証」をご確認ください。

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

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

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

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

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

ステップ 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: 自然言語でライブの Zoho CRM のデータ をクエリする

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

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

1. ターミナルを開いて、Gemini CLI セッションを開始します:

   gemini

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

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

CData Connect AI を入手する

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