Glarus BI + Claude AI¶

Руководство по подключению MCP-сервера и работе с BI-аналитикой через Claude¶

Research Preview

1. Обзор решения¶

Glarus BI предоставляет MCP-сервер (Model Context Protocol), который позволяет подключить платформу бизнес-аналитики напрямую к Claude Desktop или Claude.ai. После подключения вы сможете управлять дашбордами, карточками, базами данных и визуализациями через естественный язык.

Что вы сможете делать:

Создавать SQL-запросы и карточки визуализаций (bar, line, scatter, pie, table, pivot)
Собирать дашборды с несколькими табами, заголовками и фильтрами
Настраивать стили графиков: цвета, оси, цели, тренды, условное форматирование
Выполнять аналитические SQL-запросы и получать данные в реальном времени
Управлять коллекциями, моделями и write-back actions

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

Компонент	Описание
Glarus BI	Развернутый экземпляр Glarus BI (v0.50+) с доступом администратора
API-ключ	Сгенерированный API-ключ Glarus BI с правами на нужные коллекции
Claude Desktop	Установленное приложение Claude Desktop (macOS / Windows) или доступ к Claude.ai
URL сервера	Адрес вашего экземпляра Glarus BI (например, https://bi.company.com)

3. Подключение MCP-сервера¶

Шаг 1. Получите API-ключ Glarus BI¶

Откройте Glarus BI и перейдите в Settings > Authentication > API Keys
Нажмите Create API Key и задайте имя (например, claude-mcp)
Скопируйте сгенерированный ключ — он понадобится на следующем шаге

Предупреждение

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

Шаг 2. Настройте Claude Desktop¶

Откройте файл конфигурации Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Добавьте блок MCP-сервера в секцию mcpServers:

{
  "mcpServers": {
    "glarusbi": {
      "command": "npx",
      "args": [
        "-y", "@anthropic/glarusbi-mcp-server"
      ],
      "env": {
        "GLARUSBI_URL": "https://your-instance.glarus-analytics.ru",
        "GLARUSBI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Шаг 3. Перезапустите Claude Desktop¶

Полностью закройте Claude Desktop (Quit, не просто закрытие окна)
Запустите приложение заново
В новом диалоге вы увидите иконку MCP-инструментов — это означает, что сервер подключен

4. Рабочий процесс¶

После подключения MCP-сервера вы можете давать Claude задачи на естественном языке. Ниже приведена типичная последовательность действий.

4.1. Исследование базы данных¶

Начните с изучения структуры данных:

"Покажи список баз данных" — Claude выведет все подключенные БД с их ID
"Покажи таблицы в базе 75" — список таблиц и схем
"Выполни запрос: SELECT DISTINCT type FROM table" — прямой SQL для разведки данных

4.2. Создание карточек (визуализаций)¶

Попросите Claude создать карточку с нужным типом визуализации:

"Создай bar chart населения по регионам за 2022 год"
"Построй line chart динамики доходов по топ-5 регионам"
"Сделай scatter plot: доходы vs покупательская способность"

Claude создаст SQL-запрос, выберет тип визуализации и сохранит карточку в указанной коллекции.

4.3. Сборка дашборда¶

"Создай дашборд «Аналитика регионов» в коллекции 1376"
"Добавь таб «Тренды» и размести на нём карточки 7282, 7283, 7284"
"Добавь заголовок «Обзор показателей» в начало таба"
"Добавь фильтр по году и привяжи его к карточкам"

4.4. Настройка стилей¶

Claude может настроить визуальное оформление:

Цвета графиков: "Установи зелёную палитру для bar chart"
Линии целей: "Добавь цель на 10 000 000"
Условное форматирование: "Подсвети красным ячейки со значением > 200"
Оси и подписи: "Настрой ось Y с форматом валюты"

5. Примеры команд¶

Команда	Что сделает Claude
Покажи список баз данных	Вызовет listGlarusBIDatabases
Выполни `SELECT count() FROM table`*	Выполнит SQL через executeGlarusBIQuery
Создай bar chart продаж по месяцам	Создаст карточку с SQL и визуализацией bar
Собери дашборд из карточек 101, 102	Создаст дашборд и разместит карточки
Добавь фильтр по дате на дашборд	Добавит параметр и привяжет к карточкам
Установи зелёную палитру	Обновит graph.colors в настройках
Покажи URL дашборда с фильтром 2022	Вернёт ссылку с параметрами

6. Рекомендации¶

Начинайте с разведки данных. Попросите Claude показать уникальные значения ключевых полей, прежде чем строить графики.
Указывайте ID коллекции. При создании карточек и дашбордов всегда уточняйте, в какую коллекцию сохранять результат.
Проверяйте регистр значений. В ClickHouse "Браки" и "браки" — разные значения. Используйте SELECT DISTINCT для проверки.
Используйте template-tags для фильтров. Карточки с параметрами {{year}}, {{region}} легко подключаются к фильтрам дашборда.
Итеративно улучшайте. Создайте базовый график, затем просите Claude добавить цели, тренды, цвета и форматирование.

Подсказка

Вы можете попросить Claude объяснить любой существующий график или дашборд — он выполнит запрос карточки и даст аналитическое описание данных с ключевыми выводами.