Oracle EPM Cloud MCPサーバー

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

作成者: Fred Mamadjanov — Oracle ACE, EPMソリューションアーキテクト | fmepm.com

このツールの機能

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

• 「私のEPM環境にはどのようなアプリケーションがありますか？」

• 「現在の置換変数を表示して」

• 「Agg_AllDataビジネスルールを実行して」

• 「北米の第1四半期の収益データをエクスポートして」

• 「現在の月を3月から4月に進めて」

サーバーは、これらの自然言語によるリクエストをOracle EPM REST API呼び出しに変換します。

アーキテクチャ

You (natural language) → Claude Desktop → MCP Protocol → This Server → Oracle EPM REST APIs → Your EPM Cloud

利用可能なツール

クイックスタート（モックモード — EPM環境不要）

前提条件

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

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

ステップ 1: ダウンロードとインストール

# Clone or download this folder
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/index.js"]
    }
  }
}

/FULL/PATH/TO/ をお使いの環境の実際のパスに置き換えてください。

Windowsの例:

{
  "mcpServers": {
    "oracle-epm-cloud": {
      "command": "node",
      "args": ["C:\\Users\\Fred\\oracle-epm-mcp-server\\index.js"]
    }
  }
}

Macの例:

{
  "mcpServers": {
    "oracle-epm-cloud": {
      "command": "node",
      "args": ["/Users/fred/oracle-epm-mcp-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/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固有ツール — 連結、内部取引消去

• データ統合ツール — 移行API経由のファイルアップロード/ダウンロード

• Groovyルール実行 — REST API経由でのGroovyスクリプト実行

について

このサーバーは、AIエージェントをOracle EPM Cloudに接続するデモンストレーションの一環として構築されました。その他のOracle EPMコンテンツ、チュートリアル、ツールについては以下を参照してください：

• ビデオ解説: Building an AI Agent for Oracle EPM Cloud

• ウェブサイト: fmepm.com

• YouTube: @fmepm

• LinkedIn: Fred Mamadjanov

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