チュートリアル: データベース・ツールMCPサーバーの設定とMCPクライアントとの統合

この表は、データベース・ツールMCPサーバーを作成し、それをMCPクライアントと統合するステップを示しています。

allow group 'dbtools-mcp'/'MCP_All_Users' to use database-tools-mcp-servers-invocation in compartment dbtools-mcp
allow any-user to use database-tools-connections in compartment dbtools-mcp where request.principal.id = 'ocid1.databasetoolsmcpserver.oc1.phx.xxxx'
allow any-user to use database-tools-runtime-work-requests in compartment dbtools-mcp where request.principal.id = 'ocid1.databasetoolsmcpserver.oc1.phx.xxxx'
allow any-user to read secret-bundles in compartment dbtools-mcp where request.principal.id = 'ocid1.databasetoolsmcpserver.oc1.phx.xxxx'
allow any-user to use buckets in compartment dbtools-mcp where request.principal.id = 'ocid1.databasetoolsmcpserver.oc1.phx.xxxx'
allow any-user to manage objects in compartment dbtools-mcp where request.principal.id = 'ocid1.databasetoolsmcpserver.oc1.phx.xxxx'

allow group 'dbtools-mcp'/'MCP_All_Users' to use database-tools-mcp-servers-invocation in compartment dbtools-mcp
allow group 'dbtools-mcp'/'MCP_All_Users' to use database-connections in compartment dbtools-mcp
allow group 'dbtools-mcp'/'MCP_All_Users' to use database-tools-connections in compartment dbtools-mcp
allow group 'dbtools-mcp'/'MCP_All_Users' to use database-tools-runtime-work-requests in compartment dbtools-mcp
allow group 'dbtools-mcp'/'MCP_All_Users' to read secret-bundles in compartment dbtools-mcp
allow group 'dbtools-mcp'/'MCP_All_Users' to use buckets in compartment dbtools-mcp
allow group 'dbtools-mcp'/'MCP_All_Users' to manage objects in compartment dbtools-mcp

パスワード・ベース認証の場合

1. データベースへの接続に使用するスキーマを使用して、データベース・ツール接続dbuser@dbtoolsmcpを作成します。

   接続の作成の詳細は、「接続の作成」をご覧ください。

2. 接続の作成時に次の詳細を入力します。

   • 「Oracle Autonomous AI Database」を選択します。
   • ユーザー名: ADMINを入力します。
   • ユーザー・パスワード・シークレットの選択
   • Wallet形式を選択します。Oracle auto-login wallet (cwallet.ssoなど)
   • SSOウォレット・コンテンツ・シークレットを選択します。
   • 「拡張オプション」 - 「設定」で、「ランタイム・アイデンティティ」を「リソース・プリンシパル」に設定します。
     ノート
     
     

     • 接続リソース・プリンシパルは、シークレットを取得するために使用されます。
     • ユーザー・パスワード・シークレットおよびウォレット・コンテンツ・シークレットは、データベース・ツール接続リソース・プリンシパルがシークレットの読取りを許可されているのと同じコンパートメントに作成する必要があります。

トークンベースの認証の場合

1. パスワードベースの認証を使用して、特権ユーザー(ADMINなど)を持つデータベース・ツール接続admin@dbtoolsmcpをdbtools-mcpコンパートメントに作成します。
2. データベースでIAM認証を有効にします。
   1. admin@dbtoolsmcp接続を選択します。
   2. 「アクション」を展開し、「外部認証の構成」を選択します。
   3. 「外部認証タイプ」で、「OCI_IAM」を選択します。
   4. 構成を保存するには、「更新」をクリックします。

3. トークンベースの認証を使用して、dbtools-mcpコンパートメントにデータベース・ツール接続dbtoolsmcpを作成します。

   接続の作成時:

   • 「Oracle Autonomous AI Database」を選択します。
   • 「拡張オプション」 - 「認証」で、「トークン・ベース認証の使用」を有効にします。

各アプリケーション・ロールのドメインでのグループの作成

1. 「モデル・コンテキスト・プロトコル・サーバー」ページで、「mcpserver」、「ドメイン」の順に選択します。

2. dbtools-mcpドメインで、「ユーザー管理」、「グループ」の順に移動します。

3. 次のグループを作成します。

   グループ名	アプリケーション・ロール
   MCP_管理者	MCP_管理者
   MCP_演算子	MCP_オペレータ
   MCP_ユーザー	MCP_ユーザー
   MCP_全ユーザー	該当なし

   ドメインでのグループの作成の詳細は、グループの作成を参照してください。

アプリケーション・ロールへのグループの割当て

1. 「モデル・コンテキスト・プロトコル・サーバー」ページで、「mcpserver」を選択し、「ロール」タブを選択します。
2. 「ロールの割当て」をクリックします。

3. 各アプリケーション・ロールについて:

   1. 「アクション」アイコンをクリックして、「グループの管理」を選択します。
   2. 「グループの割当て」をクリックします。
   3. 「使用可能」グループのリストで、必要なグループを選択します。
   4. 「割当て」をクリックします。

ドメインでのユーザーの作成

ドメインdbtools-mcpに対して、ユーザーを作成します。

アイデンティティ・ドメインでユーザーを作成する方法を学習するには、アイデンティティ・ドメインでのユーザーの作成を参照してください。

dbtools-mcpドメインの場合、ユーザーをグループに割り当てます。

ユーザーをグループに追加する方法を学習するには、「グループへのユーザーの追加」を参照してください。

個人アクセス・トークンの生成

1. 「プロファイル」アイコンをクリックし、<ユーザー電子メールID>を選択します。

2. 「トークンとキー」タブを選択します。

3. 「自分のアクセス・トークン」セクションの「他のAPIの起動」で、「トークンのダウンロード」をクリックします。

   

4. 「個人アクセス・トークンの生成」ページで:

   1. トークンを生成するMCPサーバーを選択します。
   2. 「トークンの有効期限が分単位」で、トークンの有効期限を分単位で選択します(たとえば、10080分は1週間に相当します)。
      ノート
      
      MCPサーバーの「アクセス・トークンの有効期限」設定は、MCPサーバーの「トークンの有効期限(分)」設定に指定された期間によって置き換えられます。MCPサーバーの「詳細」ページに移動して、「アクセス・トークンの有効期限」設定を確認します。「アクセス・トークンの有効期限」設定の場所を確認するには、MCPサーバーへの接続を参照してください。
   3. 「トークンをダウンロード」をクリックします。

MCPサーバーに接続するためのMCPクライアントの構成

1. Visual Studio CodeのCline拡張機能で、「MCPサーバー」アイコンを選択し、「リモート・サーバー」タブを選択します。
2. サーバーの名前とサーバーURLを入力します。サーバーURLは、次のようにMCPサーバーの「詳細」ページで使用できます。

   https://example.oraclecloud.com/../actions/invoke

3. 「トランスポート・タイプ」で、「ストリーミング可能なHTTP」を選択します。

4. 「サーバーの追加」をクリックします。

   

   「構成」タブが選択され、サーバーがエラーとともに表示されます。

   

5. 「MCPサーバーの構成」をクリックします。

   cline_mcp_setting jsonファイルの内容が右側のペインに表示されます。

   次のようにファイルを更新します。

   {
     "mcpServers": {
       "dbtools-mcp-server": {
         "disabled": false,
         "timeout": 60,
         "type": "streamableHttp",
         "url": "https://mcp.../x.xxxxx/actions/invoke",
         "headers": {
           "Authorization": "Bearer {Add downloaded token}"
         }
       }
     }
   }

6. ファイルを保存します。

   エラー・メッセージが解決されます。これは、サーバー名と同じ行に表示される緑色のインジケータで示されます。

   

   サーバー名を展開して、使用可能なツール、リソースおよびプロンプトを表示します。

   

登録済のパブリック・クライアントでmcp-remoteを使用してVS CodeのCline拡張機能をMCPサーバーに接続するには、VS Code内でサーバーを構成し、ブラウザ・プロンプトを介して認証フローを完了する必要があります。

1. mcp-remoteをインストールします。

   次のコマンドを使用します。

   npm install -g mcp-remote

2. cline_mcp_settings.jsonファイルを編集します。

   {
     "mcpServers": {
       "dbtools-mcp-server": {
         "disabled": false,
         "timeout": 60,
         "type": "stdio",
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote",
           "https://mcp.…./actions/invoke",
           "8080",
           "--transport",
           "http-only",
           "--static-oauth-client-metadata",
           "{ \"scope\": \"https://mcp." }",
           "--static-oauth-client-info",
           "{ \"client_id\": \"xxxx\" }"
         ]
       }
     }
   }

   OAuthパブリック・クライアントにhttp://localhost:8080/oauth/callbackというリダイレクトURIが構成されていることを確認します。

   ノート
   
   ポート(8080)は、JSON構成ファイルでmcp-remoteに渡すポート番号と一致する必要があります。

   サインインすると、mcp-remoteはマシン上にトークンをローカルに保存します。

   例:

   ~/.mcp-auth/mcp-remote-N.N.NN/xxxxx_tokens.json

3. VSコードを再起動し、Clineでdbtools-mcp-serverに接続します。ブラウザが開き、サインインを完了してアクセスを承認します。