Umami MCP

npx add-mcp 'https://cloud.umami.is/mcp'

@umami/mcp

Model Context Protocol сервер для Umami аналитики. Позволяет Claude, ChatGPT, Cursor и другим MCP-клиентам отвечать на вопросы о трафике вашего сайта с помощью инструментов только для чтения, которые обращаются к API Umami через @umami/api-client.

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

Инструменты

Инструмент	Назначение
list_websites	Найдите сайты, к которым у вас есть доступ (вызовите первым, чтобы получить websiteId).
get_website_daterange	Самая ранняя и самая поздняя даты с записанными данными.
get_website_stats	Просмотры страниц, посетители, визиты, показатель отказов, длительность + предыдущий период.
get_website_traffic	Временной ряд просмотров страниц/визитов по минутам, часам, дням, месяцам или годам.
get_website_metrics	Топ страниц, рефереров, каналов, стран, браузеров, устройств, UTM, событий.
get_realtime	Посетители, активные прямо сейчас.
get_events	Отдельные отслеживаемые события (с пагинацией).
get_event_stats	Итоги по пользовательским событиям + предыдущий период.
get_event_series	Количество пользовательских событий за время, сгруппированное по названию события.
get_event_properties	Названия свойств пользовательских событий или значения одного свойства.
get_sessions	Сессии посетителей (с пагинацией).
get_session_stats	Итоги на уровне сессий: посетители, визиты, просмотры страниц, события, страны.
get_annotations	Датированные заметки на временной шкале (запуски, кампании) для объяснения изменений.
list_segments	Сохранённые сегменты и когорты; передавайте ID через filters.segment / .cohort.
get_session	Одна сессия с её временной шкалой активности и свойствами.
list_funnels	Сохранённые воронки с их шагами (получите funnelId для run_funnel).
run_funnel	Воронка конверсии из сохранённого funnelId или ad-hoc шагов страниц/событий.
get_goals	Сохранённые цели с конверсиями, посетителями и показателем за период.
run_journey	Самые распространённые пути, которые проходят посетители.
run_retention	Таблица удержания когорт.
run_attribution	Атрибуция первого/последнего клика для конверсии.
get_revenue	Итоги по выручке, ряды и разбивки.
get_performance	Core Web Vitals (LCP, INP, CLS, FCP, TTFB) процентили, тренд, разбивка.

Все инструменты доступны только для чтения. Даты указаны в формате ISO 8601; результаты разбиты на страницы с жёстким ограничением размера страницы.

Удалённо: Umami Cloud

Подключитесь к https://cloud.umami.is/mcp используя ваш существующий ключ Cloud API:

Authorization: Bearer api_<your-cloud-api-key>

Клиенты, поддерживающие пользовательские заголовки, могут использовать x-umami-api-key вместо этого. Если указаны оба заголовка, они должны содержать один и тот же ключ. Используйте клиент, поддерживающий настройку API-ключа или bearer-заголовка.

Cloud MCP имеет те же требования к подписке и права доступа к сайтам/командам, что и Cloud API. Все инструменты обращаются к шлюзу Cloud API, который проверяет ключ и маршрутизирует запросы в ваш регион.

Удалённо: самостоятельный хостинг

Создайте ключ API в разделе Настройки → Ключи API в вашем экземпляре Umami, затем настройте вашего MCP-клиента с помощью конечной точки Streamable HTTP:

https://your-umami.example.com/mcp

Установите заголовок авторизации, используя ваш ключ:

Authorization: Bearer umami_<your-api-key>

Используйте клиент, поддерживающий bearer-токены или пользовательские заголовки авторизации. Конечная точка принимает ключи API самостоятельного хостинга; токены входа в браузере не поддерживаются. Инструменты доступны только для чтения и учитывают существующие права пользователя/команды владельца ключа. Отзовите ключ в настройках, чтобы отключить доступ. MCP отключён по умолчанию. Установите MCP_ENABLED=1 чтобы включить конечную точку.

Локально / stdio

{
  "mcpServers": {
    "umami": {
      "command": "npx",
      "args": ["-y", "@umami/mcp"],
      "env": {
        "UMAMI_URL": "https://analytics.example.com",
        "UMAMI_API_TOKEN": "umami_…"
      }
    }
  }
}

Переменная	Описание
UMAMI_URL	URL экземпляра самостоятельного хостинга (добавляется /api).
UMAMI_API_URL	Полный базовый URL API вместо этого, например https://api.umami.is/v1.
UMAMI_API_TOKEN	Ключ API или токен входа (самостоятельный хостинг).
UMAMI_API_KEY	Ключ Umami Cloud API.

Для Cloud stdio установите UMAMI_API_KEY и опустите UMAMI_URL и UMAMI_API_TOKEN:

{
  "mcpServers": {
    "umami": {
      "command": "npx",
      "args": ["-y", "@umami/mcp"],
      "env": { "UMAMI_API_KEY": "api_<your-cloud-api-key>" }
    }
  }
}

Примеры запросов

• Покажи мои сайты.
• Сколько посетителей было на example.com на прошлой неделе?
• Какие были топ-10 страниц в этом месяце?
• Сравни трафик этого месяца с предыдущим.
• Откуда приходит трафик?
• Какие события регистрации произошли вчера?
• Покажи сессии для пользователя abc123.
• Какие тарифные планы выбирали люди в событии оформления заказа в прошлом месяце?
• Сколько событий регистрации срабатывало каждый день на этой неделе?
• Запусти мою воронку оформления заказа за прошлый месяц.
• Как у нас дела с целями в этом квартале?
• Какие страницы имеют худший LCP на мобильных устройствах?
• Что произошло в день, когда трафик резко вырос?

Программное использование

import { UmamiClient } from '@umami/api-client';
import { createUmamiMcpServer } from '@umami/mcp';

const server = createUmamiMcpServer({
  client: new UmamiClient({ baseUrl, token }),
});

createUmamiMcpHttpHandler({ createClient }) возвращает обработчик Streamable HTTP для встраивания в любой веб-фреймворк; хост проверяет bearer-токен и передаёт authInfo.