Добавить сервер
mikusnuz/umami-mcp
  1. Каталог MCP
  2. mikusnuz/umami-mcp

mikusnuz/umami-mcp

от mikusnuz
MCP сервер для Umami Analytics с полным покрытием API v2. Включает 66 инструментов: от управления сайтами до реалтайм-мониторинга и администрирования пользователей. Подходит для автоматизации веб-аналитики через ИИ-помощников.
GithubNPMСайт сервера

English | 한국어

umami-mcp

Model Context Protocol server for the Umami Analytics v3 API. It supports self-hosted username/password or API-key authentication and Umami Cloud API keys, and exposes analytics, collection, administration, and v3 feature families such as boards, links, pixels, segments, session replay, shares, exports, performance, and revenue.

This version intentionally does not claim every private Umami route. Its tools track the documented API, including Umami 3.4 API-key authentication. Report tools use the legacy report contracts that Umami 3.4 continues to support.

Requirements

  • Node.js 18 or newer
  • Umami v3.3-compatible self-hosted instance (3.4+ for API keys), or Umami Cloud

Installation

npm install -g @mikusnuz/umami-mcp

Or run it directly:

npx -y @mikusnuz/umami-mcp

Configuration

Self-hosted
{
  "mcpServers": {
    "umami": {
      "command": "npx",
      "args": ["-y", "@mikusnuz/umami-mcp"],
      "env": {
        "UMAMI_URL": "https://analytics.example.com",
        "UMAMI_USERNAME": "admin",
        "UMAMI_PASSWORD": "your-password"
      }
    }
  }
}
Инструменты были проиндексированы:
add_team_user

Добавить пользователя в команду

Параметры
  • roleenumобязательный

    Роль в команде

  • teamIdstringобязательный

    UUID команды

  • userIdstringобязательный

    UUID пользователя для добавления

batch_events

Отправляет несколько событий или просмотров страниц в одном пакетном запросе.

Параметры
  • eventsobject[]обязательный

    Массив событий для отправки.

cancel_two_factor_setup

Отменяет незавершённую настройку 2FA в self-hosted Umami

Параметры

Без параметров.

clone_board

Клонирует доску Umami

Параметры
  • boardIdstringобязательный
  • descriptionstring
  • namestring
  • parametersobject
complete_two_factor_login

Завершает ожидающий вход в self-hosted Umami после того, как инструмент сообщает, что требуется 2FA.

Параметры
  • codestringобязательный

    Шестизначный код TOTP или резервный код

  • methodenumобязательный

    Метод проверки

confirm_two_factor_setup

Подтверждает настройку 2FA в self-hosted Umami и получает одноразовые резервные коды.

Параметры
  • tokenstringобязательный
create_board

Создаёт доску Umami

Параметры
  • descriptionstring
  • namestringобязательный
  • parametersobject
  • teamIdstring
  • typeenumобязательный
create_link

Создаёт отслеживаемую ссылку

Параметры
  • namestringобязательный
  • slugstringобязательный
  • teamIdstring
  • urlstringобязательный
create_pixel

Создаёт пиксель отслеживания

Параметры
  • namestringобязательный
  • slugstringобязательный
  • teamIdstring
create_report

Создать и сохранить новый отчёт

Параметры
  • descriptionstring

    Описание отчёта

  • namestringобязательный

    Название отчёта

  • parametersobjectобязательный

    Параметры, специфические для отчета (JSON-объект).

  • typeenumобязательный

    Тип отчёта

  • websiteIdstringобязательный

    UUID веб-сайта

create_segment

Создаёт сохранённый сегмент или когорту.

Параметры
  • namestringобязательный
  • parametersobjectобязательный
  • typeenumобязательный
  • websiteIdstringобязательный
create_share

Создаёт общий доступ для сайта, ссылки, пикселя или доски.

Параметры
  • entityIdstringобязательный
  • namestringобязательный
  • parametersobject
  • shareTypeenumобязательный
  • slugstring
create_team

Создать новую команду

Параметры
  • namestringобязательный

    Название команды

create_user

Создать нового пользователя (только для администратора)

Параметры
  • passwordstringобязательный

    Пароль для нового пользователя

  • roleenumобязательный

    Роль пользователя

  • usernamestringобязательный

    Имя пользователя для нового пользователя

create_website

Создать новый сайт для отслеживания в Umami

Параметры
  • domainstringобязательный

    Домен сайта (например, 'example.com')

  • namestringобязательный

    Отображаемое имя для веб-сайта.

  • shareIdstring

    Уникальный идентификатор общего ресурса для публичного доступа

  • teamIdstring

    Создаёт веб-сайт в этой команде.

create_website_share

Создаёт общий доступ к сайту

Параметры
  • namestringобязательный
  • parametersobject
  • websiteIdstringобязательный
delete_board

Удаляет доску Umami.

Параметры
  • boardIdstringобязательный
delete_link

Удаляет отслеживаемую ссылку

Параметры
  • linkIdstringобязательный
delete_pixel

Удаляет пиксель отслеживания

Параметры
  • pixelIdstringобязательный
delete_report

Удалить сохранённый отчёт

Параметры
  • reportIdstringобязательный

    UUID отчёта для удаления

delete_segment

Удаляет сохранённый сегмент или когорту

Параметры
  • segmentIdstringобязательный
  • websiteIdstringобязательный
delete_session

Удаляет одну сессию (только для реляционного хранилища при самостоятельном размещении).

Параметры
  • sessionIdstringобязательный
  • websiteIdstringобязательный
delete_share

Удаляет управляемый общий ресурс.

Параметры
  • shareIdstringобязательный
delete_team

Удалить команду

Параметры
  • teamIdstringобязательный

    UUID команды для удаления

delete_user

Удалить пользователя (только для администратора)

Параметры
  • userIdstringобязательный

    UUID пользователя для удаления.

delete_website

Удалить сайт из Umami

Параметры
  • websiteIdstringобязательный

    UUID веб-сайта для удаления

disable_two_factor

Отключает 2FA в self-hosted Umami, когда политика разрешает.

Параметры
  • passwordstringобязательный
  • tokenstringобязательный
export_website

Экспортирует аналитику сайта в виде ZIP-архива с CSV-файлами, закодированного в base64

Параметры
  • endAtintegerобязательный
  • pageinteger
  • pageSizeinteger
  • startAtintegerобязательный
  • websiteIdstringобязательный
get_active_visitors

Получить количество активных посетителей на сайте

Параметры
  • websiteIdstringобязательный

    UUID веб-сайта

get_board

Получает доску Umami.

Параметры
  • boardIdstringобязательный
get_daterange

Получить диапазон дат доступных данных для веб-сайта

Параметры
  • websiteIdstringобязательный

    UUID веб-сайта

get_event_data_by_id

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

Параметры
  • eventIdstringобязательный

    Идентификатор события

  • websiteIdstringобязательный

    UUID веб-сайта

get_event_data_events

Получить данные о событиях: события (пользовательские названия событий и их количество) для веб-сайта

Параметры
  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • eventstring

    Фильтрует по имени события.

  • filtersobject

    Дополнительные текущие поля фильтра Umami

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • websiteIdstringобязательный

    UUID веб-сайта

get_event_data_fields

Получить поля данных событий (ключи свойств и их типы данных) для веб-сайта

Параметры
  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • eventNamestring

    Фильтрует по имени события.

  • filtersobject

    Дополнительные текущие поля фильтра Umami

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • websiteIdstringобязательный

    UUID веб-сайта

get_event_data_properties

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

Параметры
  • endAtintegerобязательный

    Конечная метка времени в миллисекундах

  • filtersobject

    Дополнительные текущие поля фильтра Umami

  • startAtintegerобязательный

    Начальная временная метка в миллисекундах

  • websiteIdstringобязательный

    UUID веб-сайта

get_event_data_stats

Получить статистику данных событий (суммарные подсчеты) для сайта

Параметры
  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • eventstring

    Фильтрует по имени события.

  • filtersobject

    Дополнительные текущие поля фильтра Umami

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • websiteIdstringобязательный

    UUID веб-сайта

get_event_data_values

Получить значения данных событий (агрегированные количества для конкретного свойства) для веб-сайта

Параметры
  • dataTypeinteger

    Необязательный код типа данных Umami

  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • eventNamestring

    Фильтрует по имени события.

  • filtersobject

    Дополнительные текущие поля фильтра Umami

  • propertyNamestringобязательный

    Имя свойства для агрегации

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • websiteIdstringобязательный

    UUID веб-сайта

get_events

Выводит строки событий для сайта с текущими фильтрами и пагинацией Umami v3

Параметры
  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • eventstring

    Фильтрует по имени события.

  • filtersobject

    Дополнительные фильтры Umami v3, такие как страна, устройство, браузер, тег, поля UTM, сегмент или когорта

  • maxResultsinteger
  • pageinteger
  • pageSizeinteger
  • pathstring

    Фильтрует по пути URL.

  • searchstring

    Поиск по свободному тексту.

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • websiteIdstringобязательный

    UUID веб-сайта

get_event_series

Получить метрики событий во времени (данные временных рядов событий) для веб-сайта

Параметры
  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • eventstring

    Фильтрует по имени события.

  • filtersobject

    Дополнительные фильтры Umami v3, такие как страна, устройство, браузер, тег, поля UTM, сегмент или когорта

  • limitinteger
  • pathstring

    Фильтрует по пути URL.

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • timezonestringобязательный

    Часовой пояс IANA (например, 'Asia/Seoul')

  • unitenum

    Единица группировки времени, которую поддерживает Umami v3

  • websiteIdstringобязательный

    UUID веб-сайта

get_event_values

Получает значения свойств событий или сессий для веб-сайта.

Параметры
  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • filtersobject

    Дополнительные текущие поля фильтра Umami

  • searchstring

    Значения, возвращённые поиском

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • typeenumобязательный

    Измерение свойства, значения которого нужно вернуть

  • websiteIdstringобязательный

    UUID веб-сайта

get_link

Получает отслеживаемую ссылку

Параметры
  • linkIdstringобязательный
get_link_charts

Получает данные диаграммы максимум для 20 отслеживаемых ссылок.

Параметры
  • endAtinteger
  • linkIdsstring[]обязательный
  • startAtinteger
  • timezonestring
get_me

Получить информацию профиля текущего аутентифицированного пользователя

Параметры

Без параметров.

get_metrics

Получает агрегированные метрики для сайта (например, топ страниц, браузеры, страны, устройства, ОС, события).

Параметры
  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • filtersobject

    Дополнительные фильтры Umami v3, такие как страна, устройство, браузер, тег, поля UTM, сегмент или когорта

  • limitnumber

    Максимум результатов для возврата (1–20, по умолчанию 10)

  • offsetinteger
  • pathstring

    Фильтрует по пути URL.

  • referrerstring

    Фильтрует по рефереру.

  • searchstring

    Ищет значения метрик

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • typeenumобязательный

    Тип метрики для агрегации

  • websiteIdstringобязательный

    UUID веб-сайта

get_my_teams

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

Параметры
  • orderBystring

    Поле сортировки

  • pagenumber

    Номер страницы (начиная с 1)

  • pageSizenumber

    Результатов на странице (1-100)

  • sortDescendingboolean
get_my_websites

Получить список сайтов, принадлежащих текущему пользователю

Параметры
  • includeTeamsboolean

    Включает веб-сайты, доступные команде

  • orderBystring

    Поле сортировки

  • pagenumber

    Номер страницы (начиная с 1)

  • pageSizenumber

    Результатов на странице (1-100)

  • sortDescendingboolean
get_pageviews

Получает количество просмотров страниц и сеансов для веб-сайта с разбивкой по времени.

Параметры
  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • filtersobject

    Дополнительные фильтры Umami v3, такие как страна, устройство, браузер, тег, поля UTM, сегмент или когорта

  • pathstring

    Фильтрует по пути URL.

  • referrerstring

    Фильтрует по рефереру.

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • timezonestring

    Часовой пояс (например, 'Asia/Seoul')

  • unitenum

    Единица группировки времени, которую поддерживает Umami v3

  • websiteIdstringобязательный

    UUID веб-сайта

get_pixel

Получает пиксель отслеживания.

Параметры
  • pixelIdstringобязательный
get_pixel_charts

Получает данные графика для максимум 20 пикселей отслеживания.

Параметры
  • endAtinteger
  • pixelIdsstring[]обязательный
  • startAtinteger
  • timezonestring
get_realtime

Получить данные о сайте в реальном времени (за последние 30 минут). Возвращает текущих посетителей, активные URL, источники перехода, страны и события.

Параметры
  • countrystring
  • devicestring
  • eventstring
  • pathstring
  • timezonestring

    Часовой пояс IANA

  • unitenum
  • websiteIdstringобязательный

    UUID веб-сайта

get_recorder_config

Получает публичную конфигурацию рекордера session-replay и тепловых карт.

Параметры
  • websiteIdstringобязательный
get_replay

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

Параметры
  • chunkIndexinteger
  • eventIndexinteger
  • replayIdstringобязательный
  • untilinteger
  • websiteIdstringобязательный
get_replay_saved_status

Проверяет, сохранён ли один session replay.

Параметры
  • replayIdstringобязательный
  • websiteIdstringобязательный
get_report

Получить подробности конкретного сохранённого отчёта

Параметры
  • reportIdstringобязательный

    UUID отчёта

get_revenue_chart

Получает данные графика выручки

Параметры
  • compareenum
  • currencystringобязательный
  • endAtintegerобязательный
  • filtersobject

    Дополнительные текущие поля фильтра Umami, такие как path, event, country или segment

  • startAtintegerобязательный
  • timezonestring
  • unitenum
  • websiteIdstringобязательный
get_revenue_metrics

Получает метрики выручки в разрезе измерений.

Параметры
  • compareenum
  • currencystringобязательный
  • endAtintegerобязательный
  • filtersobject

    Дополнительные текущие поля фильтра Umami, такие как path, event, country или segment

  • startAtintegerобязательный
  • timezonestring
  • typeenumобязательный
  • unitenum
  • websiteIdstringобязательный
get_revenue_sessions

Перечисляет сессии с данными о выручке.

Параметры
  • compareenum
  • currencystringобязательный
  • endAtintegerобязательный
  • filtersobject

    Дополнительные текущие поля фильтра Umami, такие как path, event, country или segment

  • pageinteger
  • pageSizeinteger
  • searchstring
  • startAtintegerобязательный
  • timezonestring
  • unitenum
  • websiteIdstringобязательный
get_revenue_stats

Получает сводку по выручке и сравнение

Параметры
  • compareenum
  • currencystringобязательный
  • endAtintegerобязательный
  • filtersobject

    Дополнительные текущие поля фильтра Umami, такие как path, event, country или segment

  • startAtintegerобязательный
  • timezonestring
  • unitenum
  • websiteIdstringобязательный
get_segment

Получает сохранённый сегмент или когорту.

Параметры
  • segmentIdstringобязательный
  • websiteIdstringобязательный
get_session

Получить сведения о конкретной сессии

Параметры
  • sessionIdstringобязательный

    UUID сеанса

  • websiteIdstringобязательный

    UUID веб-сайта

get_session_activity

Получить журнал активности для конкретной сессии (посещённые страницы, вызванные события)

Параметры
  • distinctIdstring

    Необязательный связанный уникальный идентификатор

  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • sessionIdstringобязательный

    UUID сеанса

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • websiteIdstringобязательный

    UUID веб-сайта

get_session_data_properties

Получить имена свойств данных сессии и их типы данных для веб-сайта

Параметры
  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • filtersobject

    Дополнительные текущие поля фильтра Umami

  • propertyNamestring

    Необязательное имя свойства

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • websiteIdstringобязательный

    UUID веб-сайта

get_session_data_values

Получить значения данных сессии (агрегированные подсчеты для свойств сессии) для веб-сайта

Параметры
  • dataTypeinteger

    Необязательный код типа данных Umami

  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • filtersobject

    Дополнительные поля текущего фильтра Umami.

  • propertyNamestring

    Фильтрует по имени свойства.

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • websiteIdstringобязательный

    UUID веб-сайта

get_session_properties

Получить пользовательские свойства, прикреплённые к конкретной сессии.

Параметры
  • sessionIdstringобязательный

    UUID сеанса

  • websiteIdstringобязательный

    UUID веб-сайта

get_sessions

Получить данные сессии для сайта

Параметры
  • distinctIdstring

    Фильтрует по уникальному ID

  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • filtersobject

    Дополнительные фильтры Umami v3, такие как страна, устройство, браузер, тег, поля UTM, сегмент или когорта

  • maxResultsinteger
  • pagenumber

    Номер страницы (начиная с 1)

  • pageSizenumber

    Результатов на странице (1-100)

  • pathstring

    Фильтрует по пути URL.

  • querystring

    Фильтрует по строке запроса URL

  • searchstring

    Поиск сессий по свободному тексту

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • websiteIdstringобязательный

    UUID веб-сайта

get_session_stats

Получает сводную статистику сессий для сайта (общее количество сессий, уникальных посетителей и т.д.).

Параметры
  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • filtersobject

    Дополнительные фильтры Umami v3, такие как страна, устройство, браузер, тег, поля UTM, сегмент или когорта

  • pathstring

    Фильтрует по пути URL.

  • referrerstring

    Фильтрует по рефереру.

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • websiteIdstringобязательный

    UUID веб-сайта

get_sessions_weekly

Получить еженедельные данные о сессиях для веб-сайта

Параметры
  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • filtersobject

    Дополнительные фильтры Umami v3, такие как страна, устройство, браузер, тег, поля UTM, сегмент или когорта

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • timezonestringобязательный

    Часовой пояс IANA (например, 'Asia/Seoul')

  • websiteIdstringобязательный

    UUID веб-сайта

get_share

Определяет публичную ссылку Umami по её slug без аутентификации.

Параметры
  • slugstringобязательный

    Slug публичного доступа

get_share_by_id

Получает управляемый общий ресурс по внутреннему ID.

Параметры
  • shareIdstringобязательный
get_stats

Получить сводную статистику для веб-сайта (pageviews, visitors, visits, bounces, totaltime)

Параметры
  • endAtnumberобязательный

    Конечная метка времени в миллисекундах

  • eventstring

    Фильтрует по имени события.

  • filtersobject

    Дополнительные фильтры Umami v3, такие как страна, устройство, браузер, тег, поля UTM, сегмент или когорта

  • hostnamestring

    Фильтрует по имени хоста.

  • pathstring

    Фильтрует по пути URL.

  • referrerstring

    Фильтрует по рефереру.

  • segmentstring

    UUID сохранённого сегмента

  • startAtnumberобязательный

    Начальная временная метка в миллисекундах

  • websiteIdstringобязательный

    UUID веб-сайта

get_team

Получить подробности о конкретной команде

Параметры
  • teamIdstringобязательный

    UUID команды

get_team_user

Получить сведения о конкретном участнике команды

Параметры
  • teamIdstringобязательный

    UUID команды

  • userIdstringобязательный

    UUID пользователя

get_two_factor_status

Получает статус 2FA для самостоятельно размещённого Umami

Параметры

Без параметров.

get_user

Получить сведения о конкретном пользователе (только для администраторов)

Параметры
  • userIdstringобязательный

    UUID пользователя

get_user_teams

Получить список команд, в которых состоит пользователь (только для администратора)

Параметры
  • orderBystring
  • pagenumber

    Номер страницы (начиная с 1)

  • pageSizenumber

    Результатов на странице (1-100)

  • sortDescendingboolean
  • userIdstringобязательный

    UUID пользователя

get_user_two_factor_status

Получает статус подключения 2FA у пользователя (только для администратора self-hosted)

Параметры
  • userIdstringобязательный
get_user_websites

Получить список сайтов, к которым у пользователя есть доступ (только для администратора)

Параметры
  • includeTeamsboolean
  • orderBystring
  • pagenumber

    Номер страницы (начиная с 1)

  • pageSizenumber

    Результатов на странице (1-100)

  • searchstring

    Поисковый запрос для фильтрации сайтов.

  • sortDescendingboolean
  • userIdstringобязательный

    UUID пользователя

get_website

Получает детали конкретного веб-сайта по ID.

Параметры
  • websiteIdstringобязательный

    UUID веб-сайта

get_website_charts

Получает данные графиков не более чем для 20 сайтов

Параметры
  • endAtinteger
  • startAtinteger
  • timezonestring
  • websiteIdsstring[]обязательный
get_website_reports

Получить все отчёты, связанные с конкретным веб-сайтом

Параметры
  • websiteIdstringобязательный

    UUID веб-сайта

heartbeat

Проверяет, запущен ли сервер Umami и исправен ли он.

Параметры

Без параметров.

initiate_two_factor_setup

Запускает настройку 2FA в self-hosted Umami

Параметры

Без параметров.

join_team

Присоединиться к команде по коду доступа

Параметры
  • accessCodestringобязательный

    Код доступа/приглашения для команды.

list_admin_teams

Перечисляет все команды (только для администратора self-hosted)

Параметры
  • orderBystring
  • pageinteger
  • pageSizeinteger
  • searchstring
  • sortDescendingboolean
list_admin_websites

Перечисляет все веб-сайты (только для администратора self-hosted)

Параметры
  • orderBystring
  • pageinteger
  • pageSizeinteger
  • searchstring
  • sortDescendingboolean
list_boards

Перечисляет доски Umami v3

Параметры
  • orderBystring
  • pageinteger
  • pageSizeinteger
  • searchstring
  • sortDescendingboolean
list_entity_shares

Выводит список репостов для сайта, ссылки, пикселя или доски.

Параметры
  • entityIdstringобязательный
  • entityTypeenumобязательный
  • pageinteger
  • pageSizeinteger
  • searchstring
list_links

Выводит список отслеживаемых ссылок.

Параметры
  • orderBystring
  • pageinteger
  • pageSizeinteger
  • searchstring
  • sortDescendingboolean
list_pixels

Перечисляет трекинговые пиксели.

Параметры
  • orderBystring
  • pageinteger
  • pageSizeinteger
  • searchstring
  • sortDescendingboolean
list_replays

Перечисляет записи сессий для веб-сайта.

Параметры
  • endAtintegerобязательный
  • filtersobject

    Дополнительные текущие поля фильтра Umami, такие как path, event, country или segment

  • minDurationinteger
  • pageinteger
  • pageSizeinteger
  • searchstring
  • startAtintegerобязательный
  • websiteIdstringобязательный
list_reports

Выводит список сохранённых отчётов для сайта.

Параметры
  • pagenumber

    Номер страницы (начиная с 1)

  • pageSizenumber

    Результатов на странице (1-100)

  • typeenum

    Необязательный фильтр по типу отчёта

  • websiteIdstringобязательный

    UUID веб-сайта

list_saved_replays

Перечисляет сохранённые записи сессий

Параметры
  • pageinteger
  • pageSizeinteger
  • searchstring
  • websiteIdstringобязательный
list_segments

Перечисляет сохранённые сегменты или когорты для сайта.

Параметры
  • searchstring
  • typeenumобязательный
  • websiteIdstringобязательный
list_session_replays

Перечисляет записи повторов, связанные с одной сессией.

Параметры
  • endAtintegerобязательный
  • pageinteger
  • pageSizeinteger
  • searchstring
  • sessionIdstringобязательный
  • startAtintegerобязательный
  • websiteIdstringобязательный
list_team_boards

Перечисляет доски, принадлежащие команде.

Параметры
  • orderBystring
  • pageinteger
  • pageSizeinteger
  • searchstring
  • sortDescendingboolean
  • teamIdstringобязательный
list_team_links

Выводит отслеживаемые ссылки, принадлежащие команде.

Параметры
  • orderBystring
  • pageinteger
  • pageSizeinteger
  • searchstring
  • sortDescendingboolean
  • teamIdstringобязательный
list_team_pixels

Перечисляет трекинговые пиксели, принадлежащие команде

Параметры
  • orderBystring
  • pageinteger
  • pageSizeinteger
  • searchstring
  • sortDescendingboolean
  • teamIdstringобязательный
list_teams

Вывести список всех команд

Параметры
  • orderBystring

    Поле для сортировки (например, 'name', 'createdAt')

  • pagenumber

    Номер страницы (начиная с 1)

  • pageSizenumber

    Результатов на странице (1-50). По умолчанию: 20.

  • sortDescendingboolean
list_team_users

Вывести список всех участников команды

Параметры
  • pagenumber

    Номер страницы (начиная с 1)

  • pageSizenumber

    Результатов на странице (1-100)

  • searchstring

    Поисковый запрос для фильтрации участников

  • teamIdstringобязательный

    UUID команды

list_team_websites

Выведи список всех сайтов, принадлежащих команде.

Параметры
  • orderBystring
  • pagenumber

    Номер страницы (начиная с 1)

  • pageSizenumber

    Результатов на странице (1-100)

  • searchstring

    Поисковый запрос для фильтрации сайтов.

  • sortDescendingboolean
  • teamIdstringобязательный

    UUID команды

list_users

Вывести список всех пользователей (только для администратора)

Параметры
  • orderBystring

    Поле для сортировки (например, 'username', 'createdAt')

  • pagenumber

    Номер страницы (начиная с 1)

  • pageSizenumber

    Результатов на странице (1-50). По умолчанию: 20.

  • searchstring

    Поисковый запрос для фильтрации пользователей

  • sortDescendingboolean
list_websites

Перечисли все сайты, отслеживаемые в Umami.

Параметры
  • includeTeamsboolean

    Включает веб-сайты, доступные команде

  • orderBystring

    Поле для сортировки (например, 'name', 'domain')

  • pagenumber

    Номер страницы (начиная с 1)

  • pageSizenumber

    Результатов на странице (1-50). По умолчанию: 20.

  • searchstring

    Поисковый запрос для фильтрации сайтов.

  • sortDescendingboolean
list_website_shares

Выводит список общих ресурсов, созданных для сайта.

Параметры
  • pageinteger
  • pageSizeinteger
  • searchstring
  • websiteIdstringобязательный
remove_team_user

Удалить пользователя из команды

Параметры
  • teamIdstringобязательный

    UUID команды

  • userIdstringобязательный

    UUID пользователя, которого нужно удалить.

reset_user_two_factor

Сбрасывает регистрацию 2FA и резервные коды пользователя (только для админа self-hosted версии)

Параметры
  • userIdstringобязательный
reset_website

Сбросить сайт, удалив все его аналитические данные (необратимо)

Параметры
  • websiteIdstringобязательный

    UUID веб-сайта для сброса

run_report

Выполняет текущий отчёт Umami v3 и возвращает его результат.

Параметры
  • filtersobject

    Текущий объект фильтра Umami; используйте {}, если фильтры не нужны

  • parametersobjectобязательный

    Параметры, специфичные для отчета (различаются в зависимости от типа).

  • typeenumобязательный

    Тип отчёта для запуска.

  • websiteIdstringобязательный

    UUID веб-сайта

send_event

Отправляет пользовательское событие или просмотр страницы в Umami (полезно для отслеживания на стороне сервера).

Параметры
  • distinctIdstring

    Стабильный идентификатор пользователя

  • eventDataobject

    Данные пользовательского события в виде пар ключ-значение

  • eventNamestring

    Название пользовательского события (не указывайте для просмотра страницы)

  • hostnamestringобязательный

    Имя хоста сайта (например, ‘example.com’)

  • ipstring

    IP-адрес клиента для доверенного сбора на стороне сервера

  • languagestring

    Язык браузера (например, 'en-US')

  • referrerstring

    URL реферера

  • screenstring

    Размеры экрана (например, 1920x1080)

  • tagstring

    Тег события

  • timestampinteger

    Метка времени Unix в секундах

  • titlestring

    Заголовок страницы

  • urlstringобязательный

    URL-путь (например, '/checkout')

  • userAgentstring

    Клиентский user agent

  • websiteIdstringобязательный

    UUID веб-сайта (используется как поле 'website' в payload)

send_identify

Прикрепляет пользовательские данные сессии или distinct ID через публичный collection API Umami.

Параметры
  • dataobjectобязательный

    Свойства сессии

  • distinctIdstring

    Ваш стабильный идентификатор пользователя

  • hostnamestring
  • urlstring
  • websiteIdstringобязательный

    UUID веб-сайта

send_link_or_pixel_event

Отправляет публичное событие сбора для отслеживаемой ссылки или пикселя

Параметры
  • dataobject
  • entityIdstringобязательный
  • entityTypeenumобязательный
  • hostnamestring
  • namestring
  • urlstring
send_performance

Отправляет Core Web Vitals через публичный API сбора Umami.

Параметры
  • clsnumber
  • fcpnumber
  • hostnamestringобязательный

    Имя хоста веб-сайта

  • inpnumber
  • lcpnumber
  • ttfbnumber
  • urlstringобязательный

    URL страницы или путь

  • websiteIdstringобязательный

    UUID веб-сайта

set_global_two_factor_requirement

Включает или отключает обязательное требование 2FA глобально (только для администратора self-hosted)

Параметры
  • requiredbooleanобязательный
set_replay_saved

Сохраняет или отменяет сохранение session replay (name используется при сохранении)

Параметры
  • isSavedbooleanобязательный
  • namestring
  • replayIdstringобязательный
  • websiteIdstringобязательный
set_team_two_factor_requirement

Делает 2FA обязательной для команды или снимает это требование (только для владельца или менеджера в self-hosted)

Параметры
  • requiredbooleanобязательный
  • teamIdstringобязательный
set_user_two_factor_requirement

Требует или перестаёт требовать 2FA для пользователя (только для администратора self-hosted)

Параметры
  • requiredbooleanобязательный
  • userIdstringобязательный
transfer_website

Переносит сайт пользователю или команде с помощью текущего эндпоинта transfer в Umami.

Параметры
  • destinationIdstringобязательный

    UUID целевого пользователя или команды

  • destinationTypeenumобязательный
  • websiteIdstringобязательный

    UUID веб-сайта для переноса

update_board

Обновляет доску Umami

Параметры
  • boardIdstringобязательный
  • descriptionstring
  • namestring
  • parametersobject
  • typeenum
update_link

Обновляет отслеживаемую ссылку

Параметры
  • linkIdstringобязательный
  • namestring
  • slugstring
  • urlstring
update_my_password

Обновляет пароль текущего пользователя (только для self-hosted Umami; облачные API-ключи не могут вызывать этот маршрут)

Параметры
  • currentPasswordstringобязательный

    Текущий пароль

  • newPasswordstringобязательный

    Новый пароль (минимум 8 символов)

update_pixel

Обновляет трекинговый пиксель.

Параметры
  • namestring
  • pixelIdstringобязательный
  • slugstring
update_report

Обновить существующий сохранённый отчёт

Параметры
  • descriptionstring

    Описание отчёта

  • namestringобязательный

    Название отчёта

  • parametersobjectобязательный

    Параметры, специфические для отчета (JSON-объект).

  • reportIdstringобязательный

    UUID отчёта

  • typeenumобязательный

    Тип отчёта

  • websiteIdstringобязательный

    UUID веб-сайта

update_segment

Обновляет сохранённый сегмент или когорту.

Параметры
  • namestringобязательный
  • parametersobjectобязательный
  • segmentIdstringобязательный
  • typeenumобязательный
  • websiteIdstringобязательный
update_share

Обновляет управляемый общий ресурс

Параметры
  • namestringобязательный
  • parametersobjectобязательный
  • shareIdstringобязательный
  • slugstringобязательный
update_team

Обновляет название команды или код доступа

Параметры
  • accessCodestring

    Новый код доступа

  • namestring

    Новое название команды.

  • teamIdstringобязательный

    UUID команды

update_team_user

Обновить роль участника команды

Параметры
  • roleenumобязательный

    Новая роль в команде

  • teamIdstringобязательный

    UUID команды

  • userIdstringобязательный

    UUID пользователя

update_user

Обновить имя пользователя, пароль или роль (только для администратора)

Параметры
  • passwordstring

    Новый пароль

  • roleenum

    Новая роль

  • userIdstringобязательный

    UUID пользователя

  • usernamestring

    Новое имя пользователя

update_website

Обнови конфигурацию существующего сайта.

Параметры
  • domainstring

    Новый домен

  • namestring

    Новое отображаемое имя

  • replayConfigobject

    Настройки сбора session replay и тепловых карт

  • shareIdstring | null

    Share ID (установите null, чтобы удалить)

  • websiteIdstringобязательный

    UUID веб-сайта

verify_auth

Проверяет валидность текущего токена аутентификации.

Параметры

Без параметров.

2.1.1основная
2.1.0
2.0.1
1.2.1
1.2.0
1.1.0
1.0.1
1.0.0

Выберите клиент, чтобы установить mikusnuz/umami-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "mikusnuz-umami-mcp-xnqsnqx4z2": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/umami-mcp"
      ],
      "env": {
        "UMAMI_URL": "https://analytics.example.com",
        "UMAMI_USERNAME": "admin",
        "UMAMI_PASSWORD": "your-password"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "mikusnuz-umami-mcp-xnqsnqx4z2": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/umami-mcp"
      ],
      "env": {
        "UMAMI_URL": "https://analytics.example.com",
        "UMAMI_USERNAME": "admin",
        "UMAMI_PASSWORD": "your-password"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "mikusnuz-umami-mcp-xnqsnqx4z2": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/umami-mcp"
      ],
      "env": {
        "UMAMI_URL": "https://analytics.example.com",
        "UMAMI_USERNAME": "admin",
        "UMAMI_PASSWORD": "your-password"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"mikusnuz-umami-mcp-xnqsnqx4z2\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@mikusnuz/umami-mcp\"],\"env\":{\"UMAMI_URL\":\"https://analytics.example.com\",\"UMAMI_USERNAME\":\"admin\",\"UMAMI_PASSWORD\":\"your-password\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

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

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "mikusnuz-umami-mcp-xnqsnqx4z2": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/umami-mcp"
      ],
      "env": {
        "UMAMI_URL": "https://analytics.example.com",
        "UMAMI_USERNAME": "admin",
        "UMAMI_PASSWORD": "your-password"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add mikusnuz-umami-mcp-xnqsnqx4z2 --env UMAMI_URL=https://analytics.example.com --env UMAMI_USERNAME=admin --env UMAMI_PASSWORD=your-password -- npx -y @mikusnuz/umami-mcp

Либо через JSON-конфиг:

claude mcp add-json mikusnuz-umami-mcp-xnqsnqx4z2 "{\"command\":\"npx\",\"args\":[\"-y\",\"@mikusnuz/umami-mcp\"],\"env\":{\"UMAMI_URL\":\"https://analytics.example.com\",\"UMAMI_USERNAME\":\"admin\",\"UMAMI_PASSWORD\":\"your-password\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add mikusnuz-umami-mcp-xnqsnqx4z2 --env UMAMI_URL=https://analytics.example.com --env UMAMI_USERNAME=admin --env UMAMI_PASSWORD=your-password -- npx -y @mikusnuz/umami-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.mikusnuz-umami-mcp-xnqsnqx4z2]
command = "npx"
args = ["-y", "@mikusnuz/umami-mcp"]

[mcp_servers.mikusnuz-umami-mcp-xnqsnqx4z2.env]
UMAMI_URL = "https://analytics.example.com"
UMAMI_USERNAME = "admin"
UMAMI_PASSWORD = "your-password"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите mikusnuz/umami-mcp, а в поле команды запуска — строку ниже:
npx -y @mikusnuz/umami-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "mikusnuz-umami-mcp-xnqsnqx4z2": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/umami-mcp"
      ],
      "env": {
        "UMAMI_URL": "https://analytics.example.com",
        "UMAMI_USERNAME": "admin",
        "UMAMI_PASSWORD": "your-password"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "mikusnuz-umami-mcp-xnqsnqx4z2": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/umami-mcp"
      ],
      "env": {
        "UMAMI_URL": "https://analytics.example.com",
        "UMAMI_USERNAME": "admin",
        "UMAMI_PASSWORD": "your-password"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например mikusnuz-umami-mcp-xnqsnqx4z2.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: mikusnuz-umami-mcp-xnqsnqx4z2
    command: npx
    args:
      - "-y"
      - "@mikusnuz/umami-mcp"
    env:
      UMAMI_URL: https://analytics.example.com
      UMAMI_USERNAME: admin
      UMAMI_PASSWORD: your-password
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "mikusnuz-umami-mcp-xnqsnqx4z2": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/umami-mcp"
      ],
      "env": {
        "UMAMI_URL": "https://analytics.example.com",
        "UMAMI_USERNAME": "admin",
        "UMAMI_PASSWORD": "your-password"
      }
    }
  }
}

Похожие MCP-сервера

meilisearch/meilisearch-mcp

meilisearch/meilisearch-mcp

от meilisearch

MCP сервер, подключающий любую LLM к поисковому движку Meilisearch. Создавайте и удаляйте индексы, загружайте документы, настраивайте релевантность — всё через естественный язык. Идеально для быстрого поиска в AI-помощниках.

Python⭐ 196
jeannier/homebrew-mcp

jeannier/homebrew-mcp

от jeannier

Homebrew MCP сервер для macOS: управляйте пакетами через ИИ-агентов. Полный набор инструментов для установки, поиска, обновления и диагностики Homebrew. Интегрируется с Claude Desktop и Cursor. Для...

Python⭐ 30
s-b-e-n-s-o-n/portkey-admin-mcp

s-b-e-n-s-o-n/portkey-admin-mcp

от s-b-e-n-s-o-n

MCP-сервер, открывающий 150 инструментов Portkey Admin API: управляйте промптами, конфигами, аналитикой, ключами и пользователями прямо из MCP-клиента. Идеален для разработчиков, автоматизирующих A...

TypeScript⭐ 6
WiseVision/mcp_server_ros_2

WiseVision/mcp_server_ros_2

от wise-vision

MCP сервер для ROS 2: читает и публикует топики, вызывает сервисы, управляет действиями. Включает промпты для анализа данных и мониторинга роботов. Ускоряет разработку и отладку с помощью AI.

Python⭐ 93
jordandalton/restcsv-mcp-server

jordandalton/restcsv-mcp-server

от jordandalton

Сервер для работы с CSV-данными через REST API: с ним AI-агенты (Claude, Cursor) могут читать, записывать и управлять таблицами как удалёнными ресурсами. Полезен для автоматизации аналитики и интеграции данных без загрузки файлов.

TypeScript⭐ 12
FileToPDF/filetopdf-mcp

FileToPDF/filetopdf-mcp

от filetopdf

MCP сервер для конвертации файлов, HTML и Markdown в PDF через естественный язык. Поддерживает DOCX, XLSX, PPTX, изображения и веб-страницы. Использует API FileToPDF (бесплатный ключ на 10 конверсий без регистрации). Подходит для создания счетов, отчетов и документации в любом MCP-клиенте (Claude...

TypeScript⭐ 2
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин