Oracle EPM Cloud MCP Server

Conecte agentes de IA ao Oracle EPM Cloud (Planning, PBCS, EPBCS) via APIs REST. Automatize o fechamento de fim de mês, execute regras de negócios, gerencie variáveis de substituição, atualize bancos de dados, exporte fatias de dados e monitore o status de jobs por meio de linguagem natural. Desenvolvido por Fred Mamadjanov, Oracle ACE e Arquiteto de Soluções EPM.

GitHub

Experimente este MCPPatrocinado

Documentação

Oracle EPM Cloud MCP Server

Conecte o Claude AI (ou qualquer cliente compatível com MCP) ao Oracle EPM Cloud por meio de APIs REST.

Desenvolvido por Fred Mamadjanov, Oracle ACE Pro e Arquiteto de Soluções EPM. Mais em fmepm.com.

Se isso economizou seu tempo, por favor dê uma estrela no repositório. As estrelas são como outras pessoas da comunidade Oracle EPM encontram este trabalho, e é o sinal mais claro que tenho de que é útil.

Antes de Conectar Isso a um Sistema Real

Esta demonstração ilustra apenas um fluxo de trabalho potencial. Antes de conectar qualquer ferramenta de IA, LLM ou servidor MCP ao NSPB ou a outros sistemas corporativos, as organizações devem obter aprovação de suas equipes de TI, segurança e conformidade e garantir a adesão às políticas internas de governança de dados e segurança.

O modo mock existe para que você possa testar tudo com dados de exemplo e sem credenciais. Use-o.

O Que Isso Faz

Este servidor MCP dá aos agentes de IA a capacidade de interagir com o Oracle EPM Cloud. Em vez de executar manualmente chamadas Postman ou comandos EPM Automate, você pode pedir ao Claude para:

"Quais aplicativos estão no meu ambiente EPM?"
"Mostre-me as variáveis de substituição atuais"
"Execute a regra de negócio Agg_AllData"
"Exporte os dados de receita do Q1 para a América do Norte"
"Avance o mês atual de Mar para Abr"

O servidor traduz essas solicitações em linguagem natural em chamadas de API REST do Oracle EPM.

📺 Tutoriais em Vídeo e Artigos Completos

Episódio 2: Como Eu Construí Isso Construindo um agente de IA para Oracle EPM Cloud usando MCP e APIs REST.

Assista no YouTube: youtu.be/At4_ZIq2jBY
Artigo completo em fmepm.com: Como Conectar o Claude AI ao Oracle EPM Cloud

Episódio 3: Como Configurar (Passo a Passo) Instale e configure este servidor MCP em 5 minutos.

Assista no YouTube: youtu.be/kgUDAKARk7c
Guia completo de configuração em fmepm.com: Como Configurar um Agente de IA para Oracle EPM Cloud

Arquitetura

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

Ferramentas Disponíveis

Ferramenta	O Que Ela Faz	API REST EPM
`get_api_version`	Testa a conectividade, descobre versões da API	`GET /HyperionPlanning/rest/`
`list_applications`	Lista todos os aplicativos EPM	`GET /HyperionPlanning/rest/v3/applications`
`get_substitution_variables`	Lê as variáveis atuais de mês, ano e cenário	`GET .../substitutionvariables`
`run_business_rule`	Executa um script de cálculo ou regra de negócio	`POST .../jobs`
`check_job_status`	Verifica se um job foi concluído ou apresentou erro	`GET .../jobs/{jobId}`
`export_data_slice`	Extrai dados do cubo por membros de dimensão	`POST .../exportdataslice`
`update_substitution_variable`	Altera o valor de uma variável de substituição	`PUT .../substitutionvariables`

Instalação

Duas opções. Escolha a que melhor se adapta ao seu modo de trabalho.

Opção A: Instalação com Um Clique (Recomendada)

Disponível na v2.0.0 e versões posteriores. Baixe a Extensão para Desktop, instale-a, pronto. Sem edição de caminhos, sem arquivo de configuração JSON.

Baixe oracle-epm-cloud-2.0.0.mcpb da última versão.
Abra o Claude Desktop. Vá em Configurações → Extensões → Avançado → Instalar Extensão.
Selecione o arquivo .mcpb.
Pronto. O modo mock funciona imediatamente. Nenhuma credencial Oracle é necessária para testar.

Para o modo ao vivo (ambiente EPM real), configure suas variáveis de ambiente nas configurações de extensão do Claude Desktop.

Opção B: Instalação Manual (Para Desenvolvedores)

Use esta opção se quiser ler ou modificar o código.

Pré-requisitos

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

Precisa de um tutorial em vídeo? Assista ao Episódio 3 no YouTube ou leia o guia passo a passo em fmepm.com.

Passo 1: Clone e instale

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

Passo 2: Configure o Claude Desktop

Abra o Claude Desktop → Configurações → Desenvolvedor → Editar Config.

Adicione isto ao seu claude_desktop_config.json:

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

Substitua /FULL/PATH/TO/ pelo caminho real na sua máquina.

Exemplo no Windows:

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

Exemplo no Mac:

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

Passo 3: Reinicie o Claude Desktop

Feche o Claude Desktop completamente e reabra-o. Você deve ver o ícone de ferramentas MCP (martelo) na área de entrada do chat. Clique nele para verificar se "oracle-epm-cloud" está listado.

Passo 4: Experimente

Digite no Claude Desktop:

"Quais aplicativos EPM estão disponíveis no meu ambiente?"

O Claude usará a ferramenta list_applications e retornará os dados mock.

Alternando para o Modo ao Vivo (Ambiente EPM Real)

Antes de fazer isso em um ambiente corporativo, leia a nota no topo desta página: obtenha aprovação das suas equipes de TI, segurança e conformidade primeiro.

Quando você tiver acesso a um ambiente Oracle EPM Cloud, defina estas variáveis de ambiente na configuração do seu 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"
      }
    }
  }
}

As mesmas 7 ferramentas, agora acessando seu ambiente real.

Nota sobre Autenticação

As APIs REST usam Autenticação Básica. O formato do seu nome de usuário deve ser identitydomain.username. Este é o erro mais comum de todos. Se você receber erros 401, verifique isso primeiro.

Contas com autenticação multifator (MFA) habilitada não podem usar Autenticação Básica. Você precisaria de OAuth 2.0, que não é abordado nesta versão.

Exemplo de Automação de Fechamento de Fim de Mês

Aqui está a sequência que um agente de IA seguiria para automatizar um fechamento de fim de mês:

Verificar o período atual: get_substitution_variables vê CurrMonth = "Mar"
Executar agregação: run_business_rule com "Agg_AllData"
Aguardar a conclusão: check_job_status com o ID do job retornado
Validar dados: export_data_slice para Receita, CPV, Lucro Líquido
Avançar o período: update_substitution_variable CurrMonth de "Mar" para "Abr"
Confirmar: get_substitution_variables verifica CurrMonth = "Abr"

Este é o mesmo fluxo de trabalho que uma equipe financeira faz manualmente todos os meses. Agora executável por meio de linguagem natural.

Solução de Problemas

Erro	Causa	Correção
Ferramentas MCP não aparecem no Claude	Caminho de configuração errado	Verifique se o caminho `claude_desktop_config.json` é absoluto
401 Unauthorized	Formato do nome de usuário	Use `identitydomain.username`, não apenas o nome de usuário
403 Forbidden	Permissões insuficientes	O usuário precisa ser admin EPM ou ter a função apropriada
Connection refused	URL errada	Verifique se `EPM_BASE_URL` corresponde ao seu ambiente
ETIMEDOUT	Rede/firewall	Verifique se você consegue acessar a URL do EPM a partir da sua máquina

Próximos Passos

Suporte a OAuth 2.0 para ambientes com MFA habilitada
Ferramentas específicas do FCCS: consolidação, eliminação intercompanhia
Ferramentas de integração de dados: upload e download de arquivos por meio das APIs de Migração
Execução de regras Groovy: executar scripts Groovy via API REST

Sobre

Este servidor faz parte de uma série contínua sobre conexão de agentes de IA ao Oracle EPM Cloud. Para mais conteúdo, tutoriais e ferramentas sobre Oracle EPM:

Artigo de visão geral: Como Conectar o Claude AI ao Oracle EPM Cloud
Tutorial de configuração: Como Configurar um Agente de IA para Oracle EPM Cloud, Passo a Passo
Todos os insights e artigos: fmepm.com/insights
Canal no YouTube: @fmepm
Site: fmepm.com
LinkedIn: Fred Mamadjanov

Trabalha com Oracle EPM e quer discutir integração de IA? Agende uma Chamada de Descoberta.

Este não é um produto Oracle. Oracle EPM Cloud é uma marca registrada da Oracle Corporation.