Oracle EPM Cloud MCP Server
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: bas-mcp-server
📺 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 CloudHerramientas disponibles
Herramienta | Qué hace | API REST de EPM |
| Prueba la conectividad, descubre versiones de API |
|
| Lista todas las aplicaciones EPM |
|
| Lee las variables actuales de mes, año y escenario |
|
| Ejecuta un script de cálculo o regla de negocio |
|
| Consulta si un trabajo se completó o dio error |
|
| Extrae datos del cubo por miembros de dimensión |
|
| Cambia el valor de una variable de sustitución |
|
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.
Descarga
oracle-epm-cloud-2.0.0.mcpbdesde la versión más reciente.Abre Claude Desktop. Ve a Ajustes → 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 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
¿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 installPaso 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:
Comprobar periodo actual:
get_substitution_variablesve que CurrMonth = "Mar"Ejecutar agregación:
run_business_rulecon "Agg_AllData"Esperar a que finalice:
check_job_statuscon el ID de trabajo devueltoValidar datos:
export_data_slicepara Ingresos, COGS, Ingresos NetosAvanzar periodo:
update_substitution_variableCurrMonth de "Mar" a "Apr"Confirmar:
get_substitution_variablesverifica 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
Error | Causa | Solución |
Las herramientas MCP no aparecen en Claude | Ruta de configuración incorrecta | Comprueba que la ruta en |
401 No autorizado | Formato de nombre de usuario | Usa |
403 Prohibido | Permisos insuficientes | El usuario necesita permisos de administrador de EPM o el rol adecuado |
Conexión rechazada | URL incorrecta | Comprueba que |
ETIMEDOUT | Red/firewall | Verifica que puedes acceder a la URL de EPM desde tu máquina |
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.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Claude, connected to your own Oracle EPM. Each person as themselves, every call checked and logged.
Anaplan MCP server for ChatGPT, Claude and any AI agent: list models, list actions, upload import file, run import, run process, run export, get model history and add user in your own Anaplan account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Anaplan yourself; Cotlet does not store your password and you need no Anaplan API key. About the official Anaplan API: Yes. Anaplan has an official REST API, the Integration API v2.0, and an official MCP server, the Anaplan AI Gateway, but Anaplan's help says the AI Gateway gives external AI systems read-only access (checked 5 Nov 2026). Setup and FAQ: https://cotlet.dev/integrations/anaplan-api-mcp-server
Give AI agents 30,000+ safe, token-optimized actions across Workday, SAP, Oracle + hundreds more.
Personal finance, bank account, and shared memory connector for Claude, ChatGPT, Gemini Spark & more
Related MCP Servers
- AlicenseCqualityFmaintenanceEnables interaction with Oracle EPM Cloud Financial Consolidation and Close (FCCS) through 25+ tools covering REST API operations including jobs, dimensions, journals, data management, reports, and consolidation tasks.36MIT
- AlicenseAqualityDmaintenanceEnables AI agents to interact with 1С:Enterprise and BAS ERP systems through REST and HTTP services, providing tools for searching catalogs, creating documents, and querying stock balances.6ISC
- AlicenseAqualityCmaintenanceEnables AI agents to explore Oracle Fusion Cloud schema metadata, run pre-built BI Publisher reports with bind parameters, and validate results against trusted ground truth.401Apache 2.0
- AlicenseAqualityCmaintenanceEnables AI assistants to explore and report on Oracle-based ERP databases via read-only schema discovery, guarded ad-hoc SQL, and curated reports.5MIT