Сервер Oracle EPM Cloud MCP

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

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

Что это дает

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

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

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

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

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

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

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

Архитектура

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 — это самая распространенная ошибка №1. Если вы получаете ошибки 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:

• Видео-обзор: Создание ИИ-агента для Oracle EPM Cloud

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

• YouTube: @fmepm

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

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