Oracle EPM Cloud MCP Server

Подключите Claude AI (или любой другой MCP-совместимый клиент) к Oracle EPM Cloud через REST API.

Создано Фредом Мамаджановым, Oracle ACE и архитектором решений EPM. Подробнее на fmepm.com.

Если это сэкономило вам время, пожалуйста, поставьте звезду репозиторию. Звезды помогают другим специалистам Oracle EPM находить эту работу, и это самый понятный для меня сигнал о том, что она полезна.

Что это делает

Этот MCP-сервер дает ИИ-агентам возможность взаимодействовать с Oracle EPM Cloud. Вместо того чтобы вручную выполнять вызовы Postman или команды EPM Automate, вы можете попросить Claude:

• "Какие приложения есть в моей среде EPM?"

• "Покажи мне текущие переменные подстановки"

• "Запусти бизнес-правило Agg_AllData"

• "Экспортируй данные о выручке за 1 квартал для Северной Америки"

• "Переведи текущий месяц с марта на апрель"

Сервер преобразует эти запросы на естественном языке в вызовы REST API Oracle EPM.

Related MCP server: mcp-oraclefusion

📺 Видеоуроки и полные статьи

Эпизод 2: Как я это создал Создание ИИ-агента для Oracle EPM Cloud с использованием MCP и REST API.

• Смотреть на YouTube: youtu.be/At4_ZIq2jBY

• Полная статья на fmepm.com: Как подключить Claude AI к Oracle EPM Cloud

Эпизод 3: Как настроить (пошагово) Установите и настройте этот MCP-сервер за 5 минут.

• Смотреть на YouTube: youtu.be/kgUDAKARk7c

• Полное руководство по настройке на fmepm.com: Как настроить ИИ-агента для Oracle EPM Cloud

Архитектура

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

Доступные инструменты

Установка

Два варианта. Выберите тот, который подходит вашему рабочему процессу.

Вариант А: Установка в один клик (рекомендуется)

Доступно в версии 2.0.0 и выше. Скачайте расширение для рабочего стола, установите его, готово. Никакого редактирования путей, никаких файлов конфигурации JSON.

1. Скачайте oracle-epm-cloud-2.0.0.mcpb из последнего релиза.

2. Откройте Claude Desktop. Перейдите в Settings → Extensions → Advanced → Install Extension.

3. Выберите файл .mcpb.

4. Это всё. Режим имитации (mock mode) работает сразу. Для тестирования учетные данные Oracle не требуются.

Для рабочего режима (реальная среда EPM) настройте переменные окружения через настройки расширения в Claude Desktop.

Вариант Б: Ручная установка (для разработчиков)

Используйте этот вариант, если хотите прочитать или изменить код.

Предварительные требования

• Установлен Node.js 18+ (скачать)

• Установлен Claude Desktop (скачать)

Нужна видеоинструкция? Посмотрите Эпизод 3 на YouTube или прочитайте пошаговое руководство на 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 → Settings → Developer → Edit Config.

Добавьте это в ваш 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, который не рассматривается в этой версии.

Пример автоматизации закрытия месяца

Вот последовательность, которую выполнит ИИ-агент для автоматизации закрытия месяца:

1. Проверка текущего периода: get_substitution_variables видит CurrMonth = "Mar"

2. Запуск агрегации: run_business_rule с "Agg_AllData"

3. Ожидание завершения: check_job_status с возвращенным ID задания

4. Проверка данных: export_data_slice для Revenue, COGS, Net Income

5. Перенос периода: update_substitution_variable CurrMonth с "Mar" на "Apr"

6. Подтверждение: get_substitution_variables проверяет, что CurrMonth = "Apr"

Это тот же рабочий процесс, который финансовая команда выполняет вручную каждый месяц. Теперь он доступен через естественный язык.

Устранение неполадок

Что дальше

• Поддержка OAuth 2.0 для сред с включенной MFA

• Инструменты для FCCS: консолидация, исключение внутригрупповых оборотов

• Инструменты интеграции данных: загрузка и выгрузка файлов через Migration API

• Выполнение Groovy-правил: запуск Groovy-скриптов через REST API

О проекте

Этот сервер является частью серии материалов о подключении ИИ-агентов к Oracle EPM Cloud. Больше контента, руководств и инструментов по Oracle EPM:

• Обзорная статья: Как подключить Claude AI к Oracle EPM Cloud

• Руководство по настройке: Как настроить ИИ-агента для Oracle EPM Cloud, пошагово

• Все идеи и статьи: fmepm.com/insights

• YouTube-канал: @fmepm

• Веб-сайт: fmepm.com

• LinkedIn: Фред Мамаджанов

Работаете с Oracle EPM и хотите обсудить интеграцию ИИ? Запишитесь на ознакомительный звонок.

Это не продукт Oracle. Oracle EPM Cloud является торговой маркой Oracle Corporation.