日日是Oracle APEX

2026年4月17日金曜日

OpenAI CodexからリモートMCPサーバー経由でOracle Databaseに問い合わせる

以下の手順で作成したリモートMCPサーバーsampleserverにOpenAI Codexから接続し、プラグインを作成してみます。Microsoft Entra IDによるユーザー認証を行なうように構成します。

最初にCodexにMCPサーバーを作成します。~/.codex/config.tomlを直接編集します。アプリから設定する場合は、設定のMCPサーバーから作成します。

config.tomlに以下の記述を追加します。MCPサーバーはconnector_for_oracle_datababaseと命名します。

[mcp_servers.connector_for_oracle_database]
url = "https://OpenRestyが動作しているホスト名/ords/apexdev/sampleserver/mcp"
bearer_token_env_var = "ORACLE_MCP_TOKEN"

CodexではMCPサーバーを以下のように設定すると、OAuthによるユーザー認証ができるようです。（mcp_oauth_callback_urlをEntra IDのアプリにリダイレクトURIとして設定する必要あり）

[mcp_servers.connector_for_oracle_database]
url = "https://OpenRestyが動作しているホスト名/ords/apexdev/sampleserver/mcp"

# --- OAuth callback ---
mcp_oauth_callback_port = 8787
mcp_oauth_callback_url = "http://localhost:8787/callback"

MCPサーバーconnector_for_oracle_databaseをユーザー認証するため、codexコマンドを実行します。

codex mcp login connector_for_oracle_database

~ % codex mcp login connector_for_oracle_database

Error: Registration failed: Dynamic registration failed: Registration failed: Dynamic client registration not supported

~ %

config.toml内でOAuthのクライアントIDを設定する方法がドキュメントから見つからないため、エラー・メッセージにあるようにDynamic Client Registrationが必須と思われます。Microsoft Entra IDはDCRに対応していないため、CodexとEntra IDの組み合わせでOAuth2によるユーザー認証はできないようです。

諦めてbearer_token_env_varを使うように設定します。環境変数ORACLE_MCP_TOKENにEntra IDが発行したアクセス・トークンを設定します。

az loginコマンドを実行し、Entra IDにサインインします。

az login --tenant "テナントID" --scope "アプリORDS MCPで公開しているスコープ"

ブラウザが立ち上がり、Entra IDに登録されているユーザーによるユーザー認証が求められます。

ブラウザでのユーザー認証が完了すると、Select a subscription and tenant (Type a number or Enter for no changes):と聞かれます。そのままEnterを入力し、az loginコマンドを完了します。

~ % az login --tenant "********-****-****-****-************" --scope "api://********-****-****-****-************/mcp:connect"

A web browser has been opened at https://login.microsoftonline.com/********-****-****-****-************/oauth2/v2.0/authorize. Please continue the login in the web browser. If no web browser is available or if the web browser fails to open, use device code flow with `az login --use-device-code`.

Retrieving subscriptions for the selection...

[Tenant and subscription selection]

No Subscription name Subscription ID Tenant

----- -------------------- ------------------------------------ ------------------------------------

[1] * Azure subscription 1 ********-****-****-****-************ ********-****-****-****-************

The default is marked with an *; the default tenant is '********-****-****-****-************' and subscription is 'Azure subscription 1' (********-****-****-****-************).

Select a subscription and tenant (Type a number or Enter for no changes):

Tenant: ********-****-****-****-************

Subscription: Azure subscription 1 (********-****-****-****-************)

[Announcements]

With the new Azure CLI login experience, you can select the subscription you want to use more easily. Learn more about it and its configuration at https://go.microsoft.com/fwlink/?linkid=2271236

If you encounter any problem, please open an issue at https://aka.ms/azclibug

[Warning] The login output has been updated. Please be aware that it no longer displays the full list of available subscriptions by default.

ynakakoshi@Ns-Macbook ~ %

Entra IDへのサインインが完了したので、アクセス・トークンを取得し環境変数ORACLE_MCP_TOKENに設定します。

export ORACLE_MCP_TOKEN=$(az account get-access-token \
--scope "アプリORDS MCPで公開しているスコープ" \
--query accessToken -o tsv)

~ % export ORACLE_MCP_TOKEN=$(az account get-access-token \

--scope "api://*********-****-****-****-********/mcp:connect" \

--query accessToken -o tsv)

~ % echo $ORACLE_MCP_TOKEN

eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6IlUxc1g4W

[中略]

7jbOqbhJSQ1Dk-CoHPF_yJPJGO2OPJEUjhIBehPC-abRHHVPXeiRC

ZuDTRAvZzVrSAW97jSQ0PFmMQ

~ %

以上でアクセス・トークンが環境変数ORACLE_MCP_TOKENに設定されました。アクセス・トークンの有効期間は通常１時間程度なので、az account get-access-tokenコマンドは定期的に発行する必要があります。

コマンドラインから（デスクトップ・アプリの）Codexを起動します。以下はmacOSでの作業です。

open -a Codex

Codexが起動します。

作成されたMCPサーバーを確認します。

サイド・メニューよりプラグインを選択し、管理するを開きます。

MCPを選択するとConnector For Oracle Databaseが作成されていることが確認できます。

新しいプロジェクトを追加して、作業を進めます。

販売分析というプロジェクトを作成し、作業を進めます。

Connector for Oracle Databaseに繋げられるかを確認します。

　「Connector for Oracle Databaseに接続して、接続ユーザーを確認して。」

ツールget_current_userが呼び出され、アクセス・トークンのsubの値が表示されます。MCPサーバーに接続できていることが確認できます。

Connector For Oracle Databaseを使用したプラグインを作成します。

サイド・メニューよりプラグインを開き、作成からプラグインを作成を実行します。

Plugin Createrにたいして、以下の文言を与えて実行します。

「SHスキーマに保存されている販売履歴より、典型的な分析ができるプラグインを作成してください。」

CodexがMCPサーバーのツールを呼び出し、プラグインを作成していきます。

たまにツール実行の許可やファイル操作の許可を求められます。

プラグインの作成が完了したら、プラグインをインストールします。

「作成されたプラグインをインストールして」

サイド・メニューよりプラグインを開きます。

Local Analytics Plugins（またはLocal Plugins）を選択し、プラグインSH Sales Analyticsをインストールします。

プラグインSH Sales Analystをインストールします。

プラグインがインストールされます。

プロジェクトのチャット画面に移り、インストールされたプラグインを呼び出します。

プラグインを使って、分析してもらいます。

「SHスキーマの月次売上推移と成長率を分析して」

色々とツールを呼び出して、最終的な回答まで進みます。

Microsoft Entra IDとの連携は残念な感じですが、プラグインやスキル次第で、Codexをコーディング以外の作業で使用することもできそうです。

完

MCP AppsのサンプルアプリCohort Heatmap Serverをデータベースで実行する

GitHubのリポジトリmodelcontextprotocol/ext-appsに含まれているCohort Heatmap Serverをデータベースでホストしてみます。作業はBudget Allocator Serverと同じですが、TypeScriptで記述されたserver.tsのPL/SQLへの変換は、すべてClaude Opus 4.7に実施してもらいました。

Claude DesktopのChatから呼び出しています。

Claude Codeでのセッション履歴はこちらから参照できます。このセッションでのコンテキストウィンドウの使用量は87.2kでした。生成されたファイルは、リポジトリmcp-appのexamples/cohort-heatmap-server以下に保存されています。今回もオリジナルのTypeScriptの実装を忠実に反映しているかどうかは確認していません。MCPアプリが動作すれば、それで良しとしています。

Claudeはデータベース・サーバーへの実装まで行なう勢いでしたが、それは遠慮して自分で作業することにしました。

これからはBudget Allocator Serverの実装と同じ作業を行います。

サーバーをインストールします。スクリプトはchs_install.sqlとして作成されています。

sql -cloudconfig Wallet_SALESADB.zip wksp_apexdev@salesadb_low
@mcp-app/examples/cohort-heatmap-server/chs_install.sql

mcp-salesadb % sql -cloudconfig Wallet_SALESADB.zip wksp_apexdev@salesadb_low

SQLcl: 金 4月 17 12:58:41 2026のリリース25.4 Production

パスワード (**********?) ****************

接続先:

Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production

Version 19.31.0.1.0

SQL> @mcp-app/examples/cohort-heatmap-server/chs_install.sql

Table CHS_METRIC_PARAMSは作成されました。

Table CHS_DATASET_METAは作成されました。

Table CHS_PERIODSは作成されました。

Table CHS_COHORTSは作成されました。

Table CHS_COHORT_CELLSは作成されました。

Commentは作成されました。

Procedure CHS_GENERATE_COHORT_DATAがコンパイルされました

Function CHS_GET_COHORT_DATA_RESPONSEがコンパイルされました

1行挿入しました。

コミットが完了しました。

PL/SQLプロシージャが正常に完了しました。

コミットが完了しました。

PL/SQLプロシージャが正常に完了しました。

Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production

Version 19.31.0.1.0から切断されました

mcp-salesadb %

リソースは以下の値で作成しています。

Uri: ui://get-cohort-data/mcp-app.html

Name: Cohort Heatmap

Description: cohort retention heatmap data showing customer retention over time by signup month

作成したリソースCohort Heatmapに登録するUIバンドルは、リポジトリext-appsに含まれるext-apps/examples/cohort-heatmap-server/dist/mcp-app.htmlです。

ツールとしてget-cohort-dataを作成します。

Code: get-cohort-data

Description: Returns cohort retention heatmap data showing customer retention over time by signup month

Input Schema: input_schema.json

Function Call: return chs_get_cohort_data_response(:parameters);

Tags: ext-apps

Resource Id: Cohort Heatmap

Output Schema: output_schema.json

以上で、データベースにMCPアプリCohort Heatmapを登録できました。

Budget Allocatorのときに作成したカスタムコネクタを一旦削除し、Sample MCP Appsとして再登録したのち、get-cohort-dataを呼び出した結果が、記事の先頭にあるGIF動画になります。

完

2026年4月16日木曜日

MCP AppsのサンプルアプリBudget Allocator Serverをデータベースで実行する

GitHubのリポジトリmodelcontextprotocol/ext-appsに含まれているBudget Allocator Serverをデータベースでホストしてみます。今回はClaude Desktopから呼び出せるように、Autonomous AI Databaseを使用します。Autonomous AI Databaseでの準備作業は、以下の記事で紹介しています。

MCPを話すOracle Databaseを作成する - Autonomous AI Database編

Claude Desktopでは以下のように動作します。

Budget Allocator Serverのサーバーはserver.tsで実装されています。以下の方針で、データベースに実装し直しています。データベースで実行するスクリプトはClaude Sonnetに生成してもらいました。

Zodによるスキーマ定義を切り出し、Oracle Database向けの表定義を生成させました。（スクリプト：bas_create_tables.sql）
サンプルデータを生成するファンクションseededRandomとgenerateHistoryを取り出し、PL/SQLで書き直してもらいました。（スクリプト：bas_generate_history.sql）
表bas_budget_categories、bas_budget_analyticsへの初期データの投入を行なうINSERT文を生成させました。（スクリプト：bas_prepare_budget_categories.sql、bas_prepare_budget_analytics.sql）
表bas_budget_config、bas_budget_preset_budgetsへの初期データの投入については、自分でINSERT文を書きました。（スクリプト：bas_prepare_budget_config.sql）
ツールが返す構造化出力を生成するファンクションbas_get_budget_data_responseを生成させました。（スクリプト：bas_get_budget_data_response.sql）

本記事の目的はMCPアプリをデータベースでホストすることなので、PL/SQLで実装されたサーバーがTypeScriptの機能と完全に互換かどうかという点は確認していません。MCPアプリが動作すれば良しとしています。

CREATE TABLE文を生成する部分、INSERT文を生成するデータ準備部分、それとツール本体となるプロシージャを生成する部分に、作業を分けてコード生成させましたが、server.tsを丸投げしても良かったかもしれません。

これらを一括で実行するスクリプトbas_install.sqlを作成しています。リポジトリmcp-appにmcp-app/examples/budget-allocator-server/bas_install.sqlとして含まれているので、リモートMCPサーバーを実装しているスキーマに接続して実行します。

Autonomous AI Database向けの構築手順にそって作成した環境であれば、Autonomous AI Lakehouseの19cのデータベースがSALESADBとして作成され、APEXワークスペースのスキーマとしてWKSP_APEXDEVが作成されています。この環境を前提とすると、以下のコマンドでBuget Allocator Serverのサーバーを実装できます。

sql -cloudconfig Wallet_SALESADB.zip wksp_apexdev@salesadb_low
@mcp-app/examples/budget-allocator-server/bas_install.sql

データベースにサーバーが実装されたことを確認するために、スクリプト実行の最後にツール呼び出しのレスポンスを出力しています。

mcp-salesadb % sql -cloudconfig Wallet_SALESADB.zip wksp_apexdev@salesadb_low

SQLcl: 木 4月 16 12:39:12 2026のリリース25.4 Production

パスワード (**********?) ****************

接続先:

Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production

Version 19.31.0.1.0

SQL> @mcp-app/examples/budget-allocator-server/bas_install.sql

Table BAS_BUDGET_CATEGORIESは作成されました。

Table BAS_BUDGET_CONFIGは作成されました。

Table BAS_BUDGET_CONFIG_PRESET_BUDGETSは作成されました。

Table BAS_HISTORICAL_MONTHSは作成されました。

Table BAS_HISTORICAL_MONTH_ALLOCATIONSは作成されました。

Table BAS_BUDGET_ANALYTICSは作成されました。

Table BAS_BUDGET_ANALYTICS_STAGESは作成されました。

Table BAS_STAGE_BENCHMARKSは作成されました。

Table BAS_STAGE_BENCHMARK_PERCENTILESは作成されました。

Commentは作成されました。

Procedure BAS_GENERATE_HISTORYがコンパイルされました

Function BAS_GET_BUDGET_DATA_RESPONSEがコンパイルされました

1行挿入しました。

コミットが完了しました。

PL/SQLプロシージャが正常に完了しました。

コミットが完了しました。

PL/SQLプロシージャが正常に完了しました。

Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production

Version 19.31.0.1.0から切断されました

mcp-salesadb %

サーバーの実装を削除するスクリプトbas_drop_all.sqlも用意しています。

以上でサーバー側の実装はできました。

APEXアプリケーションをインストールして、Budget AllocatorをMCPアプリとして登録します。

Autonomous AI DatabaseのAPEXに接続し、アプリケーション・ビルダーからインポートを実行します。

リポジトリmcp-appに含まれるMCP App Helperアプリmcp-app/app/mcp-app-helper.sqlをインポートします。

次へ進みます。

アプリケーションのインストールを実行します。

アプリケーションがインストールされます。

アプリケーションの編集を開き、アプリケーションの名前と別名を更新します。

アプリケーションの名前をext-apps、別名をext-appsとします。

アプリケーションを実行します。

最初にHandlersを開き、リモートMCPサーバーのエンドポイントとなるORDS RESTサービスをインストールします。

作成をクリックします。

ORDSのRESTモジュール名はAPEXアプリの別名と同じにします。これはリモートMCPサーバーの実装上、必須になっています。

リモートMCPサーバーのエンドポイントURLは以下になります。

https://リバースプロキシのホスト/ords/ORDS別名/ext-apps/mcp

デフォルトの設定のまま、作成をクリックします。

ORDSのRESTモジュールとしてext-apps、テンプレートとしてmcp、そのテンプレートにPOSTハンドラとDELETEハンドラが作成されます。

Resourcesを開き、UIリソースとしてBudget Allocatorを作成します。

作成をクリックします。

以下の値でUIリソースBudget Allocatorを作成します。

Uri: ui://budget-allocator/mcp-app.html

Name: Budget Allocator

Description: Interactive Budget Allocator UI

作成したUIリソースBudget Allocatorに実際のアプリを登録します。Bundleを開きます。

Resource IDにBudget Allocatorを選択し、bundle html fileにリポジトリext-appsに含まれるext-apps/examples/budget-allocator-server/dist/mcp-app.htmlを選択します。

Updateをクリックし、MCPアプリをデータベースにアップロードします。

Toolsを開き、ツールとしてget-budget-dataを作成します。

Code: get-budget-data
Description: Returns budget configuration with 24 months of historical allocations and industry benchmarks by company stage

Input Schema: {"$schema":"http://json-schema.org/draft-07/schema#","type":"object"}
Function Call: return bas_get_budget_data_response();
Tags: ext-apps

Resource Id: Budget Allocator

Output Schemaには、こちらの内容output_schema.jsonを記述します。

以上で作成をクリックします。