Oracle EPM Cloud MCP 서버

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

제작자: Fred Mamadjanov — Oracle ACE, EPM 솔루션 아키텍트 | fmepm.com

기능

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

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

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

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

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

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

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

아키텍처

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

사용 가능한 도구

빠른 시작 (모의 모드 — EPM 환경 불필요)

사전 요구 사항

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

• Claude Desktop 설치 (다운로드)

1단계: 다운로드 및 설치

# Clone or download this folder
cd oracle-epm-mcp-server
npm install

2단계: Claude Desktop 구성

Claude Desktop 열기 → 설정(Settings) → 개발자(Developer) → 구성 편집(Edit Config)

claude_desktop_config.json에 다음을 추가하세요:

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

/FULL/PATH/TO/를 사용 중인 머신의 실제 경로로 바꾸세요.

Windows 예시:

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

Mac 예시:

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

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

문제 해결

다음 단계

• OAuth 2.0 지원 — MFA가 활성화된 환경용

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

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

• Groovy 규칙 실행 — REST API를 통한 Groovy 스크립트 실행

정보

이 서버는 AI 에이전트를 Oracle EPM Cloud에 연결하는 시연의 일환으로 제작되었습니다. 더 많은 Oracle EPM 콘텐츠, 튜토리얼 및 도구는 다음을 참조하세요:

• 영상 가이드: Building an AI Agent for Oracle EPM Cloud

• 웹사이트: fmepm.com

• YouTube: @fmepm

• LinkedIn: Fred Mamadjanov

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