Sześć serwerów MCP, które warto zachować w Claude Code, oraz te, które należy usunąć
Optymalizacja przeciążonego zestawu MCP: Context7, GitHub, Postgres MCP Pro, Playwright, Sentry oraz Brave Search, wraz z określeniem zakresu projektu i audytem liczby narzędzi poniżej 50.
Źródła: *I Tested 8 MCP Servers With Claude Code. These Were Actually Worth Keeping*
Agent kodujący, który ma za zadanie przeszukać lokalną folder src w poszukiwaniu przestarzałej funkcji autoryzacji, może trafić w dziwne miejsca. W jednym z realistycznych przypadków agent pomija system plików, łączy się z serwerem Jira MCP zainstalowanym tydzień wcześniej i zaczyna przeszukiwać listę zaległych zgłoszeń w poszukiwaniu nazwy tej funkcji. Wpisanie /mcp wyjaśnia dlaczego: działało wtedy 14 serwerów, które udostępniały 73 narzędzia. Mniej więcej od 50 widocznych narzędzi model przestaje odróżniać podobne rozwiązania i zaczyna zgadywać. Dodatkowo, zanim wpisano pierwsze słowo, na schematy JSON narzędzi, których nikt nie używał, przeznaczono około 18 000 tokenów na ruch.
Niezależnie od tego, z którym serwerem nawiązuje się połączenie, jego lista narzędzi trafia do komendy systemowej. Jeśli celem jest agent, który dokona prawidłowego wyboru od pierwszej próby, te pozycje stanowią ograniczony budżet.
Context7 dla aktualnych dokumentacji
Agenci często piszą kod na podstawie API, które później uległy zmianie. Jeśli poprosisz o proces autoryzacji w Supabase, wynik może wykorzystywać metody zdeprecjonowane już w 2025 roku. Context7 rozwiązuje ten problem poprzez włączanie dokumentacji biblioteki z określoną wersją do promptu.
# Add --scope project (or -s project) to write the entry into
# a committable .mcp.json instead of your personal ~/.claude.json.
# Context7 provides current, version-pinned library docs
# Canonical path is the installer (OAuth + generates an API key):
npx ctx7 setup
# Or wire the remote server manually (key from context7.com/dashboard):
claude mcp add --transport http context7 https://mcp.context7.com/mcp \
--header "CONTEXT7_API_KEY: <YOUR_KEY>"
Gdy jest już zainstalowany, agent pobiera aktualny Markdown i zapisuje obecną implementację. Musisz mu zaufać jeśli chodzi o jego indeks, ale dla popularnych frameworków internetowych jest to pierwszy serwer wart zainstalowania.
GitHub do zarządzania problemami i wnioskami o pull request
Poproś agenta o naprawienie problemu nr 8009 – zazwyczaj zatrzyma się i poprosi o opis, ponieważ nie może zobaczyć zdalnego repozytorium. Oficjalny serwer MCP GitHub udostępnia narzędzia do śledzenia problemów, obsługi wniosków o pull request oraz wyszukiwania kodu w zdalnych repozytoriach.
# GitHub — OFFICIAL server (issues, PRs, repo search).
# For Claude Code 2.1.1+:
claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer <YOUR_GITHUB_PAT>"}}'
# For Claude Code 2.1.0 or earlier (legacy flag form):
# claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer <YOUR_GITHUB_PAT>"
Po tym zadanie typu „przegląd PR #8042” działa poprawnie: agent pobiera różnice, czyta komentarze recenzentów, przyporządkowuje je do lokalnych plików i wprowadza zmiany. Należy preferować własny serwer GitHuba zamiast starszych narzędzi od stron trzecich.
Postgres MCP Pro dla rzeczywistych schematów
Agent, który próbuje zgadnąć schemat bazy danych, generuje błędy takie jak column 'created_at' does not exist. Postgres MCP Pro dostarcza mu narzędzia takie jak list_schemas i get_object_details, dzięki czemu może przyporządkować rzeczywistą bazę danych przed napisaniem zapytania SQL.
# Postgres MCP Pro — schema-aware SQL, READ-ONLY restricted mode
pipx install postgres-mcp
# Add the server with the restricted access flag
claude mcp add postgres --env DATABASE_URI="postgresql://user:pass@localhost:5432/db" \
-- postgres-mcp --access-mode=restricted
W środowisku testowym lub produkcyjnym flaga --access-mode=restricted nie jest opcjonalna. Wyłącza operacje INSERT, UPDATE i DELETE na poziomie serwera, dzięki czemu agent nie może usuwać tabel podczas eksploracji.
Playwright MCP do weryfikacji
Agenci chętnie twierdzą, że klasa CSS naprawiła błąd w układzie, nawet bez renderowania strony. Playwright MCP umożliwia agentowi sprawdzenie własnej pracy poprzez uruchomienie bezobsługowego przeglądarki.
# Playwright (Microsoft) — agent drives a real browser to verify its own change
claude mcp add playwright npx @playwright/mcp@latest
Zamiast interpretować surowy zrzut ekranu, agent czyta drzewo dostępności, dzięki czemu wie, gdzie znajduje się przycisk w DOM i czy użytkownik może go zobaczyć.
Playwright steruje przeglądarką i testuje DOM. Chrome DevTools MCP to odrębne narzędzie przeznaczone do analizy sieci i wydajności. Dodawaj serwer DevTools tylko wtedy, gdy aktywnie rozwiązujesz problemy sieciowe, ponieważ Playwright lepiej radzi sobie z weryfikacją wizualną.
Sentry do błędów w produkcji
Zmniejszony do minimum ślad błędu React wklejony do terminala rzadko pomaga, ponieważ wersje produkcyjne usuwają mapy źródłowe. Oficjalny serwer MCP Sentry przynosi do okna kontekstowego niezmniejszony ślad błędu, informacje pomocnicze oraz dane środowiskowe.
# Sentry — OFFICIAL remote server; pulls live stack traces
# Triggers OAuth on first launch
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
Gdy użytkownik zgłasza awarię, agent może otrzymać polecenie sprawdzenia najnowszego problemu frontendu w Sentry i naprawić go, korzystając z dokładnej linii kodu oraz stanu zmiennych w momencie awarii.
Brave Search – szybsze znalezienie rozwiązań
Dwadzieścia minut może zniknąć na rozwiązanie tajemniczego błędu esbuild, podczas gdy poprawka znajduje się w issue na GitHubie otwartym dwa dni wcześniej. Dane treningowe agenta były zbyt stare, by to rozpoznać, więc programista musi opuścić terminal i szukać ręcznie.
# Brave Search — OFFICIAL server from Brave (the @modelcontextprotocol/*
# package was archived May 2025)
# Requires a free API key from api-dashboard.search.brave.com
claude mcp add brave-search --env BRAVE_API_KEY="<YOUR_KEY>" \
-- npx -y @brave/brave-search-mcp-server --transport stdio
To daje agencie narzędzie do wyszukiwania w sieci w czasie rzeczywistym. W przypadku niejasnego błędu pobiera najnowsze odpowiedzi z StackOverflow lub strony stanu dostawcy bez opuszczania terminala.
Zabezpiecz konfigurację
Zanim dodasz coś nowego, popraw konfigurację i sprawdź, co jest uruchomione. Dodanie parametru --scope project do dowolnego polecenia instalacji zapisuje dane do pliku .mcp.json w repozytorium zamiast do globalnego pliku ~/.claude.json, dzięki czemu cały zespół korzysta z tego samego zestawu narzędzi.
Plik referencyjny dla powyższych serwerów, wraz z dwoma elastycznymi slotami, wygląda w ten sposób. Elastyczne sloty to utrzymywany serwer Filesystem umożliwiający dostęp do katalogów poza aktualnym projektem oraz Sequential-thinking, który pomaga agencie śledzić własną logikę podczas dużych modyfikacji.
{
"mcpServers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp",
"headers": { "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY}" }
},
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp",
"headers": { "Authorization": "Bearer ${GITHUB_PAT}" }
},
"sentry": {
"type": "http",
"url": "https://mcp.sentry.dev/mcp"
},
"postgres": {
"command": "postgres-mcp",
"args": ["--access-mode=restricted"],
"env": { "DATABASE_URI": "${DATABASE_URI}" }
},
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp@latest"]
},
"brave-search": {
"command": "npx",
"args": ["-y", "@brave/brave-search-mcp-server", "--transport", "stdio"],
"env": { "BRAVE_API_KEY": "${BRAVE_API_KEY}" }
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "${HOME}/projects"]
},
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
}
}
}
Wpisy wykorzystują dwa sposoby transporту. Przy użyciu http serwer stanowi zdalną API, a cała jej logika jest wykonywana po stronie dostawcy. Przy użyciu stdio, podobnie jak w przypadku Playwright lub Postgres, z tablicy command uruchamiany jest lokalny proces, więc odpowiednie binarne pliki muszą najpierw zostać zainstalowane na maszynie. Sekrety są przekazywane poprzez interpolację środowiskową, na przykład ${DATABASE_URI}, co zapewnia bezpieczeństwo pliku podczas komitowania.
Aby zobaczyć, ile narzędzi jest potrzebnych do takiej konfiguracji, sprawdź sesję na żywo:
# List every configured server and its connection status
claude mcp list
# Inside a Claude Code session, inspect connected servers and their tools:
# Type /mcp
# This shows each server, its tool count, and lets you toggle tools.
Suma narzędzi jest pokazywana na interfejsie. Jest tam blisko pięćdziesięciu widocznych narzędzi – wyłącz te, które nie są potrzebne w danej sesji.
Usuń niepotrzebne elementy
Gdy masz już bazę odniesienia, usuń to, co nie należy tam dołączyć.
- Serwery referencyjne w archiwum. Stara implementacja Postgresa (
@modelcontextprotocol/server-postgres) nadal pojawia się w przestarzałych instrukcjach, ale nie jest już utrzymywana. Zastąp ją wersją Postgres MCP Pro. - Wrappers od stron trzecich. Wrappers społecznościowe dla GitHub, Sentry i podobnych usług pojawiły się w 2025 roku jako tymczasowe rozwiązania, które opóźniają aktualizacje oficjalnych API. Tam, gdzie istnieje oficjalny serwer dostawcy, usuń wersję społecznościową.
- Cokolwiek, co powtarza wbudowane funkcje. To właśnie tutaj występują kolizje narzędzi. Specjalny serwer do wykonywania shellów daje agencie dwa sposoby uruchomienia basha. W jednym udokumentowanym przypadku błędu agent użył narzędzia
execute_scriptod third party do prostego polecenianpm install, napotkał błąd ścieżki, a następnie napisał własny skrypt w Pythonie, aby uruchomić instalację, ignorując wbudowany shell. Jeśli klient już potrafi pobierać URL-y lub czytać pliki, nie wydawaj zasobów na serwer, który robi to samo.
Kontynuuj audyt
Sprawdź ponownie plik .mcp.json, gdy sesja działa wolno. Sprawna konfiguracja zapewnia działanie sześciu głównych serwerów i pozostawia margines poniżej progu 50 narzędzi. Typowym przykładem problemu jest serwer Slack MCP – agent ciągle przegląda historię kanału, gdy ma wyszukać dane w lokalnych logach, przez co wydajność spada. Kandydat na ósme miejsce, np. MCP od Linear do importowania kryteriów akceptacji do edytora, musi udowodnić swoją przydatność; jeśli zwiększy liczbę narzędzi zbytnio, inne zostaną usunięte.
Gdy agent ostatnio działa wolno, zapisz obecną konfigurację, a następnie spróbuj używać tylko tych sześciu głównych serwerów przez kilka dni. Uruchom polecenie /mcp, aby sprawdzić ich wpływ na wydajność i zobaczyć, czy model wybiera narzędzia skuteczniej. Wróć do pozostałych serwerów dopiero wtedy, gdy osiągniesz limit, którego nie mogą przezwyciężyć wbudowane funkcje Claude Code.
Literatura pokrewna
- Wyjaśnienie subagentów Claude Code: czym są i kiedy ich używać — W jaki sposób subagenty Claude Code różnią się od umiejętności i zespołów agentów: izolacja kontekstu, pierwszy dostosowany subagent, zasady opisywania i używania narzędzi oraz sytuacje, gdy można ich pominąć.
- Dlaczego agenci do programowania wciąż mają problemy z kodem prywatnych firm — Real-SWE testuje osiem agentów do programowania na licencjonowanych bazach kodu prywatnych. Najlepszy z nich rozwiązuje 38,8 procent zadań, a pięć kategorii niepowodzeń pokazuje, gdzie agenci popełniają błędy.