Servidor MCP de Oracle EPM Cloud

Conecta Claude AI (o cualquier cliente compatible con MCP) a Oracle EPM Cloud mediante APIs REST.

Creado por Fred Mamadjanov — Oracle ACE, Arquitecto de Soluciones EPM | fmepm.com

Qué hace esto

Este servidor MCP proporciona a los agentes de IA la capacidad de interactuar con Oracle EPM Cloud. En lugar de ejecutar manualmente llamadas de Postman o comandos de EPM Automate, puedes pedirle a Claude que:

• "¿Qué aplicaciones hay en mi entorno EPM?"

• "Muéstrame las variables de sustitución actuales"

• "Ejecuta la regla de negocio Agg_AllData"

• "Exporta los datos de ingresos del primer trimestre para Norteamérica"

• "Avanza el mes actual de marzo a abril"

El servidor traduce estas solicitudes en lenguaje natural a llamadas a la API REST de Oracle EPM.

Arquitectura

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

Herramientas disponibles

Inicio rápido (Modo simulado — No se necesita entorno EPM)

Requisitos previos

• Node.js 18+ instalado (descargar)

• Claude Desktop instalado (descargar)

Paso 1: Descargar e instalar

# Clone or download this folder
cd oracle-epm-mcp-server
npm install

Paso 2: Configurar Claude Desktop

Abre Claude Desktop → Settings → Developer → Edit Config

Añade esto a tu claude_desktop_config.json:

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

Reemplaza /FULL/PATH/TO/ con la ruta real en tu máquina.

Ejemplo en Windows:

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

Ejemplo en Mac:

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

Paso 3: Reiniciar Claude Desktop

Cierra Claude Desktop completamente y vuelve a abrirlo. Deberías ver el icono de herramientas MCP (martillo) en el área de entrada del chat. Haz clic en él para verificar que "oracle-epm-cloud" aparece en la lista.

Paso 4: Pruébalo

Escribe en Claude Desktop:

"¿Qué aplicaciones EPM están disponibles en mi entorno?"

Claude usará la herramienta list_applications y devolverá los datos simulados.

Cambio al modo en vivo (Entorno EPM real)

Cuando tengas acceso a un entorno de Oracle EPM Cloud, configura estas variables de entorno en tu configuración de 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"
      }
    }
  }
}

Eso es todo. Las mismas 7 herramientas, pero ahora conectadas a tu entorno real.

Nota sobre la autenticación

Las APIs REST utilizan autenticación básica (Basic Authentication). El formato de tu nombre de usuario debe ser identitydomain.username: este es el error número 1 más común. Si recibes errores 401, comprueba esto primero.

Las cuentas con autenticación multifactor (MFA) habilitada no pueden usar autenticación básica. Necesitarías OAuth 2.0 en su lugar (no cubierto en esta versión).

Ejemplo de automatización de cierre de mes

Esta es la secuencia que seguiría un agente de IA para automatizar un cierre de mes:

1. Comprobar periodo actual: get_substitution_variables → ve que CurrMonth = "Mar"

2. Ejecutar agregación: run_business_rule con "Agg_AllData"

3. Esperar finalización: check_job_status con el ID de trabajo devuelto

4. Validar datos: export_data_slice para Ingresos, COGS, Ingresos Netos

5. Avanzar periodo: update_substitution_variable CurrMonth de "Mar" a "Apr"

6. Confirmar: get_substitution_variables → verifica que CurrMonth = "Apr"

Este es exactamente el mismo flujo de trabajo que un equipo financiero realiza manualmente cada mes; ahora ejecutable mediante lenguaje natural.

Solución de problemas

¿Qué sigue?

• Soporte para OAuth 2.0 — para entornos con MFA habilitado

• Herramientas específicas para FCCS — consolidación, eliminación intercompañía

• Herramientas de integración de datos — carga/descarga de archivos mediante APIs de migración

• Ejecución de reglas Groovy — ejecutar scripts Groovy mediante API REST

Acerca de

Este servidor fue creado como parte de la demostración de cómo conectar un agente de IA a Oracle EPM Cloud. Para más contenido, tutoriales y herramientas de Oracle EPM:

• Tutorial en vídeo: Building an AI Agent for Oracle EPM Cloud

• Sitio web: fmepm.com

• YouTube: @fmepm

• LinkedIn: Fred Mamadjanov

Este no es un producto de Oracle. Oracle EPM Cloud es una marca comercial de Oracle Corporation.