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: mcp-oraclefusion

📺 ビデオチュートリアルと詳細記事

エピソード 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

利用可能なツール

インストール

2 つのオプションがあります。作業スタイルに合わせて選択してください。

オプション A: ワンクリックインストール (推奨)

v2.0.0 以降で利用可能です。デスクトップ拡張機能をダウンロードしてインストールするだけで完了です。パスの編集や JSON 設定ファイルは不要です。

1. 最新リリース から oracle-epm-cloud-2.0.0.mcpb をダウンロードします。

2. Claude Desktop を開き、[設定] → [拡張機能] → [詳細設定] → [拡張機能をインストール] に移動します。

3. .mcpb ファイルを選択します。

4. 以上です。モックモードはすぐに動作します。テストに Oracle の資格情報は必要ありません。

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

オプション B: 手動インストール (開発者向け)

コードを読み取ったり変更したりしたい場合はこちらを使用してください。

前提条件

• Node.js 18+ がインストールされていること (ダウンロード)

• Claude Desktop がインストールされていること (ダウンロード)

ビデオガイドが必要ですか？ 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 エージェントが月次決算を自動化するために実行するシーケンスの例です：

1. 現在の期間を確認: get_substitution_variables で CurrMonth = "Mar" を確認

2. 集計を実行: "Agg_AllData" を指定して run_business_rule を実行

3. 完了を待機: 返されたジョブ ID を使用して check_job_status を実行

4. データを検証: 収益、売上原価、純利益について export_data_slice を実行

5. 期間を更新: update_substitution_variable で CurrMonth を "Mar" から "Apr" に変更

6. 確認: get_substitution_variables で CurrMonth = "Apr" であることを確認

これは財務チームが毎月手動で行っているワークフローと同じです。これが自然言語を通じて実行可能になります。

トラブルシューティング

今後の予定

• OAuth 2.0 サポート: MFA が有効な環境向け

• 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 の商標です。