Umami MCP

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

@umami/mcp

Model Context Protocol sunucusu, Umami analytics için. Claude, ChatGPT, Cursor ve diğer MCP istemcilerinin, @umami/api-client üzerinden Umami API'sini çağıran salt okunur araçları kullanarak web sitesi trafiğiniz hakkında soruları yanıtlamasını sağlar.

MCP sunucusu asla bir veritabanıyla konuşmaz; her araç genel API üzerinden ve web uygulamasıyla aynı kullanıcı/ekip izin kontrolleriyle çalışır.

Araçlar

Araç	Amaç
list_websites	Erişebildiğiniz web sitelerini bulun (önce bir websiteId almak için çağırın).
get_website_daterange	Kayıtlı verilerin bulunduğu en erken ve en son tarihler.
get_website_stats	Sayfa görüntüleme, ziyaretçi, ziyaret, hemen çıkma oranı, süre + önceki dönem.
get_website_traffic	Dakika, saat, gün, ay veya yıl bazında sayfa görüntüleme/ziyaret zaman serisi.
get_website_metrics	En iyi sayfalar, yönlendirenler, kanallar, ülkeler, tarayıcılar, cihazlar, UTM, olaylar.
get_realtime	Şu anda aktif olan ziyaretçiler.
get_events	Bireysel izlenen olaylar (sayfalanmış).
get_event_stats	Özel olay toplamları + önceki dönem.
get_event_series	Zaman içindeki özel olay sayıları, olay adına göre gruplanmış.
get_event_properties	Özel olay özellik adları veya bir özelliğin değerleri.
get_sessions	Ziyaretçi oturumları (sayfalanmış).
get_session_stats	Oturum düzeyi toplamları: ziyaretçiler, ziyaretler, sayfa görüntülemeleri, olaylar, ülkeler.
get_annotations	Zaman çizelgesindeki tarihli notlar (lansmanlar, kampanyalar) değişiklikleri açıklamak için.
list_segments	Kayıtlı segmentler ve kohortlar; kimlikleri filters.segment / .cohort üzerinden iletin.
get_session	Etkinlik zaman çizelgesi ve özellikleriyle tek bir oturum.
list_funnels	Adımlarıyla kayıtlı huniler (run_funnel için bir funnelId alın).
run_funnel	Kayıtlı bir funnelId veya geçici sayfa/olay adımlarından dönüşüm hunisi.
get_goals	Bir aralık için dönüşümler, ziyaretçiler ve oranla kayıtlı hedefler.
run_journey	Ziyaretçilerin en sık izlediği yollar.
run_retention	Kohort tutma tablosu.
run_attribution	Bir dönüşüm için ilk/son tıklama ilişkilendirmesi.
get_revenue	Gelir toplamları, seriler ve kırılımlar.
get_performance	Core Web Vitals (LCP, INP, CLS, FCP, TTFB) yüzdelikleri, eğilim, kırılım.

Tüm araçlar salt okunurdur. Tarihler ISO 8601'dir; sonuçlar sayfa boyutunda sabit bir üst sınırla sayfalanır.

Uzaktan: Umami Cloud

Mevcut Cloud API anahtarınızı kullanarak https://cloud.umami.is/mcp bağlanın:

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

Özel başlıkları destekleyen istemciler bunun yerine x-umami-api-key kullanabilir. Her iki başlık da sağlanırsa, aynı anahtarı içermelidir. API anahtarı veya taşıyıcı başlık yapılandırmasını destekleyen bir istemci kullanın.

Cloud MCP, Cloud API ile aynı abonelik gereksinimlerine ve web sitesi/ekip izinlerine sahiptir. Tüm araçlar, anahtarı doğrulayan ve istekleri bölgenize yönlendiren Cloud API ağ geçidini çağırır.

Uzaktan: kendi kendine barındırılan

Umami örneğinizde Ayarlar → API anahtarları altında bir API anahtarı oluşturun, ardından MCP istemcinizi Streamable HTTP uç noktasıyla yapılandırın:

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

Anahtarınızı kullanarak yetkilendirme başlığını ayarlayın:

Authorization: Bearer umami_<your-api-key>

Taşıyıcı belirteçlerini veya özel yetkilendirme başlıklarını destekleyen bir istemci kullanın. Uç nokta, kendi kendine barındırılan API anahtarlarını kabul eder; tarayıcı giriş belirteçleri desteklenmez. Araçlar salt okunurdur ve anahtar sahibinin mevcut kullanıcı/ekip izinlerine saygı gösterir. Erişimi kesmek için anahtarı Ayarlar'da iptal edin. MCP varsayılan olarak devre dışıdır. Uç noktayı etkinleştirmek için MCP_ENABLED=1 ayarlayın.

Yerel / stdio

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

Değişken	Açıklama
UMAMI_URL	Kendi kendine barındırılan örnek URL (/api eklenir).
UMAMI_API_URL	Bunun yerine tam API temel URL'si, örn. https://api.umami.is/v1.
UMAMI_API_TOKEN	API anahtarı veya giriş belirteci (kendi kendine barındırılan).
UMAMI_API_KEY	Umami Cloud API anahtarı.

Cloud stdio için UMAMI_API_KEY ayarlayın ve UMAMI_URL ile UMAMI_API_TOKEN atlayın:

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

Örnek istemler

• Web sitelerimi göster.
• example.com geçen hafta kaç ziyaretçi aldı?
• Bu ayın en iyi 10 sayfası hangileriydi?
• Bu ayın trafiğini önceki ayla karşılaştır.
• Trafik nereden geliyor?
• Dün hangi kayıt olayları gerçekleşti?
• abc123 kullanıcısının oturumlarını göster.
• Geçen ay ödeme olayında insanlar hangi fiyatlandırma planlarını seçti?
• Bu hafta her gün kaç kayıt olayı tetiklendi?
• Geçen ay için ödeme hunimi çalıştır.
• Bu çeyrekte hedeflerimize karşı nasıl gidiyoruz?
• Mobilde en kötü LCP'ye sahip sayfalar hangileri?
• Trafiğin arttığı günde ne oldu?

Programatik kullanım

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

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

createUmamiMcpHttpHandler({ createClient }), herhangi bir web çerçevesine gömmek için bir Streamable HTTP işleyicisi döndürür; ana bilgisayar taşıyıcı belirtecini doğrular ve authInfo iletir.