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

Dodatkowe instrukcje dotyczące pracy z Ailoot znajdziesz w dokumentacji.

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

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).

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?#

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

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ę oraz Subagenci Claude Code: 5 gotowych przykładów.

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

Pełna składnia z oficjalnej dokumentacji:

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:

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. Sprawdź README wybranego serwera MCP, aby poznać jego konkretne polecenia.

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

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

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#

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):

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.

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ą:

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):

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.

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):

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):

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.

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):

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.

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):

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.

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#

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:

{
  "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, a nie dawną formę najwyższego poziomu decision: approve/block:

#!/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 — zastosowano tam podobną logikę „sprawdź przed wykonaniem”.

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

Zgodnie z dokumentacją Claude Code 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.

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

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#

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.

Jak diagnozować problem z połączeniem MCP#

Lista kontrolna krok po kroku:

1. Czy serwer jest widoczny na liście?

   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?

   claude mcp status <name>
   

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

3. Czy logi serwera zawierają przydatne informacje?

   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:

   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#

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:

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 i znasz inżynierię kontekstu, dodanie własnego MCP zajmie dzień. Jeśli nie, lepiej najpierw poznać podstawy.

Aby kontynuować pracę z modelami, przejdź do Ailoot.