umami — MCP-сервер для Claude Code: что делает и как установить
Подключает Claude Code к Umami Analytics v3 для аналитики, событий, отчётов и управления сайтами. Пригодится для работы с данными через MCP.
claude mcp add --env UMAMI_MODE=<UMAMI_MODE> --env UMAMI_URL=<UMAMI_URL> --env UMAMI_COLLECTOR_URL=<UMAMI_COLLECTOR_URL> --env UMAMI_USERNAME=<UMAMI_USERNAME> --env UMAMI_PASSWORD=<UMAMI_PASSWORD> --transport stdio umami -- npx -y @mikusnuz/umami-mcpЧто делает umami
umami даёт агенту доступ к Umami Analytics v3. Сервер умеет получать статистику, просмотры страниц, события и сессии, запускать отчёты, работать с сайтами, досками, сегментами, ссылками, пикселями и данными о доходе. Также доступны сбор событий и некоторые публичные маршруты без авторизации.
Поддерживаются self-hosted-установки и Umami Cloud. Для self-hosted можно использовать логин и пароль или API-ключ, а для Cloud нужен API-ключ. Переменные UMAMI_URL, UMAMI_MODE, UMAMI_COLLECTOR_URL и учётные данные задаются при подключении MCP-сервера.
Сервер запускается через пакет @mikusnuz/umami-mcp с помощью npx. Без Node.js 20 или новее он не запустится. Для API-ключей, сегментов по свойствам сессии и аннотаций нужна версия Umami 3.4 или новее.
Какие задачи решает
- собрать статистику сайта из Umami
- получить просмотры страниц и данные о сессиях
- отправить события и данные производительности
- запустить отчёт по аналитике сайта
Примеры запросов агенту
- Покажи статистику сайта за выбранный период через Umami.
- Получи просмотры страниц и метрики для сайта с заданным
websiteId. - Запусти отчёт Umami по воронке или удержанию.
Как установить umami
Командой платформы
claude mcp add --env UMAMI_MODE=<UMAMI_MODE> --env UMAMI_URL=<UMAMI_URL> --env UMAMI_COLLECTOR_URL=<UMAMI_COLLECTOR_URL> --env UMAMI_USERNAME=<UMAMI_USERNAME> --env UMAMI_PASSWORD=<UMAMI_PASSWORD> --transport stdio umami -- npx -y @mikusnuz/umami-mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add umami --env UMAMI_MODE=<UMAMI_MODE> --env UMAMI_URL=<UMAMI_URL> --env UMAMI_COLLECTOR_URL=<UMAMI_COLLECTOR_URL> --env UMAMI_USERNAME=<UMAMI_USERNAME> --env UMAMI_PASSWORD=<UMAMI_PASSWORD> -- npx -y @mikusnuz/umami-mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"umami": {
"command": "npx",
"args": [
"-y",
"@mikusnuz/umami-mcp"
],
"env": {
"UMAMI_MODE": "<UMAMI_MODE>",
"UMAMI_URL": "<UMAMI_URL>",
"UMAMI_COLLECTOR_URL": "<UMAMI_COLLECTOR_URL>",
"UMAMI_USERNAME": "<UMAMI_USERNAME>",
"UMAMI_PASSWORD": "<UMAMI_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"umami": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mikusnuz/umami-mcp"
],
"env": {
"UMAMI_MODE": "<UMAMI_MODE>",
"UMAMI_URL": "<UMAMI_URL>",
"UMAMI_COLLECTOR_URL": "<UMAMI_COLLECTOR_URL>",
"UMAMI_USERNAME": "<UMAMI_USERNAME>",
"UMAMI_PASSWORD": "<UMAMI_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e UMAMI_MODE=<UMAMI_MODE> -e UMAMI_URL=<UMAMI_URL> -e UMAMI_COLLECTOR_URL=<UMAMI_COLLECTOR_URL> -e UMAMI_USERNAME=<UMAMI_USERNAME> -e UMAMI_PASSWORD=<UMAMI_PASSWORD> umami npx -y @mikusnuz/umami-mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о umami
Как установить umami в Claude Code?
Выполните claude mcp add umami -e UMAMI_PASSWORD=<UMAMI_PASSWORD> -e UMAMI_API_KEY=<UMAMI_API_KEY> -- npx -y @mikusnuz/umami-mcp.
Что делает umami?
MCP-сервер подключает агента к Umami Analytics v3: даёт доступ к аналитике, событиям, отчётам, сайтам и функциям сбора данных.
Какие версии Umami поддерживает umami?
Self-hosted-экземпляр должен быть совместим с Umami v3.3. API-ключи, сегменты по свойствам сессии и аннотации требуют Umami 3.4 или новее; также поддерживается Umami Cloud.
