rybbit-mcp

Otázka „kolik lidí dnes přišlo z newsletteru a kolik z nich došlo do košíku“ v analytice znamená otevřít přehled, nastavit období, přidat filtr podle zdroje, přepnout na trychtýř a zapsat si čísla. rybbit-mcp dovolí položit ji AI asistentovi rovnou. Je to MCP server pro analytiku Rybbit: Claude Code, Claude Desktop nebo jiný klient protokolu MCP přes něj čte statistiky, relace, uživatele, události, chyby, výkon stránek, cíle a trychtýře z vlastní instance i z Rybbit Cloudu a odpovídá větou s čísly.

Místo klikání v přehledu otázka v jedné větě

Webový přehled Rybbitu je dělaný na prohlížení, ne na kombinování. Kdo chce srovnat dvě období, rozpad podle zařízení a chyby za poslední hodinu, prochází několik obrazovek. MCP server dá modelu stejná data jako nástroje s popsanými parametry a model si je poskládá sám: nejdřív zjistí identifikátor webu, pak stáhne přehled, potom rozpad podle dimenze a nakonec relace, které za číslem stojí. Výsledek je odpověď, ne sada záložek.

Co server umí

• 43 nástrojů ve vydané verzi 0.8.1: přehled a časové řady, živí návštěvníci, rozpady podle dimenzí, retence, relace a jejich detail, uživatelé a jejich vlastnosti, události, odchozí odkazy, chyby, Core Web Vitals, trychtýře, cíle, cesty po webu a správa webů. README v repozitáři zatím popisuje starší sadu 32 nástrojů.
• Filtry podle 22 dimenzí, například prohlížeče, země, stránky, zdroje, kanálu a všech pěti parametrů UTM, s osmi způsoby porovnání včetně regulárních výrazů. Model tak omezí data stejně přesně jako člověk v přehledu.
• Časové období jako rozsah dat, nebo relativně v minutách („posledních 60 minut“). Časové řady jdou po minutě až po roce.
• Seskupení událostí podle libovolných vlastností a žebříček uživatelů podle počtu určité události. Na otázku „kdo dnes poslal nejvíc zpráv“ tak odpoví jeden nástroj, ne ruční počítání.
• Zápis tam, kde dává smysl: založení a smazání webu, změna nastavení sledování, uložení trychtýře a cíle. Nástroje nesou příznaky, které klientovi řeknou, co jen čte a co mění.
• Kontrola, jestli web už přijal první data. Hodí se hned po nasazení měřicího skriptu nebo SDK.

Odpovědi, které se vejdou do kontextu

Analytika umí vrátit obrovské tabulky a jazykový model má omezený kontext. Server proto odpověď nad 25 000 znaků zkrátí a všechny seznamy umí stránkovat parametry page a limit. Chybové hlášky jsou psané pro model: místo holého kódu řeknou, co zkusit dál, třeba zúžit období nebo zavolat rybbit_list_sites pro platná ID webů. Nástroj rybbit_describe_dimension vypíše, které nástroje danou dimenzi filtru přijímají, takže model nemusí hádat.

Jak se připojí

Přihlásit se jde API klíčem, což je doporučená cesta pro provoz, nebo e-mailem a heslem pro vývoj. Obojí potřebuje adresu instance v RYBBIT_URL. Ve výchozím stavu server běží přes standardní vstup a výstup jako proces klienta; s MCP_TRANSPORT=http běží jako samostatná služba na HTTP, adresu a port určí MCP_HTTP_HOST a MCP_HTTP_PORT. Verze 0.8.0 a 0.8.1 sladily cesty, filtry a odpovědi se serverem Rybbit 2.6.

{
  "mcpServers": {
    "rybbit": {
      "command": "npx",
      "args": ["-y", "@nks-hub/rybbit-mcp"],
      "env": {
        "RYBBIT_URL": "https://your-rybbit-instance.com",
        "RYBBIT_API_KEY": "your-api-key"
      }
    }
  }
}

V Claude Code totéž zařídí jeden příkaz:

claude mcp add rybbit -e RYBBIT_URL=https://your-instance.com -e RYBBIT_API_KEY=your-key -- npx -y @nks-hub/rybbit-mcp

Kde se hodí

• Ranní přehled: kolik bylo včera návštěvníků, odkud přišli a které stránky měly největší míru okamžitého odchodu, v jedné odpovědi pro všechny weby organizace.
• Kontrola po nasazení: dorazila z nového webu nebo z aplikace první data, jaké události chodí a s jakými vlastnostmi. Data posílají třeba knihovny rybbit-ts pro web a rybbit-flutter-sdk pro Flutter.
• Rozbor prodejního trychtýře: v kterém kroku lidé odcházejí a jak vypadají relace těch, kdo odešli.
• Výkon webu: Core Web Vitals po stránkách a jejich vývoj v čase, když se po vydání zhorší LCP nebo INP.

Kdo chce stejná čísla vidět v telefonu, sáhne po aplikaci Rybbit Mobile, která čte tutéž analytiku jako mobilní klient.

Stav projektu

Projekt vznikl v březnu 2026 a na npm od té doby vyšlo třináct verzí, poslední 0.8.1 z 24. září 2026. Rybbit vyvíjí jiný tým, takže když změní cesty API nebo validaci parametrů, potřebuje server novou verzi; naposledy se to stalo s Rybbitem 2.6. Automatickou sadu testů repozitář nemá; CI na GitHubu projekt sestaví a vydanou verzi publikuje na npm.

Jak začít

Stačí Node.js 18 nebo novější a API klíč z nastavení Rybbitu. Balíček není potřeba instalovat, npx si ho stáhne při prvním spuštění; globálně ho nainstaluje npm install -g @nks-hub/rybbit-mcp. Ze zdrojů se sestaví příkazy npm install a npm run build.

Zdrojový kód

Kód je na GitHubu v repozitáři nks-hub/rybbit-mcp pod licencí MIT, napsaný v TypeScriptu nad oficiálním MCP SDK. Balíček je na npm jako @nks-hub/rybbit-mcp, poslední verze 0.8.1.