Oracle EPM Cloud MCP Server
Oracle EPM Cloud MCP サーバー
Claude AI (または MCP 互換クライアント) を REST API 経由で Oracle EPM Cloud に接続します。
Oracle ACE および EPM ソリューションアーキテクトの Fred Mamadjanov によって構築されました。詳細は fmepm.com をご覧ください。
もしこのツールが時間の節約になったなら、ぜひ リポジトリにスターを付けてください。スターは他の Oracle EPM ユーザーがこのプロジェクトを見つけるための指標となり、私にとってこれが有用であるという最も明確なシグナルになります。
このツールの機能
この MCP サーバーを使用すると、AI エージェントが Oracle EPM Cloud と対話できるようになります。Postman の呼び出しや EPM Automate コマンドを手動で実行する代わりに、Claude に次のように依頼できます:
「EPM 環境にはどのようなアプリケーションがありますか?」
「現在の置換変数を表示して」
「ビジネスルール Agg_AllData を実行して」
「北米の第1四半期の収益データをエクスポートして」
「現在の月を3月から4月に進めて」
サーバーはこれらの自然言語によるリクエストを Oracle EPM REST API 呼び出しに変換します。
Related MCP server: bas-mcp-server
📺 ビデオチュートリアルと詳細記事
エピソード 2: 構築の経緯 MCP と REST API を使用して Oracle EPM Cloud 用の AI エージェントを構築する方法。
YouTube で視聴: youtu.be/At4_ZIq2jBY
fmepm.com の詳細記事: Claude AI を Oracle EPM Cloud に接続する方法
エピソード 3: セットアップ方法 (ステップバイステップ) この MCP サーバーを 5 分でインストールおよび設定する方法。
YouTube で視聴: youtu.be/kgUDAKARk7c
fmepm.com の完全なセットアップガイド: Oracle EPM Cloud 用 AI エージェントのセットアップ方法
アーキテクチャ
You (natural language) → Claude Desktop → MCP Protocol → This Server → Oracle EPM REST APIs → Your EPM Cloud利用可能なツール
ツール | 機能 | EPM REST API |
| 接続テスト、API バージョンの検出 |
|
| すべての EPM アプリケーションを一覧表示 |
|
| 現在の月、年、シナリオ変数の読み取り |
|
| 計算スクリプトまたはビジネスルールの実行 |
|
| ジョブの完了またはエラーの確認 |
|
| ディメンションメンバーによるキューブからのデータ抽出 |
|
| 置換変数の値の変更 |
|
インストール
2 つのオプションがあります。作業スタイルに合わせて選択してください。
オプション A: ワンクリックインストール (推奨)
v2.0.0 以降で利用可能です。デスクトップ拡張機能をダウンロードしてインストールするだけで完了です。パスの編集や JSON 設定ファイルは不要です。
最新リリース から
oracle-epm-cloud-2.0.0.mcpbをダウンロードします。Claude Desktop を開き、[設定] → [拡張機能] → [詳細設定] → [拡張機能をインストール] に移動します。
.mcpbファイルを選択します。以上です。モックモードはすぐに動作します。テストに Oracle の資格情報は必要ありません。
ライブモード (実際の EPM 環境) を使用する場合は、Claude Desktop の拡張機能設定から環境変数を設定してください。
オプション B: 手動インストール (開発者向け)
コードを読み取ったり変更したりしたい場合はこちらを使用してください。
前提条件
ビデオガイドが必要ですか? YouTube のエピソード 3 を視聴するか、fmepm.com のステップバイステップガイド をお読みください。
ステップ 1: クローンとインストール
git clone https://github.com/fmepm/oracle-epm-mcp-server.git
cd oracle-epm-mcp-server
npm installステップ 2: Claude Desktop の設定
Claude Desktop → [設定] → [開発者] → [設定を編集] を開きます。
claude_desktop_config.json に以下を追加します:
{
"mcpServers": {
"oracle-epm-cloud": {
"command": "node",
"args": ["/FULL/PATH/TO/oracle-epm-mcp-server/server/index.js"]
}
}
}/FULL/PATH/TO/ をマシン上の実際のパスに置き換えてください。
Windows の例:
{
"mcpServers": {
"oracle-epm-cloud": {
"command": "node",
"args": ["C:\\Users\\Fred\\oracle-epm-mcp-server\\server\\index.js"]
}
}
}Mac の例:
{
"mcpServers": {
"oracle-epm-cloud": {
"command": "node",
"args": ["/Users/fred/oracle-epm-mcp-server/server/index.js"]
}
}
}ステップ 3: Claude Desktop の再起動
Claude Desktop を完全に終了して再起動します。チャット入力エリアに MCP ツールのアイコン (ハンマー) が表示されるはずです。クリックして "oracle-epm-cloud" がリストされていることを確認してください。
ステップ 4: 試してみる
Claude Desktop に次のように入力します:
「私の環境で利用可能な EPM アプリケーションは何ですか?」
Claude が list_applications ツールを使用してモックデータを返します。
ライブモードへの切り替え (実際の EPM 環境)
Oracle EPM Cloud 環境にアクセスできるようになったら、Claude Desktop の設定で以下の環境変数を設定します:
{
"mcpServers": {
"oracle-epm-cloud": {
"command": "node",
"args": ["/FULL/PATH/TO/oracle-epm-mcp-server/server/index.js"],
"env": {
"EPM_MODE": "live",
"EPM_BASE_URL": "https://epm-YOURDOMAIN.epm.REGION.oraclecloud.com",
"EPM_USERNAME": "IDENTITYDOMAIN.your_username",
"EPM_PASSWORD": "your_password",
"EPM_APP_NAME": "Vision"
}
}
}
}同じ 7 つのツールが、実際の環境に対して動作するようになります。
認証に関する注意
REST API は基本認証 (Basic Authentication) を使用します。ユーザー名の形式は identitydomain.username である必要があります。これは最もよくある間違いです。401 エラーが発生した場合は、まずこれを確認してください。
多要素認証 (MFA) が有効なアカウントでは基本認証を使用できません。その場合は OAuth 2.0 が必要ですが、このバージョンではサポートされていません。
月次決算自動化の例
AI エージェントが月次決算を自動化するために実行するシーケンスの例です:
現在の期間を確認:
get_substitution_variablesで CurrMonth = "Mar" を確認集計を実行: "Agg_AllData" を指定して
run_business_ruleを実行完了を待機: 返されたジョブ ID を使用して
check_job_statusを実行データを検証: 収益、売上原価、純利益について
export_data_sliceを実行期間を更新:
update_substitution_variableで CurrMonth を "Mar" から "Apr" に変更確認:
get_substitution_variablesで CurrMonth = "Apr" であることを確認
これは財務チームが毎月手動で行っているワークフローと同じです。これが自然言語を通じて実行可能になります。
トラブルシューティング
エラー | 原因 | 修正方法 |
Claude に MCP ツールが表示されない | 設定パスが誤っている |
|
401 Unauthorized | ユーザー名の形式 | ユーザー名だけでなく |
403 Forbidden | 権限不足 | ユーザーに EPM 管理者または適切なロールが必要 |
Connection refused | URL が誤っている |
|
ETIMEDOUT | ネットワーク/ファイアウォール | マシンから EPM URL に到達できるか確認 |
今後の予定
OAuth 2.0 サポート: MFA が有効な環境向け
FCCS 専用ツール: 連結、内部取引消去
データ統合ツール: Migration API を介したファイルのアップロードとダウンロード
Groovy ルール実行: REST API を介した Groovy スクリプトの実行
について
このサーバーは、AI エージェントを Oracle EPM Cloud に接続する一連のシリーズの一部です。Oracle EPM に関するその他のコンテンツ、チュートリアル、ツールについては以下を参照してください:
セットアップチュートリアル: Oracle EPM Cloud 用 AI エージェントのセットアップ方法 (ステップバイステップ)
すべてのインサイトと記事: fmepm.com/insights
YouTube チャンネル: @fmepm
ウェブサイト: fmepm.com
LinkedIn: Fred Mamadjanov
Oracle EPM を使用しており、AI 統合について議論したいですか? ディスカバリーコールを予約 してください。
これは Oracle の製品ではありません。Oracle EPM Cloud は Oracle Corporation の商標です。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Claude, connected to your own Oracle EPM. Each person as themselves, every call checked and logged.
Give AI agents 30,000+ safe, token-optimized actions across Workday, SAP, Oracle + hundreds more.
Personal finance, bank account, and shared memory connector for Claude, ChatGPT, Gemini Spark & more
Automate 1,000+ services from any MCP-compatible AI agent: build Applets, run actions and queries.
Related MCP Servers
- AlicenseCqualityFmaintenanceEnables interaction with Oracle EPM Cloud Financial Consolidation and Close (FCCS) through 25+ tools covering REST API operations including jobs, dimensions, journals, data management, reports, and consolidation tasks.36MIT
- AlicenseAqualityDmaintenanceEnables AI agents to interact with 1С:Enterprise and BAS ERP systems through REST and HTTP services, providing tools for searching catalogs, creating documents, and querying stock balances.6ISC
- AlicenseAqualityCmaintenanceEnables AI agents to explore Oracle Fusion Cloud schema metadata, run pre-built BI Publisher reports with bind parameters, and validate results against trusted ground truth.401Apache 2.0
- AlicenseAqualityCmaintenanceEnables AI assistants to explore and report on Oracle-based ERP databases via read-only schema discovery, guarded ad-hoc SQL, and curated reports.5MIT