Jak dodać serwer MCP do Claude Code krok po kroku

Claude Code

Jak dodać serwer MCP do Claude Code krok po kroku

W skrócie

MCP (Model Context Protocol) to otwarty standard, dzięki któremu Claude Code, narzędzie CLI od Anthropic, rozmawia z systemami spoza swojego świata - bazami danych, serwisami API, narzędziami firmowymi. Dodanie serwera MCP rozszerza możliwości agenta o konkretne narzędzia: zamiast tylko czytać kod, może odpytać bazę, sprawdzić zgłoszenie w repozytorium albo pobrać aktualną dokumentację biblioteki. Konfiguracja jest prosta, jeśli rozumiesz trzy rzeczy: jaką komendą uruchamia się serwer, w jakim zasięgu ma być dostępny i jak przekazać mu poświadczenia. Przejdźmy to po kolei.

Jak to wygląda w praktyce

Dodanie serwera to jedna komenda. Na przykład, żeby podłączyć popularny serwer do PostgreSQL, wpisujesz w terminalu:

$ claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres "postgres://user:haslo@localhost:5432/mojabaza"
Added stdio MCP server postgres with command: npx ...

Od tego momentu w sesji Claude Code, po wpisaniu /mcp, zobaczysz serwer na liście, a agent zyska jego narzędzia - w tym przypadku możliwość odpytywania bazy. Podwójny myślnik -- oddziela argumenty komendy claude mcp add od komendy uruchamiającej sam serwer, co jest łatwe do przeoczenia.

Dlaczego Claude Code tak działa

Claude Code sam nie zawiera integracji z bazami czy API - byłoby ich zbyt wiele i szybko by się dezaktualizowały. Zamiast tego opiera się na standardzie MCP: każdy dostawca (albo Ty) pisze mały serwer, który wystawia narzędzia w jednolitym formacie, a Claude Code je po prostu podłącza. Serwery dzielą się na typy transportu: stdio (Claude Code uruchamia serwer jako lokalny podproces), SSE i HTTP (serwer zdalny, do którego narzędzie się łączy przez sieć). Konfiguracja ma też zasięg: local (tylko dla Ciebie w tym projekcie), project (zapisany w pliku .mcp.json w repozytorium, współdzielony z zespołem) i user (dla Ciebie we wszystkich projektach). Dobór zasięgu decyduje o tym, kto i gdzie zobaczy serwer.

Jak to rozwiązać krok po kroku

1. Wybierz serwer MCP, który Ci pasuje - istnieje wiele gotowych, na przykład do GitHuba, PostgreSQL, systemu plików czy dokumentacji. Sprawdź, jaką komendą się go uruchamia (zwykle przez npx dla Node albo uvx dla Pythona).
2. Dodaj serwer stdio komendą claude mcp add <nazwa> -- <komenda uruchamiajaca>. Pamiętaj o podwójnym myślniku -- przed komendą serwera.
3. Ustaw zasięg flagą -s: claude mcp add -s user ... dla dostępu we wszystkich projektach, -s project dla współdzielenia z zespołem, a domyślnie serwer trafia do zasięgu lokalnego.
4. Poświadczenia (klucze API, hasła) przekaż bezpiecznie przez zmienne środowiskowe flagą -e, na przykład -e GITHUB_TOKEN=twoj_token, zamiast wklejać je na stałe do współdzielonej konfiguracji.
5. Dla serwera zdalnego podaj typ transportu i adres: claude mcp add --transport sse <nazwa> <url> albo --transport http, w zależności od tego, co udostępnia dostawca.
6. Serwer współdzielony z zespołem zapisuje się w pliku .mcp.json w katalogu projektu - zatwierdź go w repozytorium, żeby reszta zespołu miała tę samą konfigurację (bez wpisanych na sztywno sekretów).
7. Sprawdź listę dodanych serwerów komendą claude mcp list, a szczegóły konkretnego przez claude mcp get <nazwa>.

Jak sprawdzić, że zadziałało

Uruchom Claude Code w projekcie i wpisz w sesji /mcp - nowy serwer powinien mieć status "connected", a po rozwinięciu zobaczysz listę narzędzi, które udostępnia. Ostateczny test to zlecenie zadania korzystającego z serwera: dla bazy poproś "wypisz nazwy tabel", dla GitHuba "pokaż otwarte zgłoszenia w tym repozytorium". Jeśli agent skorzysta z narzędzia MCP i zwróci realny wynik z podłączonego systemu, integracja działa poprawnie.

Wróć do listy: 100 najczęstszych problemów z Claude Code

Szkolenie Claude Code - od zera do zespołu agentów AI -->

Szkolenie Claude Code - od zera do zespołu agentów AI

Tryb planowania, tryby uprawnień, komendy, MCP, hooki i systemy multi-agent - wszystko na żywym kodzie podczas trzydniowego szkolenia. Prowadzi Łukasz Matuszewski. Szkolenie ma terminy gwarantowane - odbędzie się niezależnie od liczby zgłoszeń.

Sprawdź szkolenie Claude Code

To szkolenie może być dofinansowane dla Ciebie z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5