Oracle EPM Cloud MCP Server
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: bas-mcp-server
📺 Видеоуроки и полные статьи
Эпизод 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Доступные инструменты
Инструмент | Что он делает | EPM REST API |
| Проверка подключения, обнаружение версий API |
|
| Список всех приложений EPM |
|
| Чтение текущих переменных месяца, года, сценария |
|
| Выполнение calc-скрипта или бизнес-правила |
|
| Опрос статуса завершения или ошибки задания |
|
| Извлечение данных из куба по элементам измерений |
|
| Изменение значения переменной подстановки |
|
Установка
Два варианта. Выберите тот, который подходит вашему рабочему процессу.
Вариант А: Установка в один клик (рекомендуется)
Доступно в версии 2.0.0 и выше. Скачайте расширение для рабочего стола, установите его, готово. Никакого редактирования путей, никаких файлов конфигурации JSON.
Скачайте
oracle-epm-cloud-2.0.0.mcpbиз последнего релиза.Откройте Claude Desktop. Перейдите в Settings → Extensions → Advanced → Install Extension.
Выберите файл
.mcpb.Это всё. Режим имитации (mock mode) работает сразу. Для тестирования учетные данные Oracle не требуются.
Для рабочего режима (реальная среда EPM) настройте переменные окружения через настройки расширения в 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, который не рассматривается в этой версии.
Пример автоматизации закрытия месяца
Вот последовательность, которую выполнит ИИ-агент для автоматизации закрытия месяца:
Проверка текущего периода:
get_substitution_variablesвидит CurrMonth = "Mar"Запуск агрегации:
run_business_ruleс "Agg_AllData"Ожидание завершения:
check_job_statusс возвращенным ID заданияПроверка данных:
export_data_sliceдля Revenue, COGS, Net IncomeПеренос периода:
update_substitution_variableCurrMonth с "Mar" на "Apr"Подтверждение:
get_substitution_variablesпроверяет, что CurrMonth = "Apr"
Это тот же рабочий процесс, который финансовая команда выполняет вручную каждый месяц. Теперь он доступен через естественный язык.
Устранение неполадок
Ошибка | Причина | Решение |
Инструменты MCP не отображаются в Claude | Неверный путь к конфигурации | Проверьте, что путь в |
401 Unauthorized | Формат имени пользователя | Используйте |
403 Forbidden | Недостаточно прав | Пользователю нужны права администратора EPM или соответствующая роль |
Connection refused | Неверный URL | Проверьте, что |
ETIMEDOUT | Сеть/брандмауэр | Убедитесь, что вы можете получить доступ к URL EPM с вашего компьютера |
Что дальше
Поддержка 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.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Claude, connected to your own Oracle EPM. Each person as themselves, every call checked and logged.
Anaplan MCP server for ChatGPT, Claude and any AI agent: list models, list actions, upload import file, run import, run process, run export, get model history and add user in your own Anaplan account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Anaplan yourself; Cotlet does not store your password and you need no Anaplan API key. About the official Anaplan API: Yes. Anaplan has an official REST API, the Integration API v2.0, and an official MCP server, the Anaplan AI Gateway, but Anaplan's help says the AI Gateway gives external AI systems read-only access (checked 5 Nov 2026). Setup and FAQ: https://cotlet.dev/integrations/anaplan-api-mcp-server
Give AI agents 30,000+ safe, token-optimized actions across Workday, SAP, Oracle + hundreds more.
Personal finance, bank account, and shared memory connector for Claude, ChatGPT, Gemini Spark & more
Related MCP Servers
- AlicenseCqualityFmaintenanceEnables interaction with Oracle EPM Cloud Financial Consolidation and Close (FCCS) through 25+ tools covering REST API operations including jobs, dimensions, journals, data management, reports, and consolidation tasks.36MIT
- AlicenseAqualityDmaintenanceEnables AI agents to interact with 1С:Enterprise and BAS ERP systems through REST and HTTP services, providing tools for searching catalogs, creating documents, and querying stock balances.6ISC
- AlicenseAqualityCmaintenanceEnables AI agents to explore Oracle Fusion Cloud schema metadata, run pre-built BI Publisher reports with bind parameters, and validate results against trusted ground truth.401Apache 2.0
- AlicenseAqualityCmaintenanceEnables AI assistants to explore and report on Oracle-based ERP databases via read-only schema discovery, guarded ad-hoc SQL, and curated reports.5MIT