API i MCP · MCP
Twój agent AI
pyta Twoją analitykę.
Observer dostarcza serwer MCP bez żadnych zależności: stdio, JSON-RPC 2.0, protokół 2024-11-05. Jeden blok JSON podłącza go do Claude Desktop, Cursor albo Claude Code — a agent dostaje 15 narzędzi na żywo, pilnowanych tymi samymi scope'ami i listami dozwolonych witryn co każde inne wywołanie.
"mcpServers": { "observer": { "command": "/path/to/observer-mcp", "env": { "OBSERVER_BASE_URL": "https://sa.yourdomain.com", "OBSERVER_API_KEY": "obsk_…" } } }
To cała konfiguracja. Zrestartuj klienta — agent wypisze 15 narzędzi Observera.
Model Context Protocol
Jeden blok JSON,
jeden proces stdio.
Serwer mówi protokołem Model Context Protocol po stdio — JSON-RPC 2.0, protokół 2024-11-05 — z zerem zależności. Niczego nie instalujesz, nie ma czego audytować w drzewie node_modules; to jeden proces, który uruchamia Twój klient MCP i z którym rozmawia.
- 15 narzędzi — cała powierzchnia /api/v1, zmapowana dla agentów
- Scope'y z założenia — scope'y klucza i listy dozwolonych witryn pilnują każdego wywołania
- Zero zależności — jeden proces stdio, nic do instalowania
Pakiet MCP jest dostarczany podczas onboardingu — komenda powyżej wskazuje miejsce, w którym go zainstalujesz, obok Twojego klucza API obsk_.
15 narzędzi
Co Twój agent może, a czego nie może zrobić.
Każde narzędzie odwzorowuje scope'owaną powierzchnię API — te same sześć scope'ów, te same per-kluczowe listy dozwolonych witryn. Agent może odczytać ruch, zbudować witryny albo zapisać konwersje; nigdy więcej, niż pozwala jego klucz.
| overview · pages · realtime · vitals · acquisition | odczyt |
| sessions · session_timeline | odczyt |
| heatmap · frustration · anomalies · deploy_diff · forms | odczyt |
| sites | odczyt |
| create_site | write:sites |
| record_event | write:events |
W praktyce
Pytanie w edytorze,
odpowiedź z danych.
„Które strony zwolniły w tym tygodniu?" „Czy rage klikania przybrało od wdrożenia?" „Postaw witrynę preview dla tego brancha i zapisz konwersję testu dymnego." Agent odpowiada z żywych, k-anonimizowanych danych — tych samych liczb, które pokazałby dashboard, z plakietkami włącznie.
Agenty po stronie odczytu
Pytania o analitykę, CWV i sesje z kluczem tylko do odczytu — agent, który może wyłącznie patrzeć, choćby jego prompt był najbardziej przekonujący.
Agenty po stronie budowania
create_site jest pilnowany przez write:sites, a record_event przez write:events — nadawaj je tylko kluczom, które pozwoliłbyś prowadzić wdrożenie.
Ta sama uczciwość, bez teatru
Ukryte wiersze pozostają ukryte także w odpowiedziach agenta — post-filtr działa, zanim narzędzie odpowie.
Piętnaście narzędzi.
Scope'owane per klucz.
Serwer MCP jest dostarczany podczas onboardingu, razem z Twoimi kluczami API.