# Serwery MCP dla Claude Code w 2026 roku: 7 integracji i instalacja

> Czym jest MCP i jak połączyć się z nim w 5 minut za pomocą polecenia claude mcp add. 7 serwerów: GitHub, Postgres, Slack, Notion, Sentry, Playwright. Lista dozwolonych operacji przez hooks.

Source: https://ailoot.ai/blog/pl/mcp-servers-claude-code/
Canonical: https://ailoot.ai/blog/pl/mcp-servers-claude-code/
Language: pl
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-172
Revision: sha256-f6caee5cc291005d99780613eb9225a768d6f61108bd1140147ebeda0d7e793f


Dodatkowe instrukcje dotyczące pracy z Ailoot znajdziesz w [dokumentacji](https://ailoot.ai/docs/).



## Czym jest serwer MCP i dlaczego Claude Code go potrzebuje?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Najważniejsze informacje w tej sekcji">

Najważniejsze informacje

MCP (Model Context Protocol) to otwarty standard Anthropic, który zapewnia Claude Code dostęp do zewnętrznych narzędzi i danych za pośrednictwem ujednoliconego interfejsu. Jeden protokół zamiast dziesięciu różnych API. Anthropic nazywa go „USB-C dla aplikacji AI”: podłączasz port i Claude może zobaczyć Twoją bazę danych, pocztę elektroniczną, komunikator lub repozytorium.

</div>

Anthropic ogłosił MCP jako otwarty standard 25 listopada 2024 roku. W ciągu roku protokół stał się standardem branżowym: obsługują go OpenAI, Google DeepMind i Microsoft. Oficjalne repozytorium `modelcontextprotocol/servers` zawiera serwery referencyjne samego projektu MCP (Filesystem, Memory, Sequential Thinking, Fetch i inne); dostawcy — GitHub, Notion, Stripe, Linear, Cloudflare i Sentry — publikują serwery MCP we własnych repozytoriach. Indeksy społecznościowe zawierają łącznie tysiące serwerów.

Technicznie MCP działa przez JSON-RPC 2.0. Architektura jest prosta: Twój Claude Code jest klientem, dowolna usługa jest serwerem, a serwer MCP pomiędzy nimi udostępnia trzy elementy: `tools` (co AI może wywołać), `resources` (co AI może odczytać) i `prompts` (gotowe szablony).

<figure>
<blockquote>
Tak jak USB-C zapewnia standardowy sposób łączenia urządzeń z różnymi urządzeniami peryferyjnymi, MCP zapewnia standardowy sposób łączenia modeli AI z różnymi źródłami danych i narzędziami.
</blockquote>
<figcaption>— Model Context Protocol, https://modelcontextprotocol.io/</figcaption>
</figure>

Dlaczego ma to znaczenie dla vibe codera: przed MCP każde połączenie między Claude a usługą zewnętrzną było osobną integracją z własnym wrapperem. Dzięki MCP połączenie Postgresa, Slacka i GitHuba wymaga trzech podobnych poleceń, a odłączenie ich jest równie łatwe, gdy usługa przestaje być potrzebna.

## Czym MCP różni się od Skills i subagentów?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Najważniejsze informacje w tej sekcji">

Najważniejsze informacje

Te trzy mechanizmy wyglądają podobnie, ale rozwiązują różne problemy. Skills to Twoje procesy pracy i prompty zapisane jako kod. Subagenci to osobni, wyspecjalizowani „współpracownicy” z własnym kontekstem. MCP udostępnia zewnętrzne narzędzia, dzięki którym Claude może korzystać z usług i danych. Różnią się też kosztami tokenów: Skill jest najtańszy, a MCP zwykle droższy. Początkowo MCP umieszcza w kontekście tylko nazwy narzędzi i instrukcje serwera; Claude wczytuje pełne opisy na żądanie. Większość kosztów pochodzi z odpowiedzi usług: mogą być duże i pozostawać w rozmowie.

</div>

Prosta tabela, która pomoże zapamiętać różnice:

| Mechanizm | Co to jest | Kiedy go używać | Koszt tokenów |
|----|----|----|----|
| Skill | Plik z instrukcjami i promptami w `.claude/skills/` | Powtarza się proces pracy: napisanie e-maila, przygotowanie raportu, opublikowanie posta | Niski. Wczytywany po wyzwoleniu |
| Subagent | Osobny agent z własnym kontekstem i narzędziami | Długie zadanie równoległe: przegląd, audyt, research | Średni. Własny kontekst |
| Serwer MCP | Usługa udostępniająca narzędzia i zasoby przez JSON-RPC | Potrzebny jest dostęp do bieżących danych: baza danych, poczta, komunikator, repozytorium | Średni lub wysoki. W kontekście pozostają tylko nazwy narzędzi; opisy są wczytywane na żądanie, a odpowiedzi usług mogą być duże |

Praktyczna wskazówka: jeśli zadanie zostało raz opisane i powtarza się jako tekst, jest to Skill. Jeśli AI potrzebuje bieżącej odpowiedzi z systemu zewnętrznego, użyj MCP. Jeśli zadanie jest długie, rozgałęzione i wymaga osobnego umysłu, użyj subagenta.

Więcej o dwóch powiązanych mechanizmach: [Claude Code Skills: jak zbudować własną bibliotekę](https://ailoot.ai/blog/pl/claude-code-skills-library/) oraz [Subagenci Claude Code: 5 gotowych przykładów](https://ailoot.ai/blog/pl/claude-code-subagents/).

## Jak zainstalować serwer MCP: pierwsze polecenie w 5 minut

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Najważniejsze informacje w tej sekcji">

Najważniejsze informacje

We wszystkich przypadkach działa ta sama składnia: `claude mcp add [name] -- [launch command]`. Serwer pojawi się na liście `claude mcp list`. Następnie Claude wykryje narzędzia serwera i zacznie korzystać z nich w rozmowie. Nie trzeba ręcznie edytować konfiguracji — wszystko odbywa się przez CLI.

</div>

Pełna składnia z oficjalnej dokumentacji:

```bash
claude mcp add <name> [options] -- <command> [args...]
```

Obsługiwane są trzy transporty: `--transport stdio` (domyślny, lokalny proces), `--transport http` (zdalny HTTP) i `--transport sse` (oznaczony jako przestarzały; używaj tylko wtedy, gdy serwer nie został jeszcze zmigrowany).

Flaga `--scope` pozwala wybrać jeden z trzech zakresów:

- `local` — tylko w bieżącym folderze projektu (domyślnie).
- `project` — zapisuje ustawienia w `.mcp.json`, które jest zatwierdzane w repozytorium i dostępne dla całego zespołu.
- `user` — globalnie we wszystkich projektach na komputerze.

Minimalny przykład z referencyjnym serwerem Filesystem projektu MCP. Uruchomienie zajmuje pół minuty:

```bash
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects
claude mcp list
```

Po wykonaniu `list` zobaczysz `filesystem` na liście, jeśli folder podany w poleceniu istnieje; bez niego serwer się nie uruchomi. Serwer będzie widzieć foldery robocze Claude Code, czyli folder, z którego go uruchomiono. Poniżej, w sekcji 5.2, wyjaśniam, dlaczego tak jest i kiedy ten serwer faktycznie się przydaje.

Aby sprawdzić, czy MCP jest połączony, uruchom `/mcp` w sesji Claude Code. Zobaczysz wszystkie serwery, ich statusy i listy narzędzi. Dodatkowe instrukcje dotyczące pracy z Ailoot znajdziesz w [dokumentacji](https://ailoot.ai/docs/). Sprawdź README wybranego serwera MCP, aby poznać jego konkretne polecenia.

## stdio czy HTTP: który transport wybrać?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Najważniejsze informacje w tej sekcji">

Najważniejsze informacje

stdio to proces lokalny na Twoim komputerze; wszystko działa bez sieci i nie wymaga OAuth. HTTP to usługa zdalna, do której uzyskuje się dostęp za pomocą tokenu lub OAuth i którą można współdzielić między urządzeniami. Jeśli serwer MCP jest instalowany przez `npx` lub `uvx`, używa stdio. Jeśli usługa ma własny publiczny adres, używa HTTP. SSE jest oficjalnie oznaczony jako przestarzały, więc nie polegaj na nim.

</div>

Porównanie według najważniejszych kryteriów:

| Kryterium | stdio | HTTP |
|----|----|----|
| Gdzie działa | Lokalnie (proces potomny Claude Code) | Serwer zdalny |
| Autoryzacja | Nie jest potrzebna | OAuth 2.1 lub token Bearer |
| Porty sieciowe | Brak | Publiczny adres |
| Przykłady użycia | Filesystem, Postgres, lokalne narzędzia | GitHub, Slack, Notion, Linear, Sentry |
| Ponowne połączenie | Nie jest potrzebne | Wykładniczy backoff, do 5 prób |
| Wdrożenie | Instalacja pakietu lokalnie | Usługa dostawcy |

Praktyczna zasada: wszystko, co jest przechowywane na dysku lub w lokalnej bazie danych, korzysta ze stdio. Wszystko, co znajduje się w chmurze, korzysta z HTTP. SSE jest oficjalnie przestarzały — nie wybieraj go.

## 7 gotowych serwerów MCP dla przedsiębiorców

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Najważniejsze informacje w tej sekcji">

Najważniejsze informacje

Oto siedem konfiguracji, które pokrywają 80% zadań vibe codera: kod (GitHub), pliki (Filesystem), baza danych (Postgres przez DBHub), komunikacja zespołowa (Slack), baza wiedzy (Notion), śledzenie błędów (Sentry) i praca z przeglądarką (Playwright). Przy każdej konfiguracji podaję jednolinijkowe polecenie instalacji i przykład tego, jak dokładnie możesz poprosić Claude o wykonanie zadania w prawdziwej rozmowie.

</div>

### 5.1. GitHub MCP — oficjalny serwer GitHuba

Co robi: zapewnia Claude Code dostęp do issue, pull requestów, plików repozytorium i przebiegów akcji. Serwer jest open source i ma ponad 30 000 gwiazdek na GitHubie.

Instalacja (HTTP przez OAuth):

```bash
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
```

Możesz też użyć stdio przez Dockera, jeśli zamiast OAuth potrzebujesz tokenu PAT.

Przykład: „Przeczytaj otwarte issue oznaczone etykietą `bug`, pogrupuj je według komponentu i zaproponuj kolejność ich zamykania”. Claude wywoła GitHub MCP, odczyta wszystkie issue i zwróci listę uporządkowaną według priorytetu.

Repozytorium: [github/github-mcp-server](https://github.com/github/github-mcp-server).

### 5.2. Filesystem MCP — serwer referencyjny projektu MCP

Co robi: zapewnia AI dostęp do plików na komputerze w zatwierdzonych folderach. Serwer został opublikowany przez sam projekt MCP; w rejestrze npm jako autor figuruje Model Context Protocol a Series of LF Projects, LLC.

Instalacja (stdio) z przypiętą wersją:

```bash
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects
```

Gdy Claude Code się łączy, przekazuje serwerowi swoje foldery robocze, które zastępują wszystko, co podano w poleceniu. Foldery robocze Claude Code to folder uruchomienia oraz foldery dodane poleceniem `/add-dir` lub flagą `--add-dir`. Nie można za pomocą tego polecenia wskazać serwerowi osobnego folderu z makietami. Folder podany w poleceniu nadal musi istnieć, inaczej serwer się nie uruchomi.

W Claude Code ten serwer w większości dubluje więc wbudowane narzędzia. Aby uzyskać dostęp do innego folderu, wystarczy użyć `/add-dir`: wtedy wbudowane narzędzia Claude Code również mogą go odczytać. Serwer jest bardziej przydatny w programach, które nie mają własnego dostępu do plików. W Claude Desktop może wystąpić inny problem: narzędzia serwera są odrzucane, ponieważ ich opisy używają starego formatu schematu; problem nadal nie został rozwiązany.

Przyznawaj dostęp tylko do folderów, których naprawdę potrzebujesz, zarówno w poleceniu, jak i przez `/add-dir`. Nie przyznawaj dostępu do katalogu głównego dysku — to pierwsza luka w zabezpieczeniach.

Przykład: najpierw `/add-dir ~/Documents/design`, a potem: „Przenieś wszystkie makiety z `~/Documents/design/landing-v3/` do bieżącego projektu i zmień ich nazwy zgodnie z konwencją `hero-*.png`”.

### 5.3. Postgres MCP — DBHub (Bytebase)

Co robi: łączy Claude z Postgres, MySQL, SQL Server, MariaDB lub SQLite. Obsługuje tryb tylko do odczytu, dzięki czemu agent AI nie może usunąć bazy danych jednym poleceniem. Często zastępuje zarchiwizowany serwer referencyjny Anthropic `server-postgres`.

Instalacja (HTTP, tylko do odczytu):

```bash
claude mcp add postgres -- npx -y @bytebase/dbhub --dsn "postgresql://user:pass@localhost:5432/mydb?sslmode=disable" --readonly
```

W przypadku produkcyjnej bazy danych zawsze używaj osobnego użytkownika z uprawnieniami tylko do odczytu i anonimizuj dane osobowe przez VIEW lub pośrednią trasę API. Nie łącz się z produkcyjną bazą danych przy użyciu uprawnień do zapisu.

Przykład: „Wyszukaj klientów ze statusem subskrypcji `expired` z ostatniego miesiąca i wypisz 20 osób z najwyższą łączną kwotą płatności”.

Repozytorium: [bytebase/dbhub](https://github.com/bytebase/dbhub).

### 5.4. Slack MCP — komunikacja zespołowa

Co robi: zapewnia Claude dostęp do odczytu kanałów Slacka i wysyłania wiadomości. Przydaje się do automatyzacji: „Gdy kompilacja zakończy się powodzeniem, opublikuj wiadomość na `#releases`”; „Przygotuj cotygodniowe podsumowanie z `#engineering`”.

Instalacja (stdio przez wrapper npx, taki jak `@modelcontextprotocol/server-slack` lub odpowiednik dostawcy):

```bash
claude mcp add slack \
  -e SLACK_BOT_TOKEN=xoxb-... \
  -e SLACK_TEAM_ID=T0... \
  -- npx -y @modelcontextprotocol/server-slack
```

Autoryzacja korzysta z Slack Bot Token; dostęp ograniczają zakresy po stronie Slacka. Możesz przyznać AI tylko `chat:read` i `chat:write:user`, co uniemożliwi mu edycję ustawień obszaru roboczego. Sprawdź README wybranego serwera, aby poznać aktualne polecenia — ekosystem szybko się zmienia.

Przykład: „Codziennie o 9:00 wysyłaj listę PR-ów scalonych poprzedniego dnia na `#daily`”.

### 5.5. Notion MCP — baza wiedzy

Co robi: zapewnia Claude dostęp do stron i baz danych Notion. To baza wiedzy poza twoim projektem: jeśli przechowujesz tam notatki, rejestr klientów lub zasady redakcyjne, AI może je odczytać.

Instalacja (HTTP przez OAuth):

```bash
claude mcp add --transport http notion https://mcp.notion.com/mcp
```

Możesz też użyć oficjalnego pluginu Anthropic `@makenotion/claude-code-notion-plugin`.

Przykład: „W bazie danych Notion ‘Customers’ znajdź wszystkich ze statusem ‘active’, z którymi nie rozmawialiśmy od ponad dwóch tygodni. Przygotuj projekt wiadomości e-mail dla każdej z tych osób”.

Przewodnik Notion: [developers.notion.com/guides/mcp](https://developers.notion.com/guides/mcp/get-started-with-mcp).

### 5.6. Sentry MCP — śledzenie błędów

Co robi: łączy Claude z błędami w Twoim systemie produkcyjnym. Gdy strona zwraca błąd 500, możesz zapytać: „Pokaż 10 najnowszych problemów w Sentry dla tego projektu i wyjaśnij ich przyczyny źródłowe”, a od razu otrzymasz analizę.

Instalacja (HTTP):

```bash
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
```

Autoryzacja odbywa się przez Sentry OAuth. Dostęp można ograniczyć do konkretnego projektu.

Przykład: „Wybierz trzy najczęściej występujące problemy z ostatnich 24 godzin. Wyjaśnij prostym językiem, co się stało, i zaproponuj, jak to naprawić”.

Repozytorium: [getsentry/sentry-mcp](https://github.com/getsentry/sentry-mcp).

### 5.7. Playwright MCP — praca z przeglądarką

Co robi: udostępnia Claude przeglądarkę. AI może otworzyć stronę, kliknąć, wypełnić formularz i zrobić zrzut ekranu. Przydaje się do sprawdzania interfejsu, ręcznych testów po publikacji i analizowania procesów.

Instalacja (stdio):

```bash
claude mcp add playwright -- npx -y @playwright/mcp@latest
```

Wersja v0.0.75, wydana 7 maja 2026 roku, jest aktywnie rozwijana przez Microsoft (ponad 32 000 gwiazdek).

Przykład: „Otwórz stronę główną naszej witryny, sprawdź, czy wszystkie karty wyświetlają się poprawnie, i zrób zrzut ekranu w wersji na komputer i urządzenie mobilne”.

Repozytorium: [microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp).

W README wybranej wersji Playwright MCP sprawdź polecenie z przypiętą wersją, flagę do wielu jednoczesnych sesji oraz typowe błędy instalacji.



## Jak kontrolować bezpieczeństwo za pomocą hooka PreToolUse

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Najważniejsze informacje w tej sekcji">

Najważniejsze informacje

MCP daje AI dużą władzę: może zapisywać dane w bazach, wysyłać wiadomości i usuwać pliki. Hook PreToolUse może kontrolować dopasowane wywołania, ale regex prefiksu SQL nie jest autoryzacją bazy, a matcher wyłącznie Postgres nie obejmuje Slack ani plików. Najpierw użyj rzeczywistych uprawnień usług i plików, a zakres hooka testuj osobno.

</div>

Czarna lista prefiksów SQL nie jest uprawnieniem tylko do odczytu: małe litery, komentarze, `UPDATE`, `INSERT`, `ALTER`, wiele instrukcji i funkcje ze skutkami ubocznymi nie są objęte trzema dużymi prefiksami. Nadaj połączeniu osobną rolę z prawami tylko do odczytu i sprawdź je na jednorazowej bazie testowej. Hook to dodatkowa kontrola wywołań, nie zamiennik uprawnień.

Poniżej celowo wąski **przykład kwarantanny**: odmów wszystkich wywołań trzech nazwanych rodzin serwerów MCP do przeglądu i testu dokładniejszej polityki. Blokuje odczyty i zapisy. Dopasuj rzeczywiste nazwy narzędzi; przemianowany serwer, wbudowany Bash lub inny konektor leży poza wzorcami.

Zapisz osobne reguły w `.claude/settings.json`:

```json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "mcp__postgres__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      },
      {
        "matcher": "mcp__slack__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      },
      {
        "matcher": "mcp__filesystem__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      }
    ]
  }
}
```

Skrypt zapisz jako `.claude/hooks/deny-unapproved-mcp.sh`. Zwraca udokumentowany [kontrakt decyzji PreToolUse](https://code.claude.com/docs/en/hooks#pretooluse-decision-control), a nie dawną formę najwyższego poziomu `decision: approve/block`:

```bash
#!/bin/bash
printf '%s\n' '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"This MCP server family is quarantined pending a reviewed policy."}}'
```

Skrypt nie parsuje ani nie klasyfikuje SQL: zawsze odmawia dopasowanemu wywołaniu. Przed podłączeniem cennych danych w izolowanej sesji sprawdź odmowę dla `SELECT 1`, małego `delete`, `UPDATE` poprzedzonego komentarzem, odczytu lub wysłania Slack i odczytu `.env` Filesystem przy pasujących nazwach. Narzędzie innej rodziny musi pozostać poza przykładem; osobno sprawdź tę granicę.

Dla odczytu bazy użyj sprawdzonych uprawnień i zastąp kwarantannę przejrzaną polityką rzeczywistych narzędzi. Dla Slack użyj poświadczeń bez wysyłania, gdy potrzebny jest tylko odczyt. Dla plików ogranicz dozwolone korzenie serwera i uprawnienia procesu. Nie twierdź, że hook blokuje inne narzędzia, powłokę, załączniki promptu lub politykę edytowalną przez agenta.

To samo podejście opisano szerzej w przewodniku [Plan Mode w Claude Code](https://ailoot.ai/blog/pl/claude-code-plan-mode/) — zastosowano tam podobną logikę „sprawdź przed wykonaniem”.

## Co zrobić, gdy masz ponad 40 narzędzi i Claude się gubi?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Najważniejsze informacje w tej sekcji">

Najważniejsze informacje

Siedem serwerów może łatwo oznaczać 50–100 narzędzi. Claude Code domyślnie korzysta z Tool Search: podczas uruchamiania do kontekstu trafiają tylko nazwy narzędzi i instrukcje serwera, a Claude wczytuje pełny opis, gdy potrzebuje danego narzędzia. Jeśli wyszukiwanie jest wyłączone, wszystkie opisy są wczytywane od razu, a przy około 40 narzędziach Claude zaczyna się gubić: wybiera niewłaściwe narzędzie albo sięga po MCP, choć wystarczyłoby zwykłe polecenie.

</div>

Zgodnie z [dokumentacją Claude Code](https://code.claude.com/docs/en/mcp#scale-with-mcp-tool-search) funkcja jest teraz domyślnie włączona i nie trzeba jej aktywować ręcznie.

Są wyjątki, w których Claude Code od razu wczytuje wszystkie narzędzia: praca przez proxy innej firmy (gdy `ANTHROPIC_BASE_URL` jest ustawiony na adres inny niż Anthropic), modele starsze niż generacja 4.5 w Google Cloud oraz wdrożenia Microsoft Foundry na Azure. Zmienna `ENABLE_TOOL_SEARCH` wpływa na działanie funkcji:

- nieustawiona — wszystkie narzędzia MCP są wczytywane na żądanie;
- `true` — tak samo, a dodatkowo Claude Code próbuje włączyć wyszukiwanie przez proxy;
- `auto` — tryb progowy: gdy wszystkie opisy narzędzi zajmują mniej niż 10% okna kontekstu, są wczytywane od razu; powyżej tego progu ich wczytywanie jest opóźnione;
- `auto:N` — tak samo, ale z własnym progiem procentowym, na przykład `auto:5`;
- `false` — poprzednie zachowanie; wszystkie narzędzia od razu trafiają do kontekstu.

W przypadku narzędzi krytycznych, które mają być zawsze widoczne, możesz użyć flagi `alwaysLoad: true` w `.mcp.json` obok opisu serwera. Każde takie narzędzie od pierwszej chwili zajmuje miejsce w kontekście, więc używaj tej opcji tylko wtedy, gdy Claude potrzebuje go w niemal każdej odpowiedzi.

Jeśli masz co najmniej pięć serwerów MCP, a Claude gubi się przy wyborze narzędzia, najpierw sprawdź, czy wyszukiwanie nie jest wyłączone: poszukaj `ENABLE_TOOL_SEARCH=false` w ustawieniach i sprawdź, czy pracujesz przez proxy.

Może też pomóc [ograniczenie kontekstu za pomocą /compact](https://ailoot.ai/blog/pl/claude-code-token-limits-saving/).

## Kiedy MCP nie jest potrzebne: lepszy będzie Skill, subagent czy CLI?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Najważniejsze informacje w tej sekcji">

Najważniejsze informacje

Pod względem tokenów MCP jest najdroższym sposobem zapewnienia Claude zewnętrznych możliwości. Jeśli zadanie można wykonać za pomocą gotowego narzędzia CLI (`gh issue list`, `psql`, `curl`) lub jednostronicowego Skill, użyj ich zamiast tworzyć serwery MCP. Zasada: MCP ma sens tylko wtedy, gdy AI potrzebuje bieżącej, dwukierunkowej interakcji z usługą, a nie jednorazowej odpowiedzi.

</div>

Hierarchia według kosztu tokenów i złożoności:

1. **Polecenie CLI przez Bash** — niemal bezpłatne. AI uruchamia `gh pr list`, `psql -c` lub `curl` i otrzymuje odpowiedź tak jak zwykły użytkownik terminala.
2. **Skill** — tani. Gotowy szablon promptu z instrukcjami, co wywołać i jak przetworzyć wynik. Wczytywany na podstawie wyzwalacza w nazwie folderu.
3. **Subagent** — średni koszt. Oddzielny kontekst dla długiego zadania, z własną sesją tokenów.
4. **Serwer MCP** — drogi. W kontekście pozostają tylko nazwy narzędzi, ale opis narzędzia jest wczytywany, gdy Claude je znajdzie przed wywołaniem, a odpowiedzi usług mogą być duże: Claude Code ostrzega, gdy odpowiedź narzędzia przekracza 10,000 tokenów. Do tego dochodzi sesja OAuth dla HTTP.

Rada wbrew intuicji: do analizowania stron internetowych, pracy z git, otwierania plików PDF i korzystania z narzędzi open source wybieraj **CLI**, a nie MCP. AI może wywoływać polecenia terminala tak samo jak człowiek, a tokeny są zużywane tylko na polecenie i jego odpowiedź — bez opisów narzędzi i narzutu serwera.

MCP ma uzasadnienie w dwóch przypadkach:

- Usługa jest **zamknięta**: Slack, Notion, Sentry, Linear. Narzędzia CLI też istnieją, ale MCP zapewnia bardziej szczegółowy dostęp przez OAuth i kontrolę scope’ów.
- Potrzebna jest **bieżąca, dwukierunkowa interakcja**: AI łączy się z Postgres, sprawdza schemat, wysyła dodatkowe zapytanie, pobiera dane i wykonuje kolejny krok. W przypadku CLI oznaczałoby to 10 ręcznych poleceń.

## 6 antywzorców połączeń MCP

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Najważniejsze informacje w tej sekcji">

Najważniejsze informacje

Oto sześć konkretnych błędów, które przytrafiają się vibe coderom w pierwszych tygodniach pracy z MCP. Każdy antywzorzec można skorygować w minutę: otwórz `claude mcp list`, przejrzyj listę i sprawdź scope’y oraz hooki. Większość problemów rozwiązuje usunięcie niepotrzebnego serwera, a nie dodanie nowego; ta sekcja to krótka lista kontrolna do przejścia od góry do dołu.

</div>

1. **Szafka z MCP.** Podłączasz 10 serwerów „na wszelki wypadek”; Claude gubi się przy wyborze narzędzia, a odpowiedzi serwerów zapychają kontekst. Rozwiązanie: zostaw 3–5 serwerów dla bieżącego projektu, a resztę usuń poleceniem `claude mcp remove`.

2. **Dostęp do zapisu produkcyjnej bazy danych.** Podłączasz Postgres MCP do produkcyjnej bazy danych bez `--readonly`, oddzielnego użytkownika ani hooka z listą dozwolonych operacji. Jeden prompt — „usuń rekordy testowe” — i dane produkcyjne zostają usunięte. Rozwiązanie: osobna rola bazy ze sprawdzonymi prawami tylko do odczytu, odpowiedni tryb read-only serwera i przetestowane kontrole wywołań. Lista prefiksów `DROP|TRUNCATE|DELETE` nie jest wystarczającą autoryzacją.

3. **PII bez anonimizacji.** Podłączasz bezpośrednio bazę danych zawierającą adresy e-mail, numery telefonów i dane paszportowe klientów. Claude widzi te dane, a one trafiają do logów Anthropic. Rozwiązanie: VIEW lub pośrednia trasa API zwracająca zamaskowane dane, na przykład `j***@gmail.com`.

4. **MCP zamiast Skill.** Potrzebujesz „utworzyć raport sprzedaży w formacie X” — to rutynowe zadanie, które rozwiązuje Skill z gotowym promptem. Nie twórz serwera MCP.

5. **MCP zamiast open source’owego CLI.** Potrzebujesz przekonwertować PDF na tekst. Jest do tego `pdftotext`. Nie buduj „PDF MCP” — to tylko marnowanie tokenów.

6. **Brak śledzenia kosztów tokenów.** Widzisz połączony serwer w `claude mcp list`, ale nie wiesz, ile zasobów wykorzystuje w każdej rozmowie. Po tygodniu nie masz pojęcia, że „MCP zużyło 40% kontekstu, a ja przez cały ten czas za to płaciłem”. Rozwiązanie: okresowo wyłączaj nieużywane serwery i obserwuj zmiany zużycia za pomocą [śledzenia limitów użycia Claude Code](https://ailoot.ai/blog/pl/claude-code-token-limits-saving/).

## Jak diagnozować problem z połączeniem MCP

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Najważniejsze informacje w tej sekcji">

Najważniejsze informacje

Najczęstsze problemy: callback OAuth nie działa, nazwa serwera koliduje z istniejącą albo narzędzie nie pojawia się w `claude mcp list` po wykonaniu `add`. Standardowa procedura rozwiązywania problemów pomaga je naprawić: `list` pokazuje, co się połączyło, `status` sprawdza wskaźnik stanu, a gdy jest czerwony, `logs` zwraca stack trace. Po zmianie `--scope` lub zmiennej ENV uruchom wszystko ponownie.

</div>

Lista kontrolna krok po kroku:

1. **Czy serwer jest widoczny na liście?**

    ```bash
    claude mcp list
    ```

    Jeśli nie, `claude mcp add` nie zakończyło się pomyślnie. Najczęstszą przyczyną jest `--scope`: dodano serwer w zakresie `local`, a sprawdzasz go z innego projektu.

2. **Czy status serwera jest zielony?**

    ```bash
    claude mcp status <name>
    ```

    Czerwony oznacza, że proces się nie uruchomił (stdio) albo serwer nie odpowiedział (HTTP).

3. **Czy logi serwera zawierają przydatne informacje?**

    ```bash
    claude mcp logs <name>
    ```

    Jeśli widzisz stack trace, problem zwykle dotyczy pakietu (`npx` nie znalazł pakietu albo wersja Node jest niższa niż 20).

4. **Czy callback OAuth nie wraca?** Problem zwykle dotyczy `--callback-port` lub filtra sieciowego. Przekieruj konkretny port:

    ```bash
    claude mcp add --transport http --callback-port 8765 [name] [url]
    ```

5. **Konflikt nazw narzędzi?** Dwa serwery udostępniają narzędzie o tej samej nazwie i Claude wywołuje niewłaściwe. Użyj Tool Search (zobacz poprzedni H2) albo ręcznie usuń dodatkowy serwer poleceniem `claude mcp remove`.

6. **Nie widzisz rozszerzeń (connectorów) claude.ai?** To znany problem: rozszerzenia (connectory) z interfejsu internetowego claude.ai nie są dostępne dla Claude Code, gdy używa on klucza API. Rozwiązanie: łącz się z MCP przez CLI, a nie przez interfejs internetowy.

## Co dalej: OAuth, własne serwery MCP i Plugin Marketplace

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Najważniejsze informacje w tej sekcji">

Najważniejsze informacje

Po siedmiu gotowych serwerach kolejne trzy kroki to: OAuth dla własnych serwerów HTTP, jeśli chcesz udostępnić MCP zespołowi; napisanie własnego MCP dla unikatowej usługi; oraz połączenie z Anthropic Plugin Marketplace. Marketplace wystartował 9 października 2025 roku i udostępnia MCP w postaci pluginów instalowanych jednym poleceniem.

</div>

Plugin Marketplace przyspiesza pracę osób, które nie chcą zapamiętywać poleceń instalacyjnych. Format to manifest `.claude-plugin/marketplace.json`, który opisuje zestaw serwerów w jednym pakiecie.

Instalacja pluginu z Marketplace:

```bash
claude plugin install <plugin-name>
```

Plugin może jednocześnie zawierać kilka serwerów MCP, Skills i subagentów — gotową konfigurację do określonego scenariusza, na przykład e-commerce, marketingu lub działu prawnego.

Napisz własny serwer MCP zgodnie ze specyfikacją `modelcontextprotocol.io`. Minimalny szablon korzysta z SDK Anthropic dla języka Python lub TypeScript; następnie opisujesz narzędzia i podłączasz transport. Złożoność jest porównywalna z napisaniem REST API w FastAPI.

Jeśli Twój projekt ma już [skonfigurowany plik CLAUDE.md](https://ailoot.ai/blog/pl/claude-md-template/) i znasz [inżynierię kontekstu](https://ailoot.ai/blog/pl/context-engineering/), dodanie własnego MCP zajmie dzień. Jeśli nie, lepiej najpierw poznać podstawy.

<div class="section" role="doc-bibliography" aria-label="Źródła">

### Źródła

- [Model Context Protocol — oficjalna strona](https://modelcontextprotocol.io/)
- [Anthropic przedstawia MCP — 25 listopada 2024](https://www.anthropic.com/news/model-context-protocol)
- [Dokumentacja Claude Code MCP](https://code.claude.com/docs/en/mcp)
- [Claude Code: MCP Tool Search](https://code.claude.com/docs/en/mcp#scale-with-mcp-tool-search)
- [Ogłoszenie Claude Code Plugins — 9 października 2025](https://claude.com/blog/claude-code-plugins)
- [Code with Claude 2026](https://claude.com/code-with-claude)
- [modelcontextprotocol/servers — oficjalny rejestr](https://github.com/modelcontextprotocol/servers)
- [github/github-mcp-server](https://github.com/github/github-mcp-server)
- [microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp)
- [bytebase/dbhub — Postgres MCP](https://github.com/bytebase/dbhub)
- [getsentry/sentry-mcp](https://github.com/getsentry/sentry-mcp)
- [makenotion/claude-code-notion-plugin](https://github.com/makenotion/claude-code-notion-plugin)
- [Przewodnik Notion MCP](https://developers.notion.com/guides/mcp/get-started-with-mcp)
- [Repozytorium Anthropic Claude Code — issue i changelog](https://github.com/anthropics/claude-code)

</div>





Aby kontynuować pracę z modelami, przejdź do [Ailoot](https://ailoot.ai/).

## Pytania i odpowiedzi

### Czy ten hook uczyni produkcyjną bazę tylko do odczytu?

Nie. Przykład izoluje wszystkie wywołania pasujących rodzin MCP, nie klasyfikuje SQL. Odczyt bazy musi wynikać z osobnej roli ze sprawdzonymi prawami tylko do odczytu; hooki są dodatkową kontrolą.

### Jak sprawdzić zakres hooka?

W izolowanej sesji sprawdź odmowę pasujących nazw przy odczycie i zapisie, także SQL małymi literami lub z komentarzem. Potem sprawdź inne narzędzie poza matcherem; nieobjęta ścieżka wymaga własnych uprawnień lub polityki.


## Ailoot · Firma i jej portfel projektów

Ailoot opiera się na zgromadzonym doświadczeniu operacyjnym, szerokiej bazie klientów, stabilnej usłudze i stałej kontroli KPI.

Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach.

Ailoot wykorzystuje to doświadczenie operacyjne, zapewniając dostęp przez API do funkcji AI w produktach klientów, agentach, aplikacjach i automatyzacjach.
