Oracle EPM Cloud MCP 서버

REST API를 통해 Claude AI(또는 모든 MCP 호환 클라이언트)를 Oracle EPM Cloud에 연결합니다.

Oracle ACE이자 EPM 솔루션 아키텍트인 Fred Mamadjanov가 제작했습니다. 자세한 내용은 fmepm.com에서 확인하세요.

이 도구가 시간을 절약해 주었다면 저장소를 별표(star)해 주세요. 별표는 다른 Oracle EPM 사용자들이 이 작업을 찾는 방법이며, 이 도구가 유용하다는 가장 확실한 신호입니다.

이 도구의 기능

이 MCP 서버는 AI 에이전트에게 Oracle EPM Cloud와 상호 작용할 수 있는 능력을 제공합니다. 수동으로 Postman 호출이나 EPM Automate 명령을 실행하는 대신, Claude에게 다음과 같이 요청할 수 있습니다:

• "내 EPM 환경에 어떤 애플리케이션이 있나요?"

• "현재 대체 변수를 보여줘"

• "Agg_AllData 비즈니스 규칙을 실행해"

• "북미 지역의 1분기 매출 데이터를 내보내"

• "현재 월을 3월에서 4월로 변경해"

서버는 이러한 자연어 요청을 Oracle EPM REST API 호출로 변환합니다.

Related MCP server: mcp-oraclefusion

📺 비디오 튜토리얼 및 전체 기사

에피소드 2: 제작 과정 MCP와 REST API를 사용하여 Oracle EPM Cloud용 AI 에이전트 구축하기.

• YouTube에서 보기: youtu.be/At4_ZIq2jBY

• fmepm.com의 전체 기사: Claude AI를 Oracle EPM Cloud에 연결하는 방법

에피소드 3: 설정 방법 (단계별) 5분 안에 이 MCP 서버를 설치하고 구성하세요.

• YouTube에서 보기: youtu.be/kgUDAKARk7c

• fmepm.com의 전체 설정 가이드: Oracle EPM Cloud용 AI 에이전트 설정 방법

아키텍처

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

사용 가능한 도구

설치

두 가지 옵션이 있습니다. 작업 방식에 맞는 것을 선택하세요.

옵션 A: 원클릭 설치 (권장)

v2.0.0 이상에서 사용 가능합니다. 데스크톱 확장 프로그램을 다운로드하여 설치하면 끝입니다. 경로 편집이나 JSON 구성 파일이 필요 없습니다.

1. 최신 릴리스에서 oracle-epm-cloud-2.0.0.mcpb를 다운로드합니다.

2. Claude Desktop을 엽니다. 설정 → 확장 프로그램 → 고급 → 확장 프로그램 설치로 이동합니다.

3. .mcpb 파일을 선택합니다.

4. 완료되었습니다. 모의 모드(Mock mode)는 즉시 작동합니다. 테스트를 위해 Oracle 자격 증명이 필요하지 않습니다.

라이브 모드(실제 EPM 환경)의 경우, Claude Desktop의 확장 프로그램 설정을 통해 환경 변수를 구성하세요.

옵션 B: 수동 설치 (개발자용)

코드를 읽거나 수정하려는 경우 이 방법을 사용하세요.

사전 요구 사항

• Node.js 18+ 설치됨 (다운로드)

• Claude Desktop 설치됨 (다운로드)

비디오 가이드가 필요하신가요? YouTube의 에피소드 3을 시청하거나 fmepm.com의 단계별 가이드를 읽어보세요.

1단계: 복제 및 설치

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

2단계: Claude Desktop 구성

Claude Desktop → 설정 → 개발자 → 구성 편집을 엽니다.

claude_desktop_config.json에 다음을 추가합니다:

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

/FULL/PATH/TO/를 컴퓨터의 실제 경로로 바꿉니다.

Windows 예시:

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

Mac 예시:

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

3단계: Claude Desktop 재시작

Claude Desktop을 완전히 종료하고 다시 엽니다. 채팅 입력 영역에 MCP 도구 아이콘(망치)이 표시되어야 합니다. 클릭하여 "oracle-epm-cloud"가 나열되어 있는지 확인하세요.

4단계: 시도해 보기

Claude Desktop에 입력하세요:

"내 환경에서 사용 가능한 EPM 애플리케이션은 무엇인가요?"

Claude가 list_applications 도구를 사용하여 모의 데이터를 반환합니다.

라이브 모드로 전환 (실제 EPM 환경)

Oracle EPM Cloud 환경에 액세스할 수 있는 경우, 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"
      }
    }
  }
}

동일한 7개의 도구가 이제 실제 환경에 연결됩니다.

인증 참고 사항

REST API는 기본 인증(Basic Authentication)을 사용합니다. 사용자 이름 형식은 반드시 identitydomain.username이어야 합니다. 이는 가장 흔한 실수입니다. 401 오류가 발생하면 이 부분을 먼저 확인하세요.

다중 인증(MFA)이 활성화된 계정은 기본 인증을 사용할 수 없습니다. 대신 OAuth 2.0이 필요하며, 이 버전에서는 지원되지 않습니다.

월말 결산 자동화 예시

AI 에이전트가 월말 결산을 자동화하기 위해 수행할 순서는 다음과 같습니다:

1. 현재 기간 확인: get_substitution_variables로 CurrMonth = "Mar" 확인

2. 집계 실행: "Agg_AllData"로 run_business_rule 실행

3. 완료 대기: 반환된 작업 ID로 check_job_status 실행

4. 데이터 검증: 수익, 매출원가, 순이익에 대해 export_data_slice 실행

5. 기간 롤포워드: CurrMonth를 "Mar"에서 "Apr"로 update_substitution_variable 실행

6. 확인: get_substitution_variables로 CurrMonth = "Apr" 확인

이는 재무팀이 매달 수동으로 수행하는 워크플로우와 동일합니다. 이제 자연어를 통해 실행할 수 있습니다.

문제 해결

다음 단계

• MFA 활성화 환경을 위한 OAuth 2.0 지원

• FCCS 전용 도구: 연결, 내부 거래 제거

• 데이터 통합 도구: 마이그레이션 API를 통한 파일 업로드 및 다운로드

• Groovy 규칙 실행: REST API를 통해 Groovy 스크립트 실행

정보

이 서버는 AI 에이전트를 Oracle EPM Cloud에 연결하는 연속 시리즈의 일부입니다. 더 많은 Oracle EPM 콘텐츠, 튜토리얼 및 도구는 다음을 참조하세요:

• 개요 기사: Claude AI를 Oracle EPM Cloud에 연결하는 방법

• 설정 튜토리얼: Oracle EPM Cloud용 AI 에이전트 설정 방법, 단계별

• 모든 인사이트 및 기사: fmepm.com/insights

• YouTube 채널: @fmepm

• 웹사이트: fmepm.com

• LinkedIn: Fred Mamadjanov

Oracle EPM을 사용 중이며 AI 통합에 대해 논의하고 싶으신가요? 상담 예약하기.

이것은 Oracle 제품이 아닙니다. Oracle EPM Cloud는 Oracle Corporation의 상표입니다.