# umami

Подключает Claude Code к Umami Analytics v3 для аналитики, событий, отчётов и управления сайтами. Пригодится для работы с данными через MCP.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Автор: mikusnuz
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/mikusnuz/umami-mcp
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/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 или новее.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `UMAMI_MODE`, `UMAMI_URL`, `UMAMI_COLLECTOR_URL`, `UMAMI_USERNAME`, `UMAMI_PASSWORD`, `UMAMI_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- собрать статистику сайта из Umami
- получить просмотры страниц и данные о сессиях
- отправить события и данные производительности
- запустить отчёт по аналитике сайта

## Примеры запросов агенту
- Покажи статистику сайта за выбранный период через Umami.
- Получи просмотры страниц и метрики для сайта с заданным `websiteId`.
- Запусти отчёт Umami по воронке или удержанию.

## Похожие
- [posthog-analytics](https://affpapa.org/nevibecode/skills/posthog-analytics.md) — скилл · 809 установок
- [yandex-metrica-mcp](https://affpapa.org/nevibecode/mcp/yandex-metrica-mcp.md) — MCP-сервер · ★ 15
- [receipts](https://affpapa.org/nevibecode/skills/receipts.md) — скилл · 2052 установки
- [Substack MCP Server](https://affpapa.org/nevibecode/mcp/substack-mcp-server.md) — MCP-сервер · ★ 91
- [mcp-server](https://affpapa.org/nevibecode/mcp/socialneuron-mcp-server.md) — MCP-сервер · ★ 5
- [google-analytics-data-api-basics](https://affpapa.org/nevibecode/skills/google-analytics-data-api-basics.md) — скилл · 7364 установки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md