Optimacros

Model Context Protocol · версия 1.5.0

Optimacros MCP Server

Подключает ИИ-агентов к структуре, метаданным и бизнес-контексту моделей Optimacros с сохранением персональных прав пользователя.

Как подключиться

Подходит любой MCP-клиент с транспортом Streamable HTTP и авторизацией по токену (Bearer). Клиентам, которые умеют только устаревший HTTP+SSE — Yandex AI Responses и часть готовых агентов, — тот же каталог доступен на /sse.

2

Добавьте MCP-сервер

Укажите адрес подключения и выберите транспорт Streamable HTTP.

3

Проверьте инструменты

После подключения клиент должен обнаружить двадцать инструментов.

URL: https://mcp.optimacros.com/mcp
Transport: Streamable HTTP
Authorization: Bearer <OPTIMACROS_NAMED_TOKEN>
Именованный токен хранится в секретном хранилище MCP-клиента. Не вставляйте его в промт, параметры инструментов, конфигурацию репозитория или логи.

Примеры для ИИ-клиентов

Выберите свой клиент, добавьте адрес подключения и передайте именованный токен через защищённое поле или переменную окружения.

Yandex AI Studio Интерфейс

Откройте MCP servers, нажмите Create MCP server → Connect и заполните:

Transport: Streamable HTTP
URL: https://mcp.optimacros.com/mcp
Authorization type: Access token
Value: Bearer <OPTIMACROS_NAMED_TOKEN>

После подключения выберите все двадцать инструментов и добавьте сервер к агенту.

Документация Yandex AI Studio →

Codex config.toml

Задайте токен в переменной окружения OPTIMACROS_NAMED_TOKEN, затем добавьте в ~/.codex/config.toml:

[mcp_servers.optimacros]
url = "https://mcp.optimacros.com/mcp"
bearer_token_env_var = "OPTIMACROS_NAMED_TOKEN"
enabled = true

Перезапустите Codex и проверьте сервер командой /mcp или codex mcp list.

Документация Codex MCP →

Claude Code .mcp.json

Задайте токен в переменной окружения и добавьте локальную или проектную конфигурацию:

{
  "mcpServers": {
    "optimacros": {
      "type": "http",
      "url": "https://mcp.optimacros.com/mcp",
      "headers": {
        "Authorization": "Bearer ${OPTIMACROS_NAMED_TOKEN}"
      }
    }
  }
}

В Claude Code выполните /mcp и убедитесь, что обнаружено двадцать инструментов.

Документация Claude Code MCP →

Google Antigravity mcp_config.json

Откройте Manage MCP Servers → View raw config и добавьте удалённый сервер:

{
  "mcpServers": {
    "optimacros": {
      "serverUrl": "https://mcp.optimacros.com/mcp",
      "headers": {
        "Authorization": "Bearer <OPTIMACROS_NAMED_TOKEN>"
      }
    }
  }
}

Используйте именно serverUrl. Конфигурация должна оставаться локальной и не попадать в Git.

Документация Antigravity MCP →
Не используйте токен из примеров буквально. Создайте отдельный именованный токен с минимально необходимым сроком действия и храните его только в защищённой конфигурации выбранного клиента.

Готовые промпты для первого диалога

Пользователь работает с привычными бизнес-названиями. MCP сам находит технические идентификаторы и сохраняет выбранный контекст в текущем диалоге.

Первый запрос

Посмотреть доступные модели

Укажите адрес рабочей области и начните без технических идентификаторов.

Готовый промпт
Используй Optimacros MCP.

Рабочая область: <WORKSPACE_HOST>.

Какие модели мне доступны?
Знакомство

Познакомиться с моделью

Название можно указать так, как его видит бизнес-пользователь.

Готовый промпт
Используй Optimacros MCP.

Рабочая область: <WORKSPACE_HOST>.
Модель: <НАЗВАНИЕ МОДЕЛИ>.

Расскажи, какие разделы и данные есть в этой модели.
Поиск данных

Найти нужный раздел

Продолжите диалог после выбора модели.

Продолжение диалога
В выбранной модели найди раздел, где находятся данные по выручке.

Объясни его назначение и основные измерения простыми словами.
Аналитика

Получить краткое саммари

Агент использует ранее выбранные рабочую область, модель и раздел.

Продолжение диалога
Покажи небольшой срез ключевых показателей выбранного раздела.

Кратко объясни, что видно в данных, и отметь возможные отклонения.
Важно: пользователю не нужно искать ID. Если название неоднозначно, агент покажет понятный список вариантов и попросит выбрать нужный объект.

Двадцать инструментов

Каждый инструмент принимает точное DNS-имя рабочего пространства Optimacros и выполняется с правами текущего пользователя.

list_models

Показывает доступные онлайн-модели.

get_model_structure

Возвращает мультикубы и измерения модели.

find_multicube

Находит мультикуб по точному имени или longId.

list_dimension_members

Возвращает элементы измерения с любой позиции, каждый один раз, и их общее число total; продолжение — через nextOffset.

read_dimension_items

Читает таблицу справочника: Item Name, код, родитель, уровень, значения свойств и подмножества элементов, с отбором. Формульные свойства читаются только по явному запросу.

list_multicube_line_items

Возвращает показатели мультикуба, каждый один раз, и их общее число total.

list_hierarchy_properties

Описывает свойства и формулы справочника, без значений. Значения отдаёт read_dimension_items.

list_hierarchy_subsets

Показывает выборки справочника.

describe_multicube_business_logic

Объясняет бизнес-контекст мультикуба.

explain_dimension

Объясняет назначение и состав измерения.

preview_cube_slice

Возвращает подписанный срез любого размера со своей раскладкой строк, колонок и фильтров, независимо от сохранённой вьюшки. Отбор по элементам, подмножествам и булевым показателям выполняет Optimacros, отбор по значениям — сервер MCP; ответ показывает, что где выполнялось.

list_dashboards

Показывает дашборды модели и их состав.

describe_dashboard

Рассказывает, что на дашборде: таблицы, фильтры и кнопки.

preview_dashboard_table

Отдаёт таблицу дашборда как в интерфейсе — с подписями и заливкой.

explain_calculation

Показывает, из чего складывается цифра: формулы, источники и слои.

explain_script

Объясняет, что делает скрипт модели и какая кнопка его запускает.

model_map_status

Сообщает готовность карты модели: кубы, скрипты, дашборды.

find_in_model

Ищет объект по имени сразу среди кубов, справочников, скриптов и дашбордов.

where_used

Показывает, где объект используется и что сломается при изменении.

model_issues

Находит в модели битые ссылки и подозрительные места.

Границы и безопасность

Optimacros остаётся источником истины для данных и прав доступа.

Безопасный режим работы

  • читать структуру и метаданные моделей;
  • получать ограниченные списки элементов;
  • анализировать бизнес-контекст;
  • получать срезы и таблицы любого размера — сервер догружает их порциями;
  • работать только с доступными пользователю моделями.