Oracle EPM Cloud MCP-Server

Verbinden Sie Claude AI (oder jeden anderen MCP-kompatiblen Client) über REST-APIs mit der Oracle EPM Cloud.

Entwickelt von Fred Mamadjanov, Oracle ACE und EPM Solution Architect. Mehr unter fmepm.com.

Wenn Ihnen dies Zeit gespart hat, geben Sie dem Repository bitte einen Stern. Sterne sind die Art und Weise, wie andere Oracle EPM-Anwender diese Arbeit finden, und es ist das deutlichste Signal für mich, dass sie nützlich ist.

Was dieses Tool bewirkt

Dieser MCP-Server gibt KI-Agenten die Fähigkeit, mit der Oracle EPM Cloud zu interagieren. Anstatt Postman-Aufrufe oder EPM Automate-Befehle manuell auszuführen, können Sie Claude bitten:

• "Welche Anwendungen befinden sich in meiner EPM-Umgebung?"

• "Zeige mir die aktuellen Substitutionsvariablen"

• "Führe die Geschäftsregel Agg_AllData aus"

• "Exportiere die Umsatzdaten für Q1 für Nordamerika"

• "Setze den aktuellen Monat von März auf April vor"

Der Server übersetzt diese Anfragen in natürlicher Sprache in Oracle EPM REST-API-Aufrufe.

Related MCP server: mcp-oraclefusion

📺 Video-Tutorials und vollständige Artikel

Episode 2: Wie ich das gebaut habe Aufbau eines KI-Agenten für die Oracle EPM Cloud unter Verwendung von MCP und REST-APIs.

• Auf YouTube ansehen: youtu.be/At4_ZIq2jBY

• Vollständiger Artikel auf fmepm.com: How to Connect Claude AI to Oracle EPM Cloud

Episode 3: Einrichtung (Schritt für Schritt) Installieren und konfigurieren Sie diesen MCP-Server in 5 Minuten.

• Auf YouTube ansehen: youtu.be/kgUDAKARk7c

• Vollständige Einrichtungsanleitung auf fmepm.com: How to Set Up an AI Agent for Oracle EPM Cloud

Architektur

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

Verfügbare Tools

Installation

Zwei Optionen. Wählen Sie diejenige, die zu Ihrer Arbeitsweise passt.

Option A: Ein-Klick-Installation (Empfohlen)

Verfügbar ab v2.0.0. Laden Sie die Desktop-Erweiterung herunter, installieren Sie sie, fertig. Keine Pfadbearbeitung, keine JSON-Konfigurationsdatei.

1. Laden Sie oracle-epm-cloud-2.0.0.mcpb aus dem neuesten Release herunter.

2. Öffnen Sie Claude Desktop. Gehen Sie zu Einstellungen → Erweiterungen → Erweitert → Erweiterung installieren.

3. Wählen Sie die .mcpb-Datei aus.

4. Das war's. Der Mock-Modus funktioniert sofort. Zum Testen sind keine Oracle-Anmeldedaten erforderlich.

Für den Live-Modus (echte EPM-Umgebung) konfigurieren Sie Ihre Umgebungsvariablen über die Erweiterungseinstellungen von Claude Desktop.

Option B: Manuelle Installation (Für Entwickler)

Verwenden Sie diese Option, wenn Sie den Code lesen oder ändern möchten.

Voraussetzungen

• Node.js 18+ installiert (Download)

• Claude Desktop installiert (Download)

Benötigen Sie eine Videoanleitung? Sehen Sie sich Episode 3 auf YouTube an oder lesen Sie die Schritt-für-Schritt-Anleitung auf fmepm.com.

Schritt 1: Klonen und installieren

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

Schritt 2: Claude Desktop konfigurieren

Öffnen Sie Claude Desktop → Einstellungen → Entwickler → Konfiguration bearbeiten.

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "oracle-epm-cloud": {
      "command": "node",
      "args": ["/FULL/PATH/TO/oracle-epm-mcp-server/server/index.js"]
    }
  }
}

Ersetzen Sie /FULL/PATH/TO/ durch den tatsächlichen Pfad auf Ihrem Computer.

Windows-Beispiel:

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

Mac-Beispiel:

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

Schritt 3: Claude Desktop neu starten

Beenden Sie Claude Desktop vollständig und öffnen Sie es erneut. Sie sollten das MCP-Tool-Symbol (Hammer) im Chat-Eingabebereich sehen. Klicken Sie darauf, um zu überprüfen, ob "oracle-epm-cloud" aufgelistet ist.

Schritt 4: Ausprobieren

Tippen Sie in Claude Desktop:

"Welche EPM-Anwendungen sind in meiner Umgebung verfügbar?"

Claude wird das Tool list_applications verwenden und die Mock-Daten zurückgeben.

Wechsel in den Live-Modus (Echte EPM-Umgebung)

Wenn Sie Zugriff auf eine Oracle EPM Cloud-Umgebung haben, setzen Sie diese Umgebungsvariablen in Ihrer Claude Desktop-Konfiguration:

{
  "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"
      }
    }
  }
}

Dieselben 7 Tools greifen nun auf Ihre echte Umgebung zu.

Hinweis zur Authentifizierung

Die REST-APIs verwenden die Standardauthentifizierung (Basic Authentication). Ihr Benutzername muss das Format identitydomain.username haben. Dies ist der häufigste Fehler. Wenn Sie 401-Fehler erhalten, überprüfen Sie dies zuerst.

Konten mit aktivierter Multi-Faktor-Authentifizierung (MFA) können keine Standardauthentifizierung verwenden. Sie benötigen stattdessen OAuth 2.0, was in dieser Version nicht abgedeckt ist.

Beispiel für die Automatisierung des Monatsabschlusses

Hier ist die Sequenz, die ein KI-Agent befolgen würde, um einen Monatsabschluss zu automatisieren:

1. Aktuelle Periode prüfen: get_substitution_variables sieht CurrMonth = "Mar"

2. Aggregation ausführen: run_business_rule mit "Agg_AllData"

3. Auf Abschluss warten: check_job_status mit der zurückgegebenen Job-ID

4. Daten validieren: export_data_slice für Umsatz, COGS, Nettoergebnis

5. Periode vorwärts rollen: update_substitution_variable CurrMonth von "Mar" auf "Apr"

6. Bestätigen: get_substitution_variables verifiziert CurrMonth = "Apr"

Dies ist derselbe Arbeitsablauf, den ein Finanzteam jeden Monat manuell durchführt. Jetzt ausführbar durch natürliche Sprache.

Fehlerbehebung

Was kommt als Nächstes

• OAuth 2.0-Unterstützung für Umgebungen mit aktivierter MFA

• FCCS-spezifische Tools: Konsolidierung, Intercompany-Eliminierung

• Datenintegrationstools: Datei-Upload und -Download über Migrations-APIs

• Groovy-Regelausführung: Ausführen von Groovy-Skripten über REST-API

Über

Dieser Server ist Teil einer fortlaufenden Serie über die Verbindung von KI-Agenten mit der Oracle EPM Cloud. Für weitere Oracle EPM-Inhalte, Tutorials und Tools:

• Übersichtsartikel: How to Connect Claude AI to Oracle EPM Cloud

• Einrichtungs-Tutorial: How to Set Up an AI Agent for Oracle EPM Cloud, Step by Step

• Alle Einblicke und Artikel: fmepm.com/insights

• YouTube-Kanal: @fmepm

• Website: fmepm.com

• LinkedIn: Fred Mamadjanov

Arbeiten Sie mit Oracle EPM und möchten über KI-Integration sprechen? Buchen Sie ein Discovery-Gespräch.

Dies ist kein Oracle-Produkt. Oracle EPM Cloud ist eine Marke der Oracle Corporation.