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 y Arquitecto de Soluciones EPM. Más información en fmepm.com.

Si esto te ha ahorrado tiempo, por favor marca el repositorio con una estrella. Las estrellas son la forma en que otros profesionales de Oracle EPM encuentran este trabajo, y es la señal más clara que tengo de que es útil.

Qué hace esto

Este servidor MCP ofrece 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.

Related MCP server: mcp-oraclefusion

📺 Tutoriales en vídeo y artículos completos

Episodio 2: Cómo lo construí Construyendo un agente de IA para Oracle EPM Cloud usando MCP y APIs REST.

• Ver en YouTube: youtu.be/At4_ZIq2jBY

• Artículo completo en fmepm.com: Cómo conectar Claude AI a Oracle EPM Cloud

Episodio 3: Cómo configurar (paso a paso) Instala y configura este servidor MCP en 5 minutos.

• Ver en YouTube: youtu.be/kgUDAKARk7c

• Guía de configuración completa en fmepm.com: Cómo configurar un agente de IA para Oracle EPM Cloud

Arquitectura

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

Herramientas disponibles

Instalación

Dos opciones. Elige la que mejor se adapte a tu forma de trabajar.

Opción A: Instalación con un clic (Recomendado)

Disponible en la versión 2.0.0 y posteriores. Descarga la extensión de escritorio, instálala y listo. Sin edición de rutas, sin archivo de configuración JSON.

1. Descarga oracle-epm-cloud-2.0.0.mcpb desde la versión más reciente.

2. Abre Claude Desktop. Ve a Ajustes → Extensiones → Avanzado → Instalar extensión.

3. Selecciona el archivo .mcpb.

4. Eso es todo. El modo simulado funciona de inmediato. No se necesitan credenciales de Oracle para probarlo.

Para el modo en vivo (entorno EPM real), configura tus variables de entorno a través de los ajustes de extensión de Claude Desktop.

Opción B: Instalación manual (Para desarrolladores)

Úsala si quieres leer o modificar el código.

Requisitos previos

• Node.js 18+ instalado (descargar)

• Claude Desktop instalado (descargar)

¿Necesitas una guía en vídeo? Mira el Episodio 3 en YouTube o lee la guía paso a paso en fmepm.com.

Paso 1: Clonar e instalar

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

Paso 2: Configurar Claude Desktop

Abre Claude Desktop → Ajustes → Desarrollador → Editar configuración.

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "oracle-epm-cloud": {
      "command": "node",
      "args": ["/FULL/PATH/TO/oracle-epm-mcp-server/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\\server\\index.js"]
    }
  }
}

Ejemplo en Mac:

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

Cambiar 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/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"
      }
    }
  }
}

Las mismas 7 herramientas, ahora conectadas a tu entorno real.

Nota sobre la autenticación

Las APIs REST utilizan autenticación básica. El formato de tu nombre de usuario debe ser dominioidentidad.nombreusuario. Este es el error 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, que no está 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 a que finalice: 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 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 y descarga de archivos mediante APIs de migración

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

Acerca de

Este servidor es parte de una serie continua sobre cómo conectar agentes de IA a Oracle EPM Cloud. Para más contenido, tutoriales y herramientas de Oracle EPM:

• Artículo de resumen: Cómo conectar Claude AI a Oracle EPM Cloud

• Tutorial de configuración: Cómo configurar un agente de IA para Oracle EPM Cloud, paso a paso

• Todas las ideas y artículos: fmepm.com/insights

• Canal de YouTube: @fmepm

• Sitio web: fmepm.com

• LinkedIn: Fred Mamadjanov

¿Trabajas con Oracle EPM y quieres hablar sobre integración de IA? Reserva una llamada de descubrimiento.

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