Oracle EPM Cloud MCP Server

FMEPM Connect Core

Claude AI（または MCP 対応クライアント）を REST API 経由で Oracle EPM Cloud に接続します。

ホステッド版は FMEPM Connect をご利用ください。

Oracle ACE Pro であり EPM ソリューションアーキテクトの Fred Mamadjanov が開発しました。詳しくは fmepm.com をご覧ください。

このツールで時間を節約できた場合は、ぜひリポジトリにスターを付けてください。スターを付けることで、ほかの Oracle EPM 関係者にこの取り組みを見つけてもらえます。また、役に立っていることを示す最も明確なサインになります。

---

実際のシステムに接続する前に

このデモは、想定されるワークフローを示すものです。AI ツール、LLM、または MCP サーバーを NSPB やその他のエンタープライズシステムに接続する前に、組織は IT、セキュリティ、コンプライアンスの各チームから承認を得て、社内のデータガバナンスおよびセキュリティポリシーを遵守してください。

モックモードでは、認証情報なしでサンプルデータを使ってすべてを試せます。ぜひご利用ください。

---

このツールでできること

この MCP サーバーを使うと、AI エージェントが Oracle EPM Cloud を操作できるようになります。Postman の呼び出しや EPM Automate のコマンドを手動で実行する代わりに、Claude に次のように依頼できます。

• 「EPM 環境にはどのアプリケーションがありますか？」
• 「現在の代替変数を表示してください」
• 「Agg_AllData ビジネスルールを実行してください」
• 「北米の第 1 四半期の収益データをエクスポートしてください」
• 「現在の月を 3 月から 4 月に進めてください」

このサーバーは、こうした自然言語の依頼を Oracle EPM REST API の呼び出しに変換します。

---

📺 動画チュートリアルと詳細記事

エピソード 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
get_api_version	接続をテストし、API バージョンを確認します	GET /HyperionPlanning/rest/
list_applications	すべての EPM アプリケーションを一覧表示します	GET /HyperionPlanning/rest/v3/applications
get_substitution_variables	現在の月、年、シナリオの変数を読み取ります	GET .../substitutionvariables
run_business_rule	計算スクリプトまたはビジネスルールを実行します	POST .../jobs
check_job_status	ジョブが完了したか、エラーになったかを確認します	GET .../jobs/{jobId}
export_data_slice	次元メンバーを指定してキューブからデータを取得します	POST .../exportdataslice
update_substitution_variable	代替変数の値を変更します	PUT .../substitutionvariables

---

インストール

方法は 2 つあります。作業スタイルに合った方法を選んでください。

オプション A：ワンクリックインストール（推奨）

v2.0.0 以降で利用できます。Desktop Extension をダウンロードしてインストールするだけです。パスの編集も JSON 設定ファイルも不要です。

現在リリースされているバンドルには、まだ以前の製品名が表示されています。このソースの変更によって、新しいバンドルが公開されることはありません。

1. 最新リリースから oracle-epm-cloud-2.0.0.mcpb をダウンロードします。
2. Claude Desktop を開きます。「設定」→「拡張機能」→「詳細設定」→「拡張機能をインストール」に進みます。
3. .mcpb ファイルを選択します。
4. これで完了です。モックモードはそのまま動作します。テストに Oracle の認証情報は必要ありません。

ライブモード（実際の EPM 環境）を使う場合は、Claude Desktop の拡張機能設定から環境変数を設定してください。

オプション B：手動インストール（開発者向け）

コードを読んだり、変更したりする場合はこちらを使用してください。

前提条件

• Node.js 24 LTS（推奨）、または Node.js 22 LTS がインストールされていること（ダウンロード）
• Claude Desktop がインストールされていること（ダウンロード）

ソースパッケージと拡張機能マニフェストには、Node.js 22 以降が必要です。CI では Node.js 22 と 24 をテストしています。Node.js 18 と 20 はサポートが終了しており、サポート対象外です。npm ci を実行する前に、node --version でインストール済みのバージョンを確認してください。

動画での手順説明が必要ですか？ YouTube のエピソード 3を視聴するか、fmepm.com の手順ガイドをお読みください。

ステップ 1：クローンしてインストール

git clone https://github.com/fmepm/oracle-epm-mcp-server.git
cd oracle-epm-mcp-server/server
npm ci

ステップ 2：Claude Desktop を設定する

Claude Desktop を開き、［Settings］→［Developer］→［Edit Config］の順に選択します。

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 環境）

会社の環境でこれを行う前に、このページの冒頭にある注意事項をお読みください。まず、IT、セキュリティ、コンプライアンスの各チームから承認を得てください。

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": "your_username",
        "EPM_PASSWORD": "your_password",
        "EPM_APP_NAME": "Vision"
      }
    }
  }
}

同じ 7 つのツールで、実際の環境に接続できるようになります。

認証に関する注意

REST API は Basic Authentication を使用します。クラウドアカウント名の接頭辞を付けずにユーザー名を入力してください。本番環境では、Oracle は 2026 年 11 月 20 日（26.11）に、接頭辞付きの形式を受け付けなくなります。認識済みのポッドアドレスで接頭辞がアカウント名と一致する場合は警告しますが、書き換えは行いません。

多要素認証（MFA）が有効なアカウントでは、Basic Auth を使用できません。その場合は OAuth 2.0 が必要ですが、このバージョンでは対象外です。

---

月末締め自動化の例

月末締めを自動化するために、AI エージェントが実行する手順は次のとおりです。

1. 現在の期間を確認： get_substitution_variables で CurrMonth = "Mar" を確認します
2. 集計を実行： run_business_rule で "Agg_AllData" を指定します
3. 完了を待機： 返されたジョブ ID を指定して check_job_status を実行します
4. データを検証： Revenue、COGS、Net Income の export_data_slice を実行します
5. 期間を次に進める： update_substitution_variable で CurrMonth を "Mar" から "Apr" に変更します
6. 確認： get_substitution_variables で CurrMonth = "Apr" を確認します

これは財務チームが毎月手作業で行っているのと同じワークフローです。今では自然言語で実行できます。

---

トラブルシューティング

エラー	原因	対処方法
Claude に MCP ツールが表示されない	設定パスが間違っている	claude_desktop_config.json のパスが絶対パスであることを確認してください
401 Unauthorized	ユーザー名の形式	クラウドアカウント名の接頭辞を付けずにユーザー名を入力してください
403 Forbidden	権限が不足している	ユーザーに EPM 管理者権限または適切なロールが必要です
接続が拒否された	URL が間違っている	EPM_BASE_URL が環境と一致していることを確認してください
ETIMEDOUT	ネットワーク／ファイアウォール	マシンから EPM URL に接続できることを確認してください

---

次の予定

• MFA が有効な環境向けの OAuth 2.0 サポート
• **FCCS 固有のツール：**連結、会社間消去
• **データ統合ツール：**Migration API によるファイルのアップロードとダウンロード
• **Groovy ルールの実行：**REST API による Groovy スクリプトの実行

---

概要

このサーバーは、AI エージェントを Oracle EPM Cloud に接続する継続的なシリーズの一部です。Oracle EPM に関するコンテンツ、チュートリアル、ツールについては、以下をご覧ください。

• 概要記事： Claude AI を Oracle EPM Cloud に接続する方法
• セットアップチュートリアル： Oracle EPM Cloud 用の AI エージェントをステップごとに設定する方法
• すべてのインサイトと記事： fmepm.com/insights
• YouTube チャンネル： @fmepm
• ウェブサイト： fmepm.com
• LinkedIn： Fred Mamadjanov

Oracle EPM を利用していて、AI 統合について相談をご希望ですか？相談予約。

---

これは Oracle の製品ではありません。Oracle EPM Cloud は Oracle Corporation の商標です。