# Debugowanie produkcji z edytora: Sentry, Grafana, Datadog i PostHog MCP

URL: https://developertoolkit.ai/pl/ecosystem/mcp/observability-mcp/
Description: Podłącz Sentry, Grafanę, Datadoga i PostHog MCP do Claude Code, Codeksa i Cursora tylko do odczytu, napraw główny błąd produkcji i sprawdź go po wdrożeniu.

Serwery MCP do obserwowalności pozwalają Claude Code, Codeksowi i Cursorowi czytać dowody wprost z produkcji: Sentry dostarcza błędy i ślady, Grafana i Datadog metryki, logi i alerty, a PostHog metryki produktowe. Podłączone tylko do odczytu zamieniają „napraw główny błąd produkcji” w pętlę, która zaczyna się od prawdziwego stack trace’a i kończy metryką potwierdzającą, że poprawka działa.

Ta strona jest dla programistów, którzy biorą dyżury, i dla tech leadów odpowiedzialnych za proces on-call. Alert się odpala, otwierasz Grafanę, żeby znaleźć skok, przechodzisz do Sentry po stack trace, kopiujesz go do agenta, czekasz na poprawkę, wdrażasz, a potem sprawdzasz trzy dashboardy, żeby zobaczyć, czy zadziałało. Agent napisał pięć linii kodu, a ty przez większą część godziny robiłeś za schowek między czterema systemami.

**Sprawdzone 26 września 2026**

Polecenia uruchomiono w Claude Code 2.1.283 i codex-cli 0.157.1 w projekcie testowym (`claude mcp add -s project` oraz `codex mcp add` na jednorazowym `CODEX_HOME`). Flagi serwerów, nazwy narzędzi i parametry URL pochodzą z repozytoriów dostawców: `getsentry/sentry-mcp`, `grafana/mcp-grafana` (PyPI 1.6.0), `datadog-labs/mcp-server` i `PostHog/posthog` (`services/mcp`). Koszt wtyczek w tokenach zmierzono poleceniem `claude plugin details`, a listę narzędzi Grafany wywołaniem MCP `tools/list` na `mcp-grafana` 1.6.0. W środowisku autora nie ma Cursora, więc jego JSON odpowiada instrukcjom dostawców dla Cursora i nie był w nim testowany.

## Co zyskujesz dzięki MCP do obserwowalności

- Sprawdzone polecenia instalacji Sentry, Grafany, Datadoga i PostHoga w trybie tylko do odczytu we wszystkich trzech agentach
- Gotowy prompt, który prowadzi od najczęstszego nierozwiązanego błędu w Sentry do czerwonego testu i lokalnej poprawki
- Pętlę incydentu: alert w Grafanie lub Datadogu, błąd w Sentry, poprawka, wdrożenie przez CI, weryfikacja metryki w PostHogu
- Zmierzony koszt kontekstu każdej wtyczki dostawcy i wskazówkę, kiedy lepszy jest sam serwer
- Pułapki: błędny pakiet Grafany, nagłówek Sentry, który nie jest `Bearer`, i narzędzia zapisu, które zostają włączone, dopóki ich nie wyłączysz

## Który serwer MCP odpowiada na które pytanie o incydent?

Każdy serwer odpowiada na inne pytanie. Instaluj serwery usług, z których już korzystasz; żaden nie zastępuje innego.

| Serwer | Na jakie pytanie odpowiada | Transport i uwierzytelnianie | Kontrola trybu tylko do odczytu | Popularność (2026-09-26) |
| --- | --- | --- | --- | --- |
| **Sentry MCP** (Sentry) | Który błąd, w którym miejscu kodu, od którego wydania? | Zdalny `https://mcp.sentry.dev/mcp`, OAuth albo token `Sentry-Bearer` | Domyślnie `inspect` i `seer`; `triage` (rozwiązywanie, przypisywanie) jest wyłączony, dopóki go nie przyznasz | ★862; wtyczka 38 810 instalacji |
| **Grafana MCP** (Grafana Labs) | Co robiły metryki, logi i alerty wokół incydentu? | Lokalny `uvx mcp-grafana` z tokenem konta serwisowego albo zdalny Grafana Cloud | `--disable-write` | ★3,5 tys. |
| **Datadog MCP** (Datadog, zarządzany) | Który monitor się odpalił i co pokazują logi oraz ślady APM? | Zdalny, osobny URL dla każdego regionu (site) Datadoga; OAuth, a wtyczka obsługuje też uwierzytelnianie kluczami | README nie opisuje przełącznika; zawęź narzędzia przez `/ddtoolsets` we wtyczce i rolę użytkownika Datadoga | `datadog-labs/mcp-server` ★45 (repozytorium z dokumentacją; serwer jest zarządzany) |
| **PostHog MCP** (PostHog) | Czy użytkownicy to odczuli i czy poprawka przywróciła lejek? | Zdalny `https://mcp.posthog.com/mcp`, OAuth albo osobisty klucz API | Lista dozwolonych narzędzi do odczytu w `?tools=`; README nie opisuje flagi tylko do odczytu | monorepo `PostHog/posthog` ★39,9 tys. |

Popularność to gwiazdki na GitHubie (GitHub API) i liczby instalacji z katalogu Claude Marketplace (claude.com/plugins), odczytane 26.09.2026. Gwiazdki mierzą uwagę poświęconą repozytorium, a nie użycie serwera.

## Zainstaluj cztery serwery w trybie tylko do odczytu

Adresy URL i pakiety są takie same w każdym agencie; różni się tylko polecenie albo plik konfiguracji. Wpisy wspólne dla zespołu trzymaj w pliku projektu (`.mcp.json`, `.cursor/mcp.json`), żeby przechodziły przez review, a każde poświadczenie w zmiennej środowiskowej albo w pliku poza repozytorium.

### Sentry: zdalny serwer, najpierw OAuth

**Claude Code**

```bash
# Terminal, repo root. --transport http is required; without it Claude Code writes a stdio entry
claude mcp add -s project --transport http sentry https://mcp.sentry.dev/mcp
claude mcp login sentry          # or run /mcp inside a session
```
Token zamiast OAuth (CI albo praca w trybie headless). Pojedyncze cudzysłowy zostawiają zmienną nierozwiniętą w `.mcp.json`; Claude Code rozwija ją przy starcie:
```bash
claude mcp add -s project --transport http sentry https://mcp.sentry.dev/mcp \
  -H 'Authorization: Sentry-Bearer ${SENTRY_ACCESS_TOKEN}'
```

**Codex**

```bash
codex mcp add sentry --url https://mcp.sentry.dev/mcp
codex mcp login sentry
```
Token zamiast OAuth: `--bearer-token-env-var` wysyła `Bearer`, który Sentry rezerwuje dla tokenów OAuth. Wyślij całą wartość nagłówka ze zmiennej środowiskowej:
```toml
# ~/.codex/config.toml; export SENTRY_AUTH_HEADER="Sentry-Bearer $SENTRY_ACCESS_TOKEN" first
[mcp_servers.sentry]
url = "https://mcp.sentry.dev/mcp"
env_http_headers = { "Authorization" = "SENTRY_AUTH_HEADER" }
```

**Cursor**

W pliku `.cursor/mcp.json`:

```json
{ "mcpServers": { "sentry": { "url": "https://mcp.sentry.dev/mcp" } } }
```
Dokończ logowanie OAuth, gdy Cursor o nie poprosi.

Na ekranie OAuth zostaw odznaczone **Triage Issues** i **Manage Projects & Teams**. Domyślne uprawnienia, `inspect` i `seer`, czytają zgłoszenia, zdarzenia, ślady, nagrania sesji i wydania oraz uruchamiają analizę Seer; `update_issue` należy do `triage`. Z tokenem serwer przyznaje wszystkie uprawnienia, więc zawęź je w URL: `https://mcp.sentry.dev/mcp?skills=inspect,seer`.

Sentry wydaje też dwie wtyczki i wybierasz jedną z nich. `sentry@claude-plugins-official` (źródło `getsentry/plugin-claude`, w Codeksie `codex plugin add sentry@openai-curated`, w Cursorze `getsentry/plugin-cursor` w ustawieniach wtyczek) łączy hostowany serwer ze skillami `sentry-for-ai`, między innymi `sentry-debug-issue` i `sentry-fix-stack-traces`. `sentry-mcp@sentry-mcp` (najpierw `claude plugin marketplace add getsentry/sentry-mcp`) dodaje zamiast tego subagenta `sentry-mcp`, który trzyma duże zdarzenia poza głównym kontekstem. Instalacja obu rejestruje serwer dwukrotnie. Skille pochodzą z repozytorium źródłowego `getsentry/sentry-for-ai`, które według Sentry instaluje się przez jedną z tych wtyczek, a nie bezpośrednio.

### Grafana: oficjalny serwer z `--disable-write`

Oficjalny serwer to pakiet PyPI `mcp-grafana` (1.6.0), uruchamiany przez `uvx`. Utwórz konto serwisowe z rolą **Viewer**, zapisz jego token w pliku poza repozytorium i wskaż ten plik w `GRAFANA_SERVICE_ACCOUNT_TOKEN_FILE`. Serwer czyta plik przy każdym żądaniu, więc rotacja tokenu nie wymaga restartu.

**Claude Code**

```bash
claude mcp add -s project grafana \
  -e GRAFANA_URL=https://yourstack.grafana.net \
  -e 'GRAFANA_SERVICE_ACCOUNT_TOKEN_FILE=${HOME}/.config/grafana/mcp-token' \
  -- uvx mcp-grafana --disable-write
```

**Codex**

```bash
codex mcp add grafana \
  --env GRAFANA_URL=https://yourstack.grafana.net \
  --env GRAFANA_SERVICE_ACCOUNT_TOKEN_FILE=$HOME/.config/grafana/mcp-token \
  -- uvx mcp-grafana --disable-write
```

**Cursor**

W pliku `~/.cursor/mcp.json`:

```json
{ "mcpServers": { "grafana": {
  "command": "uvx",
  "args": ["mcp-grafana", "--disable-write"],
  "env": {
    "GRAFANA_URL": "https://yourstack.grafana.net",
    "GRAFANA_SERVICE_ACCOUNT_TOKEN_FILE": "/Users/you/.config/grafana/mcp-token"
  } } } }
```
Ten wpis trafia do pliku użytkownika, a nie do `.cursor/mcp.json`, bo ścieżka do tokenu jest inna dla każdego użytkownika. Zamień `/Users/you` na swój katalog domowy.

`--disable-write` usuwa aktualizację dashboardów, tworzenie incydentów, zmiany reguł alertów i wyciszeń, adnotacje i snapshoty. Usuwa też narzędzia surowego SQL dla źródeł danych, `query_sql` i `query_influxdb`, bo wykonują każde polecenie, na które pozwalają poświadczenia źródła; dodaj `--enable-query`, żeby je zachować, gdy te poświadczenia są tylko do odczytu. Usuwa też dwa narzędzia Sift, `find_error_pattern_logs` i `find_slow_requests`, bo tworzą rekordy dochodzeń. Żeby je zachować, dodaj `--enable-write-tools=find_error_pattern_logs,find_slow_requests`; wymagają roli **Editor**. W Grafana Cloud możesz pominąć lokalny proces: `https://mcp.grafana.com/mcp` to endpoint z wtyczki Grafany `grafana-cloud-mcp` (`claude mcp add --transport http grafana-cloud https://mcp.grafana.com/mcp`). Flagi z tej strony dotyczą lokalnego serwera, więc zanim uznasz hostowany endpoint za tylko do odczytu, sprawdź przez `/mcp`, jakie narzędzia udostępnia.

### Datadog: jeden URL na każdy region

**Claude Code**

```bash
# US1. For EU replace the host with mcp.datadoghq.eu; other sites use their own host
claude mcp add -s project --transport http datadog https://mcp.datadoghq.com/v1/mcp
```
Albo `claude plugin install datadog@claude-plugins-official` (wersja preview) i `/ddsetup`, które przeprowadzi cię przez wybór regionu (site) Datadoga. Nie instaluj obu.

**Codex**

```bash
codex mcp add datadog --url https://mcp.datadoghq.com/v1/mcp
```
W naszym teście `codex mcp add` od razu uruchomił logowanie OAuth dla Datadoga. Alternatywa to `codex plugin add datadog@openai-curated`.

**Cursor**

```json
{ "mcpServers": { "datadog": { "url": "https://mcp.datadoghq.com/v1/mcp" } } }
```

Dopasuj host MCP do regionu z adresu Datadoga: `app.datadoghq.eu` oznacza `mcp.datadoghq.eu`. README Datadoga nie opisuje przełącznika tylko do odczytu (sprawdzone 26.09.2026), więc loguj się jako użytkownik Datadoga z rolą dopasowaną do zadania, a we wtyczce wyłącz niepotrzebne grupy narzędzi przez `/ddtoolsets`. W CI i sesjach bez przeglądarki wtyczka przyjmuje też uwierzytelnianie kluczami: przed uruchomieniem Claude Code ustaw `DD_MCP_DOMAIN` (sam host, np. `mcp.datadoghq.com`, bez `https://`), `DD_API_KEY` i `DD_APPLICATION_KEY`. `DD_MCP_TOOLSETS` przypina włączone zestawy narzędzi jako listę rozdzieloną przecinkami i ma pierwszeństwo przed ustawieniem z `/ddtoolsets`, więc to jedyny nieinteraktywny sposób na zawężenie narzędzi Datadoga (README wtyczki, sprawdzone 26.09.2026).

### PostHog: kreator albo zawężony URL

`npx @posthog/wizard@latest mcp add` (kreator 2.78.0) zapisuje wpis dla Cursora, Claude Code, Claude, VS Code i Zeda. Codeksa nie ma na tej liście. Na potrzeby pętli incydentu przypnij zamiast pełnego zestawu narzędzi listę dozwolonych narzędzi do odczytu:

**Claude Code**

```bash
claude mcp add -s project --transport http posthog \
  'https://mcp.posthog.com/mcp?mode=tools&tools=query-funnel,query-trends,query-error-tracking-issue,insights-list,insight-get,dashboard-get,read-data-schema,execute-sql'
```

**Codex**

```bash
codex mcp add posthog --url 'https://mcp.posthog.com/mcp?mode=tools&tools=query-funnel,query-trends,query-error-tracking-issue,insights-list,insight-get,dashboard-get,read-data-schema,execute-sql'
codex mcp login posthog
```

**Cursor**

```json
{ "mcpServers": { "posthog": {
  "url": "https://mcp.posthog.com/mcp?mode=tools&tools=query-funnel,query-trends,query-error-tracking-issue,insights-list,insight-get,dashboard-get,read-data-schema,execute-sql" } } }
```

Domyślnie serwer działa w trybie `cli`, z wyjątkiem Cursora, dla którego serwer sam wybiera tryb tools. W trybie `cli` jedno narzędzie `posthog` obejmuje wszystkie polecenia, więc reguła po stronie klienta nie zablokuje osobno `update-feature-flag`. Przypięcie `mode=tools` sprawia, że każdy klient działa tak samo: serwer rejestruje osobne narzędzie MCP dla każdego narzędzia PostHoga, a `tools=` udostępnia tylko wymienione, same odczyty (`execute-sql` wykonuje zapytania HogQL). PostHog nie opisuje przełącznika tylko do odczytu, więc to lista dozwolonych narzędzi jest twoją kontrolą. Filtry w stylu `?features=flags,dashboards` stosuj wtedy, gdy chcesz całych obszarów produktu. Projekty w UE używają hosta `mcp-eu.posthog.com`, żeby OAuth trafił do instancji europejskiej.

## Ile kontekstu kosztują serwery obserwowalności?

Zmierz, zanim ustandaryzujesz. Wiersze wtyczek pochodzą z `claude plugin details` w Claude Code 2.1.283, a wiersz Grafany z wywołania MCP `tools/list` na `mcp-grafana` 1.6.0. Wszystko odczytano 26.09.2026:

| Instalacja | Koszt kontekstu | Co się ładuje |
| --- | --- | --- |
| `sentry@claude-plugins-official` 1.4.0 | ~1064 tokeny w każdej sesji | 8 skilli oraz serwer Sentry (schematy niepoliczone) |
| `posthog@posthog` 1.1.66 | ~29 443 tokeny w każdej sesji | 164 skille, agent `error-analyzer`, 2 hooki oraz serwer PostHoga |
| `uvx mcp-grafana --disable-write` 1.6.0 | 75 983 znaki schematów narzędzi, czyli około 19 000 tokenów, jeśli załadują się wszystkie | 65 narzędzi, najwięcej na tej stronie |
| Zdalny serwer Datadoga | Niezmierzone | Serwer jest zarządzany i pokazuje narzędzia dopiero po zalogowaniu do Datadoga, a środowisko autora nie miało konta |

Wiersz PostHoga zmierzyliśmy dla wtyczki z marketplace’u samego PostHoga (`claude plugin marketplace add PostHog/ai-plugin`, potem `claude plugin install posthog@posthog`); wpis `posthog@claude-plugins-official` wskazuje to samo repozytorium `PostHog/ai-plugin`. README wtyczki PostHoga mówi o „30+ task-specific skills”; wersja 1.1.66 instaluje 164. Pętla incydentu potrzebuje ośmiu narzędzi do odczytu, więc URL z listą dozwolonych narzędzi kosztuje ułamek tej kwoty. Wtyczkę zostaw do pracy z analityką produktową albo włączaj ją tylko w takich sesjach. Liczba dla Grafany to górna granica, oszacowana jako cztery znaki na token, a nie odczytana z `/context`: Claude Code i Codex ładują narzędzia MCP przez tool search, więc schemat trafia do kontekstu dopiero wtedy, gdy agent go pobierze. Schematy serwerów dochodzą do liczb dla wtyczek; uruchom `/context` przed każdym `claude mcp add` i po nim, także dla Datadoga. W Codeksie `enabled_tools` i `disabled_tools` we wpisie serwera filtrują to, co widzi model. Więcej technik znajdziesz w artykule o [ograniczaniu kosztu tokenów MCP](/pl/ecosystem/mcp/reducing-mcp-token-cost/).

## Napraw lokalnie najczęstszy nierozwiązany błąd

Od tego przykładu warto zacząć. Korzysta tylko z Sentry, nic nie zapisuje i kończy się testem, który dowodzi poprawki. Zobaczysz wywołanie `search_issues`, potem `search_sentry_tools`/`execute_sentry_tool` uruchamiające `get_issue_details`, `get_event_stacktrace` albo `get_trace_details`, a opcjonalnie `analyze_issue_with_seer`. Serwer udostępnia narzędzia szczegółowe przez tę parę narzędzi katalogu, a nie pod ich własnymi nazwami.

**Prompt do skopiowania: główny błąd z Sentry do czerwonego testu**

```text
Use the sentry MCP server, read-only. In project web-frontend, environment production, find the unresolved issue with the most events in the last 24 hours.
Show: issue ID, title, event count, users affected, first seen, the release it first appeared in, and the top in-app stack frames.
Open the latest event and its trace. Map every in-app frame to a file and line in this repository at the commit of that release, and say which frame is the root cause and why.
Before changing any code, write a test that reproduces the failure from the event's inputs (request, breadcrumbs, tags) and run it. It must fail for the reason in the stack trace.
Then fix the root cause, not the symptom, run the test and the related suite, and stop. Do not resolve or assign the Sentry issue.
```

Co powinieneś zobaczyć: krótkie podsumowanie zgłoszenia, mapowanie ramek na pliki, nowy test, który pada z tym samym typem wyjątku i komunikatem co zdarzenie w Sentry, a potem diff i zielony przebieg. Jeśli agent nie potrafi odtworzyć błędu, mówi to wprost i wymienia, czego mu brakuje, najczęściej tagu albo stanu feature flagi. Nie powinien zgadywać poprawki.

Przy nieznanym błędzie dodaj Seer jako drugą opinię:

**Prompt do skopiowania: porównaj przyczynę według Seer z diagnozą agenta**

```text
Use the sentry MCP server's Seer analysis (analyze_issue_with_seer, through execute_sentry_tool if it is not listed directly) on the same issue. Compare Seer's root cause with yours.
If they disagree, list the evidence for each (frames, breadcrumbs, recent commits to those files via git log) and design one test that would tell them apart. Run it and report which explanation survives.
```

## Przeprowadź pętlę incydentu: alert, błąd, poprawka, wdrożenie, weryfikacja

Powyższy przykład zaczyna się od Sentry. Prawdziwy incydent zaczyna się od alertu, a kończy, gdy metryka pokazuje, że użytkownicy znów mają się dobrze. Agent wykonuje wyszukiwania na każdym kroku; bramki należą do ciebie i do CI.

1. **Odczytaj alert.** Agent pobiera aktywny alert i metryki wokół niego z Grafany albo Datadoga i ustala okno incydentu.

   **Prompt do skopiowania: zamień alert w okno incydentu**

   ```text
   Use the grafana MCP server (read-only). List alert rules currently firing for service checkout-api.
   For the one that fired first, query Prometheus for the http 5xx rate and p95 latency for checkout-api over the last 3 hours, and query Loki for error-level logs from the same service in that window.
   Give me: the minute the error rate left its baseline, the top three log error messages with counts, and any deploy or config annotation within 30 minutes before it.
   Do not create incidents, annotations, or silences.
   ```

   W Datadogu ta sama prośba brzmi: *„Show the monitor that fired for service checkout, the matching APM traces with errors, and what changed in the 30 minutes before.”*

2. **Znajdź błąd.** Przekaż okno do Sentry: „Find issues in checkout-api whose events spike inside that window, sorted by event count, and tell me which release introduced each.” Alert daje czas i objaw, Sentry daje miejsce w kodzie i wydanie.

3. **Odtwórz i napraw lokalnie.** Uruchom prompt o głównym błędzie z poprzedniej sekcji, przypięty do tego zgłoszenia. Czerwony test jest kryterium akceptacji.

4. **Wdrażaj przez CI, nie z edytora.** Agent otwiera pull request, który linkuje zgłoszenie w Sentry i alert oraz zawiera test najpierw czerwony, potem zielony. Review przebiega według zasad [przeglądu pull requestów od agenta](/pl/workflows/ship/agent-pr-review/); właściciel serwisu zatwierdza, a zwykły pipeline wdraża. Serwery MCP przez cały czas zostają w trybie tylko do odczytu.

5. **Sprawdź metrykę.** Po wdrożeniu agent sprawdza trzy rzeczy względem progów ustalonych przed poprawką: zgłoszenie w Sentry nie ma nowych zdarzeń w nowym wydaniu, warunek alertu w Grafanie lub Datadogu wrócił poniżej progu, a metryka widoczna dla użytkownika w PostHogu wróciła do poziomu bazowego.

   **Prompt do skopiowania: weryfikacja poprawki po wdrożeniu**

   ```text
   Release checkout-api@2026.09.26-3 is deployed. Verify the fix, read-only:
   1. Sentry: count events for issue CHECKOUT-API-4F2 since the release was first seen, and confirm none carry that release tag.
   2. Grafana: query the checkout-api 5xx rate and p95 latency for 60 minutes after the deploy and compare them with the same hour yesterday.
   3. PostHog: compare the conversion from checkout_started to checkout_completed for the 60 minutes after the deploy with the same window over the previous 7 days.
   Report each as pass or fail against these thresholds: zero new events in the release; 5xx under 0.5%; conversion within 5% of the 7-day baseline. Do not resolve anything.
   ```

6. **Zamyka człowiek.** Gdy wszystkie trzy sprawdzenia przejdą, dyżurny inżynier rozwiązuje zgłoszenie w Sentry i pisze notatkę z incydentu. Agent może przygotować jej szkic z zebranych dowodów; sam proces obsługi incydentu opisuje artykuł o [reagowaniu na incydenty z pomocą AI](/pl/workflows/operate/incident-response/).

Pętla jest taka sama w każdym agencie. Różni się sposób jej prowadzenia:

**Claude Code**

Kroki 1–3 prowadź w trybie planowania (Plan Mode), żeby zatwierdzić plan, zanim agent zacznie edytować pliki. Z `sentry-mcp@sentry-mcp` Claude deleguje wyszukiwania w Sentry do subagenta `sentry-mcp`, a w głównym kontekście zostaje tylko podsumowanie. Narzędzia zapisu, których nigdy nie chcesz wywoływać, zablokuj w `.claude/settings.json`:
```json
{ "permissions": { "deny": ["mcp__sentry__update_issue", "mcp__posthog__update-feature-flag"] } }
```
Traktuj to jako zabezpieczenie zapasowe. Prawdziwą kontrolą tylko do odczytu w Sentry jest zakres OAuth albo `?skills=inspect,seer`, bo `execute_sentry_tool` wywołuje narzędzia katalogu po nazwie, a blokada samego `update_issue` może nie objąć zapisu wysłanego tą drogą.

**Codex**

Prowadź pętlę w CLI albo w aplikacji z podłączonymi serwerami. Narzędzia zapisu odfiltruj po stronie klienta przez `disabled_tools = ["update_issue"]` we wpisie `[mcp_servers.sentry]`, ale traktuj to jako zabezpieczenie zapasowe: prawdziwą kontrolą tylko do odczytu jest zakres OAuth albo `?skills=inspect,seer`, bo `execute_sentry_tool` wywołuje narzędzia katalogu po nazwie, a filtr na samym `update_issue` może go nie objąć. `codex review --base main` może przejrzeć gałąź z poprawką z kroku 4 jako drugi model.

**Cursor**

Kroki 1–3 prowadź w trybie planowania (Plan Mode) i przejrzyj diff, zanim go zaakceptujesz. Jak w każdym kliencie, skuteczne są kontrole po stronie serwera: uprawnienia OAuth w Sentry albo `?skills=inspect,seer`, `--disable-write` i lista `tools` w PostHogu. Filtry po stronie klienta to tylko zabezpieczenie zapasowe.

## Skąd wiesz, że poprawka zadziałała?

Sprawdzasz dowody, a nie podsumowanie agenta:

- **Istnieje test odtwarzający błąd i najpierw był czerwony.** Na starym kodzie test musi paść z tym samym wyjątkiem co zdarzenie w Sentry. Test, który tylko przechodzi, niczego nie dowodzi o tym incydencie.
- **Pull request linkuje źródła.** Identyfikator zgłoszenia w Sentry, alert i okno incydentu są w opisie, więc recenzent sprawdza poprawkę względem dowodów i nie musi ich odtwarzać.
- **Bramki CI zostają obowiązkowe.** Testy, sprawdzanie typów i lint działają przed scaleniem, jak przy każdej zmianie. Serwery obserwowalności dodają dowody, ale nie zastępują bramek.
- **Progi ustalasz przed wdrożeniem.** Warunek zaliczenia (zero zdarzeń w nowym wydaniu, odsetek błędów poniżej celu, lejek w granicach tolerancji) wpisz do pull requesta i sprawdź w kroku 5. Ustawianie poprzeczki po obejrzeniu liczb to sposób, w jaki częściowa poprawka zostaje uznana za skończoną.
- **Rozwiązuje człowiek.** Dyżurny inżynier rozwiązuje zgłoszenie w Sentry i zatwierdza zamknięcie incydentu. Wyłączony `triage` sprawia, że to reguła wymuszona technicznie, a nie umowna.
- **Wycofanie jest gotowe.** Jeśli krok 5 nie przejdzie, wycofaj zmianę zwykłym pipeline’em i wróć do kroku 2.

## Co psuje się w MCP do obserwowalności i jak to naprawić?

**`claude mcp add sentry https://mcp.sentry.dev/mcp` do niczego się nie łączy.** Bez `--transport http` Claude Code 2.1.283 przyjmuje to polecenie i zapisuje serwer stdio, którego komendą jest URL. Usuń go przez `claude mcp remove sentry -s project` i dodaj ponownie z flagą.

**Sentry odrzuca twój token.** Sprawdź, czy nie wysłałeś `Authorization: Bearer`. Sentry rezerwuje `Bearer` dla tokenów OAuth MCP; tokeny bezpośrednie używają `Sentry-Bearer`. W Codeksie oznacza to `env_http_headers`, a nie `--bearer-token-env-var`.

**Grafana startuje, ale wywołania narzędzi się nie udają.** `GRAFANA_URL` wskazuje zły stack albo konto serwisowe nie ma odpowiedniej roli. Viewer wystarcza do dashboardów, zapytań do źródeł danych i incydentów; narzędzia Sift wymagają roli Editor. `GRAFANA_API_KEY` jest przestarzały, używaj tokenu konta serwisowego.

**Brakuje `find_error_pattern_logs`.** Usunęła je flaga `--disable-write`. Dodaj `--enable-write-tools=find_error_pattern_logs,find_slow_requests`, jeśli akceptujesz, że Sift tworzy rekordy dochodzeń.

**Zapytania do Lokiego przekraczają limit czasu albo zwracają zalew danych.** Szeroki selektor w długim przedziale czasu skanuje dużo danych. Proś o wąski selektor strumienia i krótkie okno, a na serwerze ustaw `--loki-guardrail-mode=enforce`, żeby odrzucał zapytania bez ograniczeń i podpowiadał agentowi, jak je zawęzić.

**Logowanie do Datadoga się nie udaje albo zapytania nic nie zwracają.** Najpierw sprawdź region: host MCP musi pasować do regionu twojego Datadoga. Popraw URL i zaloguj się ponownie. We wtyczce `/ddsetup` pomaga ustawić region, a `/ddconfig` sprawdza region, uwierzytelnianie i dostęp sieciowy.

**Sesja zwalnia, a agent zapomina instrukcje.** Schematy narzędzi i skille wtyczek zapełniają kontekst. Sprawdź `/context`, zastąp wtyczkę PostHoga adresem z listą dozwolonych narzędzi i użyj wtyczki Sentry z subagentem.

**Agent wykonuje polecenia z treści komunikatu błędu.** Komunikaty zdarzeń, breadcrumbs i linie logów zawierają dane od użytkowników i trafiają do modelu jako tekst, który może potraktować jak instrukcje. Trzymaj narzędzia zapisu wyłączone, nie łącz w sesjach produkcyjnych innych serwerów z prawem zapisu i przeczytaj artykuł o [bezpieczeństwie MCP](/pl/ecosystem/mcp/mcp-security/), zanim podłączysz produkcję. Zdarzenia mogą też zawierać dane osobowe, które potem zostają w transkrypcie sesji. Usuwaj je w SDK, zanim trafią do Sentry.

Ogólne problemy z połączeniem opisuje artykuł o [problemach z połączeniem MCP](/pl/ecosystem/mcp/mcp-connection-issues/).

**Pułapki, które wyglądają dobrze, a są błędne (sprawdzone 26.09.2026)**

- `@leval/mcp-grafana`: społecznościowy port w TypeScripcie. Oficjalny serwer to PyPI `mcp-grafana` (`uvx mcp-grafana`) albo obraz Dockera `grafana/mcp-grafana`.
- `npx sentry-mcp`: niezwiązany z Sentry pakiet osoby trzeciej w npm (0.0.1); uruchomienie go wykonuje kod nieznanej osoby (sprawdzone 26.09.2026).
- `@grafana/mcp`, `@datadog/mcp-server`, `@sentry/mcp`: to nie są pakiety dostawców. Pakiet stdio Sentry to `@sentry/mcp-server` (0.42.0), przeznaczony dla Sentry hostowanego samodzielnie; jego narzędzia wyszukiwania AI wymagają osobnego klucza dostawcy LLM.
- `@modelcontextprotocol/server-sentry`: nie ma go w npm. Dawny serwer referencyjny Sentry jest zarchiwizowany.
- `PostHog/mcp` na GitHubie: zarchiwizowane. Serwer żyje w monorepo `PostHog/posthog`.
- `claude mcp add --url …`: `--url` to flaga Codeksa; Claude Code używa `--transport http <nazwa> <url>`.
- `headers = {…}` w `config.toml` Codeksa: po cichu ignorowane. Właściwe klucze to `http_headers`, `env_http_headers` i `bearer_token_env_var`.

## Dokąd dalej z MCP do obserwowalności

- [Reagowanie na incydenty z pomocą AI](/pl/workflows/operate/incident-response/) — Proces incydentowy wokół tej pętli: role, bezpieczne działania naprawcze i post-mortemy.
- [Monitoring i obserwowalność](/pl/workflows/operate/monitoring-observability/) — Agent instrumentuje serwis przez OpenTelemetry i testuje alerty, które czytają te serwery.
- [Startowy zestaw MCP](/pl/ecosystem/mcp/essential-servers/) — Miejsce Sentry wśród pięciu serwerów, które większość zespołów instaluje najpierw.
- [Obserwowalność agentów](/pl/workflows/operate/agent-observability/) — Ta sama Grafana lub ten sam Datadog dla telemetrii samych agentów: koszt, przebiegi i wywołania narzędzi.
