Oracle EPM Cloud MCP Server

Conecta agentes de IA a Oracle EPM Cloud (Planning, PBCS, EPBCS) a través de APIs REST. Automatiza el cierre de fin de mes, ejecuta reglas de negocio, gestiona variables de sustitución, actualiza bases de datos, exporta segmentos de datos y monitorea el estado de trabajos mediante lenguaje natural. Creado por Fred Mamadjanov, Oracle ACE y Arquitecto de Soluciones EPM.

GitHub

Prueba este MCPPatrocinado

Documentación

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

Si esto te ahorró tiempo, por favor dale una estrella al repositorio. Las estrellas son cómo otros profesionales de Oracle EPM encuentran este trabajo, y es la señal más clara que tengo de que es útil.

Antes de Conectar Esto a un Sistema Real

Esta demo ilustra un flujo de trabajo potencial únicamente. Antes de conectar cualquier herramienta de IA, LLM o servidor MCP a NSPB u otros sistemas empresariales, las organizaciones deben obtener la aprobación de sus equipos de TI, seguridad y cumplimiento, y asegurarse de cumplir con las políticas internas de gobernanza de datos y seguridad.

El modo simulado existe para que puedas probar todo con datos de muestra y sin credenciales. Úsalo.

Qué Hace Esto

Este servidor MCP brinda 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 de 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 Mar a Abr"

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

📺 Tutoriales en Video y Artículos Completos

Episodio 2: Cómo Construí Esto Creación de 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 Configurarlo (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

Herramienta	Qué Hace	API REST de EPM
`get_api_version`	Probar conectividad, descubrir versiones de API	`GET /HyperionPlanning/rest/`
`list_applications`	Listar todas las aplicaciones de EPM	`GET /HyperionPlanning/rest/v3/applications`
`get_substitution_variables`	Leer mes actual, año, variables de escenario	`GET .../substitutionvariables`
`run_business_rule`	Ejecutar un script de cálculo o regla de negocio	`POST .../jobs`
`check_job_status`	Consultar si un trabajo se completó o falló	`GET .../jobs/{jobId}`
`export_data_slice`	Extraer datos del cubo por miembros de dimensión	`POST .../exportdataslice`
`update_substitution_variable`	Cambiar el valor de una variable de sustitución	`PUT .../substitutionvariables`

Instalación

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

Opción A: Instalación con un Clic (Recomendada)

Disponible en v2.0.0 y versiones posteriores. Descarga la Extensión de Escritorio, instálala, listo. Sin edición de rutas, sin archivo de configuración JSON.

Descarga oracle-epm-cloud-2.0.0.mcpb desde la última versión.
Abre Claude Desktop. Ve a Configuración → Extensiones → Avanzado → Instalar Extensión.
Selecciona el archivo .mcpb.
Eso es todo. El modo simulado funciona de inmediato. No se necesitan credenciales de Oracle para probar.

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

Opción B: Instalación Manual (Para Desarrolladores)

Usa esta opción si quieres leer o modificar el código.

Requisitos previos

Node.js 18+ instalado (descargar)
Claude Desktop instalado (descargar)

¿Necesitas un video explicativo? 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 → Configuración → Desarrollador → Editar Configuración.

Agrega 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 por completo y vuelve a abrirlo. Deberías ver el ícono de herramientas MCP (martillo) en el área de entrada de chat. Haz clic en él para verificar que "oracle-epm-cloud" esté listado.

Paso 4: Probar

Escribe en Claude Desktop:

"¿Qué aplicaciones de 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)

Antes de hacer esto en un entorno empresarial, lee la nota al inicio de esta página: obtén la aprobación de tus equipos de TI, seguridad y cumplimiento primero.

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 Autenticación

Las APIs REST usan Autenticación Básica. El formato de tu nombre de usuario debe ser identitydomain.username. Este es el error más común. Si recibes errores 401, verifica 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, lo cual 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:

Verificar período actual: get_substitution_variables ve CurrMonth = "Mar"
Ejecutar agregación: run_business_rule con "Agg_AllData"
Esperar finalización: check_job_status con el ID de trabajo devuelto
Validar datos: export_data_slice para Ingresos, COGS, Ingreso Neto
Avanzar período: update_substitution_variable CurrMonth de "Mar" a "Abr"
Confirmar: get_substitution_variables verifica CurrMonth = "Abr"

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

Solución de Problemas

Error	Causa	Solución
Las herramientas MCP no aparecen en Claude	Ruta de configuración incorrecta	Verifica que la ruta de `claude_desktop_config.json` sea absoluta
401 No autorizado	Formato de nombre de usuario	Usa `identitydomain.username`, no solo el nombre de usuario
403 Prohibido	Permisos insuficientes	El usuario necesita rol de administrador de EPM o uno apropiado
Conexión rechazada	URL incorrecta	Verifica que `EPM_BASE_URL` coincida con tu entorno
ETIMEDOUT	Red/firewall	Verifica que puedas alcanzar la URL de EPM desde tu máquina

Qué Sigue

Soporte para OAuth 2.0 para entornos con MFA habilitada
Herramientas específicas de 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 en curso sobre cómo conectar agentes de IA a Oracle EPM Cloud. Para más contenido, tutoriales y herramientas sobre Oracle EPM:

Artículo general: 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
Todos los artículos y perspectivas: fmepm.com/insights
Canal de YouTube: @fmepm
Sitio web: fmepm.com
LinkedIn: Fred Mamadjanov

¿Trabajas con Oracle EPM y quieres discutir la integración de IA? Agenda una Llamada de Descubrimiento.

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