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

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

CData Connect AI は、Oktaを含む数百のデータソースをMCP経由でAIツールにつなげるクラウドサービスです。接続情報はConnect AI側で一元管理されるため、Gemini CLIにOktaの認証情報を直接渡すことなくセキュアに連携できます。

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

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

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

   Okta に接続するには、Domain 接続文字列プロパティをお使いのOkta ドメインに設定します。 Okta はOAuth およびOAuthJWT 認証をサポートしています。

   OAuth認証

   OAuth で認証するには、AuthScheme をOAuth に設定する必要があります。また、カスタムOAuth アプリケーションを作成する必要があります。

   カスタムOAuth アプリケーションの作成

   Okta アカウントから：

   1. 管理者アカウントでOkta のデベロッパーエディションにサインインします。
   2. Admin Consoleで、Applications > Applications に移動します。
   3. Create App Integration をクリックします。
   4. Sign-in method は、OIDC - OpenID Connect を選択します。
   5. Application type は、Web Application を選択します。
   6. カスタムアプリケーションの名前を入力します。
   7. Grant TypeをAuthorization Code に設定します。トークンを自動的に更新したい場合は、Refresh Token もチェックしてください。
   8. コールバックURL を設定します。
      • デスクトップアプリケーションやヘッドレスマシンでは、http://localhost:33333 または任意の別のポート番号を使用します。ここで設定したURI が、CallbackURL プロパティになります。
      • Web アプリケーションの場合、コールバックURL を信頼できるリダイレクトURL に設定します。このURL は、アプリケーションへのアクセスが許可されたことを示すトークンを伴ってユーザーが戻ってくるWeb 上の場所です。
   9. Assignments セクションで、Limit access to selected groups を選択してグループを追加するか、グループの割り当ては一旦スキップします。
   10. OAuth アプリケーションを保存します。
   11. アプリケーションのGeneral タブに、アプリケーションのClient Id とClient Secret が表示されます。後で使用できるように、これらを記録してください。Client Id はOAuthClientId の設定に使用し、Client Secret はOAuthClientSecret の設定に使用します。
   12. Assignments タブを確認し、アプリケーションにアクセスする必要のあるすべてのユーザーがアプリケーションに割り当てられていることを確かめます。
   13. Okta API Scopes タブで、OAuth アプリケーションに付与するスコープを選択します。これらのスコープは、アプリが読み取り可能なデータを決定します。そのため、特定のビューに対するスコープを付与しないと、そのビューに対するクエリを実行する権限がドライバーに付与されません。各ビューに必要なスコープを確認するには、ヘルプドキュメントのデータモデル > ビュー のビュー固有のページを参照してください。

   OAuth 認証の詳細や、OAuthJWT 認証については、ヘルプドキュメントを参照してください。

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

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

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

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

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

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

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

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

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

   gemini

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

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

CData Connect AI を入手する

クラウドアプリケーションから直接、数百種類のSaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを実現するには、今すぐCData Connect AI をお試しください！