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, EPM Solution Architect | fmepm.com

Was dieses Tool bewirkt

Dieser MCP-Server ermöglicht es KI-Agenten, 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 das 1. Quartal für Nordamerika“

• „Rolle den aktuellen Monat von März auf April vor“

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

Architektur

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

Verfügbare Tools

Schnellstart (Mock-Modus — Keine EPM-Umgebung erforderlich)

Voraussetzungen

• Node.js 18+ installiert (Download)

• Claude Desktop installiert (Download)

Schritt 1: Herunterladen und installieren

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

Mac-Beispiel:

{
  "mcpServers": {
    "oracle-epm-cloud": {
      "command": "node",
      "args": ["/Users/fred/oracle-epm-mcp-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“ aufgeführt ist.

Schritt 4: Ausprobieren

Geben Sie in Claude Desktop ein:

„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, legen Sie diese Umgebungsvariablen in Ihrer Claude Desktop-Konfiguration fest:

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

Das ist alles. Dieselben 7 Tools, aber jetzt mit Ihrer echten Umgebung verbunden.

Hinweis zur Authentifizierung

Die REST-APIs verwenden die Standardauthentifizierung (Basic Auth). Ihr Benutzername muss das Format Identitätsdomäne.Benutzername 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 müssten stattdessen OAuth 2.0 verwenden (in dieser Version nicht enthalten).

Beispiel für die Automatisierung des Monatsabschlusses

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

1. Aktuellen Zeitraum prüfen: get_substitution_variables → erkennt 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, Herstellungskosten, Nettoeinkommen

5. Zeitraum vorrollen: update_substitution_variable CurrMonth von „Mar“ auf „Apr“

6. Bestätigen: get_substitution_variables → verifiziert CurrMonth = „Apr“

Dies ist genau 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 aktiviertem MFA

• FCCS-spezifische Tools — Konsolidierung, Intercompany-Eliminierung

• Datenintegrationstools — Datei-Upload/-Download über Migrations-APIs

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

Über

Dieser Server wurde als Teil der Demonstration zur Verbindung eines KI-Agenten mit der Oracle EPM Cloud erstellt. Für weitere Oracle EPM-Inhalte, Tutorials und Tools:

• Video-Walkthrough: Building an AI Agent for Oracle EPM Cloud

• Website: fmepm.com

• YouTube: @fmepm

• LinkedIn: Fred Mamadjanov

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