ラベル MCP の投稿を表示しています。 すべての投稿を表示
ラベル MCP の投稿を表示しています。 すべての投稿を表示

2026年9月8日火曜日

MCP Toolbox for DatabasesをOracle IAMでOIDC認証する

先日の記事「GoogleのMCP Toolbox for DatabasesをOracle Databaseで使用してみる」にて構成したOracle Databaseに接続するMCP Toolbox for Databasesに、OpenID Connectによる認証を実装します。IdPにはOracle IAMを使用します。

MCP Toolbox for DatabaseでのOpenID Connectの設定については、以下で説明されています。

Documentation / Configuration / Authentication / Generic OIDC Auth
Generic OIDC Auth

MCPとしての認証は2. MCP Authorizationに記載があります。ドキュメントに記載されている設定例は以下です。
kind: authService
name: my-generic-auth
type: generic
audience: ${YOUR_TOKEN_AUDIENCE}
authorizationServer: https://your-idp.example.com
mcpEnabled: true
scopesRequired:
  - read
  - write
kind, name, type, mcpEnabled(これはtrueにする)は、MCP Toolboxとしての設定です。IdP側(今回はOracle IAM)から入手する必要がある設定値はaudience、authorizationServer、scopesRequiredになります。

MCP Toolboxとしては、authorizationServerの値はアクセス・トークンのiss(Issuer)の値と一致し、かつ、/.well-known/openid-configurationを加えることでOIDCのDiscovery URLとなることを期待しているようです。そのDiscovery URLより取得できるドキュメントに含まれる属性jwks_uriより、JWTの署名検証用の公開鍵を取得します。

Oracle IAMが発行するトークンのデフォルトの発行者(Issuer - issの値)はhttps://identity.oraclecloud.com/です。この発行者に/.well-known/openid-configurationをつけてもOIDC Discovery URLにはならないため、Oracle IAM側の発行者は変更する必要があります。

audienceはOracle IAMのドメインに作成した統合アプリケーションのプライマリ・オーディエンスとして設定した値になります。プライマリ・オーディエンスを設定するには、統合アプリケーションにリソース・サーバーを構成する必要があります。

Oracle IAMではクライアントから提示されたスコープにより、リソース・サーバーが選択されます。そのため、リソース・サーバーにスコープを設定し、そのスコープがユーザー認証時にサーバーに送信されるように接続元のクライアント(今回はMCP Inspector)を構成する必要があります。リソース・サーバーに構成されたスコープは、MCP ToolboxのscopesRequiredに含めます。

MCP Toolboxに設定する値は、上記のように決まります。

以下より、Oracle IAMのドメインでの設定を行います。作業には費用がかからないドメイン・タイプがFreeの、Defaultドメインを使用します。

Oracle Cloudのコンソールから、アイデンティティとセキュリティのドメインを開きます。

ドメインDefaultを開きます。


ドメインURLをコピーします。このURLに/.well-known/openid-configurationを付けるとOIDC Discovery URLとなります。この値がMCP ToolboxのauthorizationServerの値の元になります。MCP ToolboxはauthorizationServerの値がIssuerの値であることを期待しているため、このドメインURLを発行者とする必要があります。ドメインURLの末尾のポート番号:443があると発行者として設定できないため、発行者として登録するURLから:443を削除します。

結果としてMCP ToolboxにauthorizationServerとして設定する値は、ドメインURLから末尾の:443を除いたURLになります。


発行者を上記のドメインURLに変更します。

セキュリティ・タブを選択し、Oauth設定 - デフォルトのトークン発行ポリシーのOAuth設定の編集を開きます。


デフォルトのトークン発行ポリシーの発行者にドメインURL(ポート番号無し)を設定します。

変更の保存をクリックします。


デフォルトのトークン発行ポリシーの発行者が更新されたことを確認します。


統合アプリケーションを作成します。

統合アプリケーション・タブを開き、アプリケーションの追加をクリックします。


アプリケーションのタイプとして機密アプリケーションを選択します。

ワークフローの起動をクリックします。


作成する機密アプリケーションの名前はMCP Hotelsとします。説明は何でもよいのですが、Search for a hotelと記述しています。認証と認可の権限付与を認可として実施はオンにします。

以上を設定して送信します。


統合アプリケーションMCP Hotelsが作成されます。


OAuth構成・タブを選択し、OAuth構成の編集をクリックします。リソース・サーバー構成とクライアント構成の双方を実施します。


クライアント構成はリソース・サーバーの構成を参照するため、リソース・サーバー構成を先に実施します。

このアプリケーションをリソース・サーバーとして今すぐ構成します、を選択します。選択すると、設定画面が表示されます。

必須ではありませんが、トークン・リフレッシュの許可をオンにします。

プライマリ・オーディエンスはMCP Toolbox for Databasesの構成に依存します。今回はローカルホストでデフォルトのポート番号である5000番で接続を待ち受けるように構成しているため、プライマリ・オーディエンスは以下になります。最後にスラッシュをつけます。

http://localhost:5000/

これはMCP Toolboxのaudienceとして設定する値になります。また、MCP Toolboxの起動オプションの--toolbox-urlとして指定する値でもあります。

スコープの追加をオンにし、スコープとしてmcphotelsを追加します。

ここで設定したスコープmcphotelsは、MCP ToolboxのscopesRequiredに含めます。

リソース・サーバーを構成したところで、一旦送信します。


追加したスコープmcphotelsは、表示名をMCP Hotels、説明にSearch for a hotel.としています。


先ほどと同様にOAuth構成の編集を開き、今度はクライアント構成を実施します。

このアプケーションをクライアントとして今すぐ構成します、を選択します。選択すると、設定画面が表示されます。

認可の認可される権限付与タイプとして、クライアント資格証明(これはおそらく無くてもよい)、リフレッシュ・トークン(リソース・サーバーでリフレッシュ・トークンを構成し、クライアントからもリフレッシュ・トークンを要求する場合に必要)、認可コード(必須)をチェックします。

HTTPS以外のURLを許可をオンにし、今回クライアントとして使用するMCP InspectorのリダイレクトURLとして、以下の4つを設定します。

http://localhost:6274/oauth/callback
http://localhost:6274/oauth/callback/debug
http://127.0.0.1:6274/oauth/callback
http://127.0.0.1:6274/oauth/callback/debug

Claude CodeやOpenAI Codexから呼び出す場合は、それぞれのアプリケーションで決められているリダイレクトURLを追加します。

ページの下に移動し、リソースの追加をオンにします。

スコープの追加をクリックし、スコープとして統合アプリケーションMCP Hotelsのhttp://localhost:5000/mcphotels(リソース・サーバーのプライマリ・オーディエンスhttp://localhost:5000/とスコープmcphotelsが連結)を追加します。

以上で送信します。


リソースの追加を行う画面です。

統合アプリケーションMCP Hotelsより範囲(スコープのこと)の選択にある、スコープhttp://localhost:5000/mcphotelsにチェックを入れます。


ここで選択したスコープhttp://localhost:5000/mcphotelsは、MCP InspectorのOAuth設定のスコープに含めます。

以上で統合アプリケーションMCP Hotelsの構成は完了です。

OAuth構成よりクライアントIDとクライアント・シークレットを取得します。

これらの値は、MCP InspectorのOAuth SettingsのClient IDとClient Secretとして設定します。


作成した統合アプリケーションMCP Hotelsをアクティブ化します。


ユーザー・タブを開き、この統合アプリケーションで認証できるユーザーを割り当てます。

ユーザーの割当てをクリックします。


今回の作業を行なっているユーザーを割り当てます。


作成した統合アプリケーションで認証できるユーザーが割り当てられました。


以上で、Oracle IAMでの作業は完了です。

先日の記事で作成したtools.yamlに以下を追記します。OIDC認証の設定oracle-iam-authに加え、アクセス・トークンのsubクレームの値を表示するツールshow_sub_claimを定義しています。

ツールshow_sub_claimの第1パラメータとしてuser_idを設定しています。この値はauthServicesで設定しているoracle-iam-auth、つまりOracle IAMによるOIDC認証で得られたアクセス・トークンのsubの値になります。この値はSELECT文のバインド変数:1に割り当てられます。user_idはパラメータとして定義しているため、MCP Inspectorからツールを呼び出す際に値の入力を求められます。値を入力してもアクセス・トークンのsubの値で置き換えられますが、requiredにfalseを設定(デフォルトはtrueなので、必ず値が必要)することにより、user_idを入力しなくてもツールを実行できるようにしています。
---
kind: authService
name: oracle-iam-auth
type: generic
authorizationServer: [発行者として設定したドメインURL(ポート番号無し)]
audience: http://localhost:5000/
mcpEnabled: true
scopesRequired:
  - openid
  - mcphotels
---
# show sub claim in access token
kind: tool
name: show_sub_claim
type: oracle-sql
source: my-oracle-instance
statement: |
  SELECT :1 sub from dual
description: |
  Show sub claim value in the access token
parameters:
  - name: user_id 
    type: string
    required: false
    description: Auto-populated from token
    authServices:
      - name: oracle-iam-auth
        field: sub
authRequired:
  - oracle-iam-auth
MCP Toolboxを実行する際に--toolbox-urlとしてaudience(resource)を指定します。

./toolbox --config tools.yaml --toolbox-url http://localhost:5000/

mcp-toolbox % ./toolbox --config tools.yaml --toolbox-url http://localhost:5000/

2026-09-08T13:20:06.905274+09:00 INFO "Starting MCP Toolbox for Databases version 1.10.0+binary.darwin.arm64.21f972f" 

2026-09-08T13:20:06.983898+09:00 INFO "Initialized 1 sources: my-oracle-instance" 

2026-09-08T13:20:08.061104+09:00 INFO "Initialized 1 authServices: orcle-iam-auth" 

2026-09-08T13:20:08.061141+09:00 INFO "Initialized 0 embeddingModels: " 

2026-09-08T13:20:08.06143+09:00 INFO "Initialized 4 tools: show_sub_claim, execute_sql, list_all_hotels, list_hotels_in_the_location" 

2026-09-08T13:20:08.061451+09:00 INFO "Initialized 0 prompts: " 

2026-09-08T13:20:08.061472+09:00 INFO "Initialized 1 groups: default" 

2026-09-08T13:20:08.061722+09:00 WARN "wildcard (*) allows any website to access the primitives. This creates a security risk regardless of whether you are in a production or local development environment. Recommended to use --allowed-origins with specific local addresses." 

2026-09-08T13:20:08.061774+09:00 WARN "wildcard (*) hosts allow any domain to access this resource, making it vulnerable to DNS rebinding attacks regardless of whether you are in a production or local development environment. For improved security, use the --allowed-hosts flag to specify trusted domains." 

2026-09-08T13:20:08.062055+09:00 INFO "Server ready to serve!" 



MCP Inspectorに登録済みのMCP ToolboxのServer Settingsを開きます。


OAuth SettingsのClient ID、Client Secret、Scopesを設定します。Scopesに設定する値は以下です。指定するスコープにプライマリ・オーディエンスを含めます。

openid http://localhost:5000/mcphotels


以上で設定はすべて完了です。

動作確認を実施します。

MCP InspectorよりMCP ToolboxのMCPサーバーに接続します。


Oracle CloudのIdentity Domainへのサインインが求められます。


Authenticatorを使ったユーザー認証が行われサインインが完了すると、アプリケーションMCP Hotelsへのアクセス許可が要求されます。

アクセスを許可すると、MCP Toolboxへの接続が完了します。


Toolsタブを開き、ツールshow_sub_claimを選択します。

パラメータuser_idには値を設定できますが、user_idの値はアクセス・トークンのsubの値に置き換えられるため、設定する意味はありません。

user_idには値を設定せずExecute Toolを実行します。


ツールの実行結果として、SUBにサインインに使用したメール・アドレスが返されます。


ツールoracle-sqlに設定するSELECT文にOIDCで認証したユーザー名を渡せるため、ツールの検索範囲をユーザーごとに制限することができます。

今回の記事は以上になります。

完

2026年9月7日月曜日

GoogleのMCP Toolbox for DatabasesをOracle Databaseで使用してみる

GoogleのMCP Toolbox for DatabaseがMCPの2026-07-28を実装したので、Oracle Databaseに接続して使用してみました。

Introduction

オープン・ソースのSDKがOracle Databaseをサポートしていることは少ない印象があるのですが、MCP ToolboxではOracle Databaseを使うことができます。

Oracle using MCP
Oracle Source

利用できるツールはoracle-execute-sql(任意のSQLの実行)、oracle-sql(事前に定義したSQLの実行)の2種類です。ドキュメントには他のツールもありますが、これはoracle-sqlツールにSELECT文を事前定義したツールのようです。

できるだけ時間をかけずに動作確認ができる手順で作業をします。

接続先のOracle Databaseとして手元のMacでコンテナとして動作している、Oracle AI Database 26ai Freeを使用します。接続先はlocalhost:1521/freepdb1になります。接続先となるデータベース・ユーザーはあらかじめ作成しておきます。

動作確認をするクライアントとしてMCP Inspectorを使います。バージョンがv2に上がって、UIが大幅に変更されています。

MCP Inspectorを使用する手順は、Getting StartedのQuickstart(MCP)に記載されています。

Quickstart(MCP)

Quickstart(MCP)のStep 1: Set up your databaseでセットアップするデータベースはpostgresです。今回の接続先はOracle Databaseを想定しているため、以下のスクリプトを実行します。
CREATE TABLE hotels (
  id            NUMBER PRIMARY KEY,
  name          VARCHAR2(80) NOT NULL,
  location      VARCHAR2(80) NOT NULL,
  price_tier    VARCHAR2(80) NOT NULL,
  checkin_date  DATE NOT NULL,
  checkout_date DATE NOT NULL,
  booked        NUMBER NOT NULL CHECK (booked IN (0, 1))
);

alter session set nls_date_format = 'YYYY-MM-DD';

INSERT INTO hotels(id, name, location, price_tier, checkin_date, checkout_date, booked)
VALUES (1, 'Hilton Basel', 'Basel', 'Luxury', '2024-04-22', '2024-04-20', 0);
INSERT INTO hotels(id, name, location, price_tier, checkin_date, checkout_date, booked)
VALUES (2, 'Marriott Zurich', 'Zurich', 'Upscale', '2024-04-14', '2024-04-21', 0);
INSERT INTO hotels(id, name, location, price_tier, checkin_date, checkout_date, booked)
VALUES (3, 'Hyatt Regency Basel', 'Basel', 'Upper Upscale', '2024-04-02', '2024-04-20', 0);
INSERT INTO hotels(id, name, location, price_tier, checkin_date, checkout_date, booked)
VALUES (4, 'Radisson Blu Lucerne', 'Lucerne', 'Midscale', '2024-04-24', '2024-04-05', 0);
INSERT INTO hotels(id, name, location, price_tier, checkin_date, checkout_date, booked)
VALUES (5, 'Best Western Bern', 'Bern', 'Upper Midscale', '2024-04-23', '2024-04-01', 0);
INSERT INTO hotels(id, name, location, price_tier, checkin_date, checkout_date, booked)
VALUES (6, 'InterContinental Geneva', 'Geneva', 'Luxury', '2024-04-23', '2024-04-28', 0);
INSERT INTO hotels(id, name, location, price_tier, checkin_date, checkout_date, booked)
VALUES (7, 'Sheraton Zurich', 'Zurich', 'Upper Upscale', '2024-04-27', '2024-04-02', 0);
INSERT INTO hotels(id, name, location, price_tier, checkin_date, checkout_date, booked)
VALUES (8, 'Holiday Inn Basel', 'Basel', 'Upper Midscale', '2024-04-24', '2024-04-09', 0);
INSERT INTO hotels(id, name, location, price_tier, checkin_date, checkout_date, booked)
VALUES (9, 'Courtyard Zurich', 'Zurich', 'Upscale', '2024-04-03', '2024-04-13', 0);
INSERT INTO hotels(id, name, location, price_tier, checkin_date, checkout_date, booked)
VALUES (10, 'Comfort Inn Bern', 'Bern', 'Midscale', '2024-04-04', '2024-04-16', 0);

commit;
exit;
MCP Toolboxのバイナリをダウンロードします。リリースのページを開き、適切なOS/Architectureのリンクから、バイナリをダウンロードします。私の環境はApple SiliconのmacOSなので、darwin/arm64のバイナリをダウンロードしています。MCP Toolboxは頻繁にアップデートされているようなので、最新のリリースを選択します。2026年9月7日の時点ではv1.10.0でした。



最初はPrebuiltのツールを使用します。Oracle向けのPrebuiltツールを使用する設定については、以下に記載されています。

Prebuilt Configs / Oracle

ダウンロードしたバイナリtoolboxに実行フラグを立てます。

chmod +x toolbox

mcp-toolbox % chmod +x toolbox 

mcp-toolbox % 


MCP ToolboxのPrebuilt構成が必要とする環境変数を設定します。Prebuilt構成を使用する場合、tools.yamlといった構成ファイルは不要です。

export ORACLE_CONNECTION_STRING="ホスト名:ポート番号/サービス名"
export ORACLE_USERNAME="データベース・ユーザー"
export ORACLE_PASSWORD="パスワード"
ORACLE_USE_OCI=false


ORACLE_USE_OCIをtrueにする場合、Oracle Instant Clientが必要です。今回はローカルのコンテナで実行しているOracle AI Database 26ai Freeを接続先とするため、ORACLE_USE_OCIをfalseとしています。Autonomous AI Databaseの場合はtrueにする必要があるでしょう。

mcp-toolbox % export ORACLE_CONNECTION_STRING="localhost:1521/freepdb1"

mcp-toolbox % export ORACLE_USERNAME="apexdev"

mcp-toolbox % export ORACLE_PASSWORD="パスワード"

mcp-toolbox % ORACLE_USE_OCI=false

mcp-toolbox % 


MCP ToolboxをOracleのPrebuilt構成で実行します。

./toolbox --prebuilt oracledb

Server ready to serve!と表示されれば、MCPサーバーとして接続できる状態です。

mcp-toolbox % ./toolbox --prebuilt oracledb                            

2026-09-07T14:24:21.940256+09:00 INFO "Starting MCP Toolbox for Databases version 1.10.0+binary.darwin.arm64.21f972f" 

2026-09-07T14:24:21.942172+09:00 INFO "Using prebuilt tool configurations for: oracledb" 

2026-09-07T14:24:21.942183+09:00 WARN "These prebuilt configs are intended for 'build-time' use cases, where agents are helping trusted developers build things. They are not secure enough for 'run time' use cases, where the agent will be talking to potentially untrusted developers." 

2026-09-07T14:24:22.016809+09:00 INFO "Initialized 1 sources: oracle-source" 

2026-09-07T14:24:22.016839+09:00 INFO "Initialized 0 authServices: " 

2026-09-07T14:24:22.016862+09:00 INFO "Initialized 0 embeddingModels: " 

2026-09-07T14:24:22.017076+09:00 INFO "Initialized 7 tools: list_top_sql_by_resource, list_tablespace_usage, list_invalid_objects, execute_sql, list_tables, list_active_sessions, get_query_plan" 

2026-09-07T14:24:22.017088+09:00 INFO "Initialized 0 prompts: " 

2026-09-07T14:24:22.017102+09:00 INFO "Initialized 2 groups: default, oracle_database_tools" 

2026-09-07T14:24:22.017493+09:00 WARN "wildcard (*) allows any website to access the primitives. This creates a security risk regardless of whether you are in a production or local development environment. Recommended to use --allowed-origins with specific local addresses." 

2026-09-07T14:24:22.017532+09:00 WARN "wildcard (*) hosts allow any domain to access this resource, making it vulnerable to DNS rebinding attacks regardless of whether you are in a production or local development environment. For improved security, use the --allowed-hosts flag to specify trusted domains." 

2026-09-07T14:24:22.017822+09:00 INFO "Server ready to serve!" 


MCP Inspectorを実行します。

npx @modelcontextprotocol/inspector

% npx @modelcontextprotocol/inspector


Starting MCP inspector...


MCP Inspector Web is up and running at:

   http://127.0.0.1:6274?MCP_INSPECTOR_API_TOKEN=26f426782a8a0ed97e6e2d79b1fd4941d91f06803defe71e92a0d77e22dbeb0e


   Sandbox (MCP Apps): http://127.0.0.1:6275/sandbox


   Auth token: 26f426782a8a0ed97e6e2d79b1fd4941d91f06803defe71e92a0d77e22dbeb0e


   Secrets: OS keychain


Opening browser...



ブラウザが起動し、MCP Inspectorの画面が開きます。

最初にAdd Serversから+ Add manuallyを実行します。現在実行中のMCP ToolboxをMCPサーバーとして登録します。


Server IDはmcp-toolboxとします。Transportにstreamable-httpを選択し、URLにhttp://localhost:5000/mcpを設定します。MCP Toolboxはデフォルトで、リクエストをHTTPの5000番ポートで待ち受けます。


MCPサーバーmcp-toolboxが登録されます。Settingsを開きます。


新しいv2のMCP Inspectorは、MCPの2026-07-28を含むMCPの拡張機能に対応しています。


Advertise ExtensionsにはTasks(非同期実行)およびMCP Apps UIのサポートが含まれています。


OAuth SettingsにEnterprise-managed authorizationが含まれています。


MCPサーバーに接続すると、クライアント/サーバー間のメッセージのやり取りが表示されます。


Connection Infoをクリックします。


Server Capabilitiesを見る範囲では、サポートされているのは実質的にToolsのみのようです。


Prebuilt構成として提供されているツールを確認します。Toolsタブを開きます。

execute_sqlは任意のSQLを実行するツールです。それ以外のget_query_plan、list_active_sessions、list_invalid_objects、list_tables、list_tablespace_usage、list_top_sql_by_resourceは受け付けるパラメータの有無はありますが、事前定義されたSQLを実行しているようです。


execute_sqlツールを選択し、sqlとしてselect * from hotelsを記述します。

Execute Toolをクリックし、sqlに与えたSELECT文を実行します。


表HOTELSの内容がJSONドキュメントとして返されます。


Prebuilt構成について、動作が確認できました。

Prebuilt構成で実質的に使用できるツールは、任意のSQLを実行するツールexecute_sqlのみです。それだけでは実用的ではないため、ツールを構成してみます。

任意のSQLを実行するツールとしてexecute_sqlは残し、その他に、すべてのホテルをリストするツールlist_all_hotelsと、指定したロケーションにあるホテルを、検索する上限を設定して返すツールlist_hotels_in_the_lcoationを作成します。

tools.yamlとして以下を記述します。Oracle Databaseの接続先、ユーザー名やパスワードは、Prebuilt構成の際に設定した環境変数を利用します。
kind: source
name: my-oracle-instance
type: oracle
connectionString: ${ORACLE_CONNECTION_STRING}
user: ${ORACLE_USERNAME}
password: ${ORACLE_PASSWORD}
---
# Execute arbitrary SQL.
kind: tool
name: execute_sql
type: oracle-execute-sql
source: my-oracle-instance
description: Use this tool to execute sql statement.
---
# List All hotels.
kind: tool
name: list_all_hotels
type: oracle-sql
source: my-oracle-instance
statement: |
  SELECT * FROM hotels
description: |
  Use this tools to list all hotels.
---
# List hotels located in specific location.
kind: tool
name: list_hotels_in_the_location
type: oracle-sql
source: my-oracle-instance
statement: |
  SELECT * FROM hotels WHERE location = :1
  FETCH FIRST :2 ROWS ONLY
description: |
  List hotels located in specified location. 
  Return the specified number of hotels.
  Example: 
  {{
      "location": "Basel",
      "limit": 10
  }}
parameters:
  - name: location
    type: string
    description: location of the hotel
  - name: limit
    type: integer
    description: number of the hotels to be returned
作成したtools.yamlを構成ファイルとして指定し、toolboxを実行します。

./toolbox --config tools.yaml

mcp-toolbox % ./toolbox --config tools.yaml

2026-09-07T15:34:36.871842+09:00 INFO "Starting MCP Toolbox for Databases version 1.10.0+binary.darwin.arm64.21f972f" 

2026-09-07T15:34:36.926093+09:00 INFO "Initialized 1 sources: my-oracle-instance" 

2026-09-07T15:34:36.926127+09:00 INFO "Initialized 0 authServices: " 

2026-09-07T15:34:36.926146+09:00 INFO "Initialized 0 embeddingModels: " 

2026-09-07T15:34:36.926185+09:00 INFO "Initialized 3 tools: execute_sql, list_all_hotels, list_hotels_in_the_location" 

2026-09-07T15:34:36.926192+09:00 INFO "Initialized 0 prompts: " 

2026-09-07T15:34:36.926206+09:00 INFO "Initialized 1 groups: default" 

2026-09-07T15:34:36.926224+09:00 WARN "wildcard (*) allows any website to access the primitives. This creates a security risk regardless of whether you are in a production or local development environment. Recommended to use --allowed-origins with specific local addresses." 

2026-09-07T15:34:36.926339+09:00 WARN "wildcard (*) hosts allow any domain to access this resource, making it vulnerable to DNS rebinding attacks regardless of whether you are in a production or local development environment. For improved security, use the --allowed-hosts flag to specify trusted domains." 

2026-09-07T15:34:36.926503+09:00 INFO "Server ready to serve!" 



MCP Inspectorからツール一覧を確認します。

tools.yamlに設定したツールexecute_sql、list_all_hotels、list_hotels_in_the_locationの3つが現れていることが確認できます。


ツールlist_hotels_in_the_locationを選択すると、パラメータとして設定したlimitとlocationの入力を要求されます。それぞれ、3、Baselと入力し、Execute Toolを実行します。


locationがBaselのホテルが3つリストされます。


Oracle Corporationからは、ツール開発部門より3種類のMCPサーバーが提供されています。

Oracle MCP Servers

また、それとは別にAutonomous AI Database向けのMCPサーバーが提供されています。

Autonomous AI Database MCP Server
https://www.oracle.com/autonomous-database/mcp-server/

ユースケースによっては、オープンソースのMCPサーバーも検討する価値はあるでしょう。例えば、オンプレミスのOracle Database向けのMCPサーバーはSQLclかORDSで実装することになりますが、現状では両方ともカスタム・ツールの実装をサポートしていません。また、Oracle Databaseの他にもデータ・ソースがあり、それらを同様にOIDC認証したい場合など、認証はMCP Toolboxが行うためデータ・ソースごとの設定は不要になります。確認していませんが、OIDC認証で受け取るIDトークンのsubの値をSQLの引数として渡すこともできるようなので、データの検索範囲も認証されたユーザーに応じて制限できそうです。

完

2026年7月10日金曜日

ORDS 26.2のMCPサーバーを構成する - Microsoft Entra ID編

先日の記事「ORDS 26.2のMCPサーバーを構成する - Auth0編」では、MCPサーバーの認証/認可にAuth0を使用しました。今回の記事では、IdMとしてMicrosoft Entra IDを使用します。

ORDS MCPサーバーから接続するデータベースおよびORDSのコンテナの準備は、記事「ORDS 26.2のMCPサーバーを構成する - Auth0編」と同じです。ORDS MCPサーバーが動作するコンテナを実行しAuth0の構成を始める直前まで、Auth0の記事にそって作業を進めます。

ORDS MCPサーバーへの接続確認にMCP Inspectorを使用します。検証結果を先に書くと、Microsoft Entra IDが発行したアクセス・トークンでORDS MCPサーバーへ接続できませんでした。最終的に以下の課題が残りました。
  • ORDS MCPサーバーは、アクセス・トークンの"scope"クレームにグローバル・スコープ "urn:oracle:dbtools:ords:mcpserver:all" が含まれることを期待しているようです。Microsoft Entra IDが発行するアクセス・トークンは"scp"クレームにグローバル・スコープを含みます。Oktaも同様の仕様ですが、Oktaではカスタム・クレームとして"scope"を追加できました。Entra IDではClaims Mapping Policyで対応できる可能性はありますが、検証で使用しているFreeライセンスでは確認できません。
  • ORDS MCPサーバーは、アクセス・トークンの"aud"クレームの値がMCPサーバーのエンドポイントURLであることを期待しているようです。Microsoft Entra IDが発行するアクセス・トークンの"aud"クレームの値は、アプリケーション(クライアント)IDになります。アクセス・トークンのバージョンを1にすると対応できるかもしれませんが、その場合は、アプリケーションIDのURIにhttp://localhost:8585/mcpを設定できません。
MCP InspectorでORDS MCPサーバーにアクセスし、Microsoft Entra IDからアクセス・トークンを取得するまでが確認できた内容です。

以下より、構成作業について紹介します。


WWW-Authenticateヘッダーのワークアラウンド



ORDS MCPサーバー(エンドポイントURLはhttp://localhost:8585/mcp)にアクセス・トークン無しでアクセスしたときに、以下のWWW-Authenticateヘッダーが返されます。

確認のために実行したcurlコマンドです。

curl -v -X POST http://localhost:8585/mcp |& grep WWW-Authenticate:

ords-mcp2 % curl -v -X POST http://localhost:8585/mcp |& grep WWW-Authenticate:

< WWW-Authenticate: Bearer error="invalid_request", resource_metadata="http://localhost:8585/.well-known/oauth-protected-resource/mcp", scope="urn:oracle:dbtools:ords:mcpserver:all"

ords-mcp2 % 


WWW-Authenticateヘッダーに含まれるscope属性として、ORDS MCPサーバーのグローバル・スコープurn:oracle:dbtools:ords:mcpserver:allが返されています。Microsoft Entra IDではscopeはアプリケーションID URIで修飾される必要があります。

今回の作業ではアプリケーションID URIをhttp://localhost:8585/mcpと設定しています。そのため、scopeの値は http://localhost:8585/mcp/urn:oracle:dbtools:ords:mcpserver:all になります。

ワークアラウンドとして、OpenRestyのリバース・プロキシでWWW-Authenticateヘッダーを入れ替えています。

ORDS MCPサーバーを実行しているコンテナに接続し、OpenRestyの構成ファイルをエディタで開きます。

docker exec -it ords-mcp bash
vi /usr/local/openresty/nginx/conf/nginx.conf

ords-mcp2 % docker exec -it ords-mcp bash

[oracle@a7bdb9847eb3 ~]$ vi /usr/local/openresty/nginx/conf/nginx.conf


コメントのTemporary workaround for Entra ID以下の2行のコメント・アウトを外します。
            # Temporary workaround for Microsoft Entra ID
            more_set_headers -s '401'
                'WWW-Authenticate: Bearer error="invalid_request", resource_metadata="http://localhost:8585/.well-known/oauth-protected-resource/mcp", scope="http://localhost:8585/mcp/urn:oracle:dbtools:ords:mcpserver:all"';
変更を保存したのち、コンテナを抜けて再起動します。

exit
docker restart ords-mcp

[oracle@a7bdb9847eb3 ~]$ exit

exit

ords-mcp2 % docker restart ords-mcp

ords-mcp

ords-mcp2 % 


再度curlコマンドを実行し、WWW-Authenticateヘッダーのscope属性が変更されていることを確認します。

ords-mcp2 % curl -v -X POST http://localhost:8585/mcp |& grep WWW-Authenticate:

< WWW-Authenticate: Bearer error="invalid_request", resource_metadata="http://localhost:8585/.well-known/oauth-protected-resource/mcp", scope="http://localhost:8585/mcp/urn:oracle:dbtools:ords:mcpserver:all"

ords-mcp2 % 


変更が確認できればワークアラウンドの適用は完了です。

Dockerfileを修正してコンテナ・イメージを作成し直すと、コンテナを作成するたびにnginx.confを修正する手間を省けます。


Microsoft Entra IDのアプリケーション構成



作業の多くは記事「Role based JWT profileで保護したORDS REST APIにアクセスする - Microsoft Entra ID編」と重なりますが、省略せずに紹介します。

Microsoft Azureのコンソールより、Microsoft Entra IDを開きます。

サイド・メニューの管理のアプリの登録を開き、新規作成を実行します。


名前はORDS MCP2とします。APIに対応するアプリケーションであるため、リダイレクトURIは設定しません。リダイレクトURIは、この後に作成するクライアントに対応するアプリケーションORDS MCP2 Clientに設定します。

アプリケーションを登録します。


マニフェストを開き、アクセス・トークンのバージョンを2に変更します。


マニフェスト(Microsoft Graphアプリマニフェスト)の"api"に含まれる"requestedAccessTokenVersion"の値を2に変更します。

変更後、保存します。


以上で、アプリケーションIDのURIとしてhttp://localhost:8585/mcpを設定できるようになりました。

APIの公開を開き、アプリケーションIDのURIを追加します。


アプリケーションIDのURIにhttp://localhost:8585/mcpを設定します。

保存をクリックします。


ORDS MCPサーバーのグローバル・スコープ urn:oracle:dbtools:ords:mcpserver:all を追加します。

Scopeの追加をクリックします。


スコープ名はurn:oracle:dbtools:ords:mcpserver:allです。同意できるのはだれですか?に管理者とユーザーを選択します。

管理者の同意の表示名、管理者の同意の説明の双方に「Access to ORDS MCP Server」と記述します。

状態に有効を選択し、スコープの追加を実行します。


ORDS MCPサーバーのアクセス制御にロールを使用します。Microsoft Entra IDでは、アプリロールとしてORDS_MCP_HRを作成し、利用できるコネクション・プールを制御します。アプリロールは、アクセス・トークンのrolesクレームに含まれます。

アプリロールを開き、アプリロールの作成をクリックします。


表示名はSample Schema Human Resources、許可されたメンバーの種類は両方(ユーザー/グループ+アプリケーション)を選択します。

値はORDS_MCP_HR、説明はSample Schema Human Resourcesと記述します。

このアプリロールを有効にしますか?をチェックし、適用をクリックします。


作成したアプリロールORDS_MCP_HRをEntra IDのユーザーに割り当てます。

ユーザーへのアプリロールの割り当ては、エンタープライズアプリケーションに移動して実施します。

概要から、ローカルディレクトリでのマネージドアプリケーションのリンクを開きます。


管理のユーザーとグループを開き、ユーザーまたはグループの追加をクリックします。


ユーザーの選択されていませんをクリックし、ユーザーを選択します。


先ほど作成したアプリロールORDS_MCP_HRを割り当てるユーザーを選択し、選択をクリックします。


割り当てるロール「Sample Schema Human Resources」(値はORDS_MCP_HR)は、すでに選択されています。

割り当てをクリックします。


以上でユーザーにアプリロールORDS_MCP_HRが割り当てられました。

規定のディレクトリに戻り、アプリの登録を開きます。すべてのアプリケーションから、先ほど作成したORDS MCP2を開きます。


APIのアクセス許可を開き、アクセス許可の追加をクリックします。


所属する組織で使用しているAPIを開き、ORDS MCP2を探して選択します。


アプリケーションの許可を選択します。

アクセス許可としてアプリロールORDS_MCP_HRが表示されます。このORDS_MCP_HRをチェックして、アクセス許可の追加を実行します。


アクセス許可にORDS_MCP_HRが追加されました。

アクセス許可の追加を再度クリックします。


先ほどと同様に、所属する組織で使用しているAPIを開き、ORDS MCP2を探して選択します。

今度は委任されたアクセス許可を選択し、アクセス許可として表示されたORDS MCPサーバーのグローバル・スコープ urn:oracle:dbtools:ords:mcpserver:all をチェックして、アクセス許可の追加を実行します。


以上でアクセス許可の設定ができました。


Microsoft Entra IDが発行するアクセス・トークンに、ユーザーを一意に識別できるクレームとしてupnを含めます。

Auth0、Okta、Oracle IAMが発行するアクセス・トークンではsub(subject)クレームの値によりユーザーを識別できますが、Microsoft Entra IDではsubクレームでユーザーを一意に識別するのは困難です。

ORDSのJWTプロファイルによる認証および認可の仕組みでは、Microsoft Entra IDのアクセス・トークンのupnクレームの値をユーザーの識別子として認識します。ORDS MCPサーバーについてはMicrosoft Entra IDでの接続ができなかったため、upnクレームをユーザーの識別子として認識するかどうか不明ですが、アクセス・トークン(およびIDトークン)にupnクレームを追加しておきます。

トークン構成を開き、オプションの要求の追加をクリックします。


トークンの種類にアクセスを選択し、要求に含まれるupnをチェックします。これはOAuth2のアクセス・トークンに、クレームとしてupnを追加するという作業です。

以上で追加をクリックします。


Microsoft Graph profileのアクセス許可を有効にしますをチェックして、追加します。


アクセス・トークンに要求としてupnが追加されました。

要求upnに設定される値を調整します。要求upnの3点メニューをクリックし、編集を実行します。


UPNの編集画面で、外部認証済みをはい、ハッシュ記号の置換をはいに設定します。

以上で保存します。


必ずしも必要ではないようですが、IDトークンについても同様の操作を行い、クレームとしてupnを追加します。

オプションの要求としてupnが、IDトークンとアクセス・トークンに追加されました。


次にクライアントに対応したアプリケーションを作成します。

規定のディレクトリの管理のアプリの登録を開き、新規登録を実行します。


作成するアプリケーションの名前はORDS MCP2 Clientとします。リダイレクトURIは複数のURIを設定するため、ここでの設定は省略します。

以上で登録します。


アプリケーションORDS MCP2 Clientが作成されます。

後ほどAPIのアプリケーションORDS MCP2への紐付けに使うため、アプリケーション(クライアント)IDをコピーしておきます。その後に、リダイレクトURIを追加するのリンクを開きます。


リダイレクトURIを構成します。

今回はMCPクライアントとしてMCP Inspectorを使用します。

リダイレクトURIの追加をクリックし、MCP InspectorのリダイレクトURIを追加します。


MCP Inspectorでは、プラットフォームにシングルページアプリケーションを選択します。


以下のURIをリダイレクトURIとして設定し、構成を実行します。

http://localhost:6274/oauth/callback
http://localhost:6274/oauth/callback/debug

2つのURIを構成するため、2回同じ操作を実施します。


MCP InspectorのリダイレクトURIが設定できました。

設定を開き、パブリッククライアントフローを許可します。


パブリッククライアントフローを許可するを有効にし、変更を保存します。


アプリの登録に戻り、アプリケーションORDS MCP2を開きます。


APIの公開を開き、クライアントアプリケーションの追加を実行します。


クライアントIDに、クライアントに対応するアプリケーションORDS MCP2 Clientのアプリケーション(クライアント)IDを設定します。

承認済みのスコープをチェックし、アプリケーションの追加を実行します。


承認済みのクライアント・アプリケーションとしてORDS MCP2 Clientが追加されます。


以上でEntra IDの設定は完了です。

ORDS MCPサーバーを構成するグローバル・プロパティの値を確認します。

アプリケーションORDS MCP2の概要を開き、エンドポイントを開きます。


エンドポイントのOpenID Connectメタデータドキュメントに注目します。


OpenID Connectメタデータドキュメントを返すURLの末尾の/.well-known/openid-configurationを除いた部分が、グローバル・プロパティmcp.security.jwt.profile.authorization.server.urlの値になります。

mcp.security.jwt.profile.authorization.server.url = https://login.microsoftonline.com/[テナントID]/v2.0

OpenID Connectメタデータドキュメントをブラウザで開きます。


属性issuerの値が、グローバル・プロパティmcp.security.jwt.profile.issuerの値になります。

mcp.security.jwt.profile.issuer = https://login.microsoftonline.com/[テナントID]/v2.0

属性jwks_uriの値が、グローバル・プロパティmcp.security.jwt.profile.jwk.urlの値になります。

mcp.security.jwt.profile.jwk.url = https://login.microsoftonline.com/[テナントID]/discovery/v2.0/key

グローバル・プロパティmcp.security.jwt.profile.audienceの値はhttp://localhost:8585/mcpです。

mcp.security.jwt.profile.audience = http://localhost:8585/mcp

グローバル・プロパティmcp.security.jwt.profile.role.claim.nameの値は/rolesです。

mcp.security.jwt.profile.role.claim.name = /roles

以上で、ORDS MCPサーバーを構成するグローバル・プロパティの値についても収集できました。



ORDS MCPサーバーの構成




ORDSの構成に移ります。

コンテナに接続して、ORDSの構成コマンドを実行します。

docker exec -it ords-mcp bash

ords-mcp2 % docker exec -it ords-mcp bash

[oracle@a7bdb9847eb3 ~]$ 


ORDSのグローバル・プロパティを設定します。xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxの部分は、テナントIDに置き換えます。
ords --config /etc/ords/config config set --global feature.mcp true
ords --config /etc/ords/config config set --global mcp.security.jwt.profile.issuer https://login.microsoftonline.com/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxx/v2.0
ords --config /etc/ords/config config set --global mcp.security.jwt.profile.audience http://localhost:8585/mcp
ords --config /etc/ords/config config set --global mcp.security.jwt.profile.jwk.url https://login.microsoftonline.com/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxx/discovery/v2.0/keys
ords --config /etc/ords/config config set --global mcp.security.jwt.profile.authorization.server.url https://login.microsoftonline.com/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxx/v2.0
ords --config /etc/ords/config config set --global mcp.security.jwt.profile.role.claim.name /roles
続いて、スキーマHRに接続するコネクション・プールとしてmcp-hrを構成します。ORDS MCPサーバーはコンテナ内で実行されているため、コンテナ外にあるデータベースの接続先としてhost.docker.internalを設定しています。

ロールによるアクセス制御を行うため、mcp.roleにORDS_MCP_HRを設定しています。
ords --config /etc/ords/config config --db-pool mcp-hr set db.connectionType basic
ords --config /etc/ords/config config --db-pool mcp-hr set db.hostname host.docker.internal
ords --config /etc/ords/config config --db-pool mcp-hr set db.port 1521
ords --config /etc/ords/config config --db-pool mcp-hr set db.servicename freepdb1
ords --config /etc/ords/config config --db-pool mcp-hr set db.username HR
ords --config /etc/ords/config config --db-pool mcp-hr set db.description "Sample Schema Human Resources"
ords --config /etc/ords/config config --db-pool mcp-hr set mcp.role ORDS_MCP_HR
コネクション・プールmcp-hrがデータベースに接続する際に使用するパスワードを設定します。スキーマHRに設定したパスワードです。

ords --config /etc/ords/config config --db-pool mcp-hr secret db.password

[oracle@aeba9d22c0f9 ~]$ ords --config /etc/ords/config config --db-pool mcp-hr secret db.password


ORDS: Release 26.2 Production on Wed Jul 08 06:44:35 2026


Copyright (c) 2010, 2026, Oracle.


Configuration:

  /etc/ords/config


Enter the database password: ********

Confirm password: ********

[oracle@aeba9d22c0f9 ~]$ 


コンテナから抜けて再起動します。

exit
docker restart ords-mcp


[oracle@a7bdb9847eb3 ~]$ exit

exit

ords-mcp2 % docker restart ords-mcp

ords-mcp

ords-mcp2 % 




MCP Inspectorによる接続確認



MCP Inspectorを起動し、MCPサーバーに接続します。

npx @modelcontextprotocol/inspector

ORDS MCPサーバーに接続するにあたって、以下を設定します。

Transport Type: Streamable HTTP
URL; http://localhost:8585/mcp
Connection Type: Direct
OAuth2 2.0 Flow Client ID: アプリケーションORDS MCP2 Clientのアプリケーション(クライアント)ID
Scope: http://localhost:8585/mcp/urn:oracle:dbtools:ords:mcpserver:all

OAuth2 2.0 Flow Client IDに設定する値は、アプリケーションORDS MCP2 Clientの概要にあるアプリケーション(クライアント)IDから取得します。


ここでConnectをクリックしても、Entra IDに発行してもらったアクセス・トークンではhttp://localhost:8585/mcpのPOSTリクエストが401 Unauthorizedを返すため、認証しては失敗を繰り返します。

アクセス・トークンの取得までの動作を確認するため、Open Auth Settingsをクリックします。


Quick OAuth Flowを実行します。


Entra IDへのサインインを求められます。


OAuth Flow ProgressがAuthentication Completeまで進みます。

Authentication Completeの下にAccess Tokenのノードがあります。開くと、Entra IDが発行したアクセス・トークンを参照できます。


発行されたアクセス・トークンをjwt.ioなどのJWTデバッガで確認すると、audクレームはアプリケーションORDS MCP2のアプリケーション(クライアント)IDであること、グローバル・スコープ urn:oracle:dbtools:ords:mcpserver:all がscpクレームで渡されていること、upnクレームが含まれていること、rolesクレームにロールORDS_MCP_HRが含まれていることが確認できます。


今回の記事は以上になります。

完