Poradnik

Jak podłączyć serwery MCP do Claude Code

Serwery MCP dają Claude Code dostęp do narzędzi spoza twojego kodu, takich jak system zgłoszeń, baza danych czy narzędzie do projektowania. Ten poradnik pokazuje polecenia do dodania serwera, gdzie zapisywane jest ustawienie, jak się zalogować i jak sprawdzić, czy działa.

Zaktualizowano 30 października 2026

Krótka odpowiedź: dla serwera zdalnego uruchom claude mcp add --transport http name https://server/mcp; dla lokalnego claude mcp add name -- command args. Dodaj --scope user, żeby używać go w każdym projekcie, lub --scope project, żeby udostępnić go przez .mcp.json. Potem otwórz Claude Code, wpisz /mcp, żeby się zalogować, jeśli trzeba, i sprawdź, czy serwer jest połączony.

Polecenia opisane poniżej są zgodne z dokumentacją Claude Code od Anthropic z października 2026. Polecenia claude mcp uruchamiasz w zwykłym terminalu, a nie w sesji Claude Code. Interfejs Claude Code jest po angielsku, więc komunikaty i statusy podajemy w oryginale.

Dodaj serwer zdalny (najczęstszy przypadek)

Usługa w chmurze podaje adres swojego serwera MCP, który znajdziesz w jej instrukcji konfiguracji. Anthropic poleca dla takich serwerów transport HTTP.

W terminalu przejdź (cd) do projektu, w którym będziesz go używać.
Uruchom claude mcp add --transport http notion https://mcp.notion.com/mcp, wstawiając własną nazwę i adres. Nazwę zobaczysz na listach i w /mcp.
Jeśli usługa zamiast logowania używa klucza API, przekaż go jako nagłówek: --header "Authorization: Bearer your-token".

Starsze serwery mogą oferować tylko SSE, który jest przestarzały. Nowsze wersje Claude Code próbują najpierw HTTP i same przechodzą na SSE; w starszych wersjach użyj --transport sse.

Dodaj serwer lokalny

Serwer lokalny (stdio) to program działający na twoim komputerze, często uruchamiany przez npx.

Najpierw wpisz opcje Claude, potem --, a potem polecenie samego serwera: claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server.
Claude Code przekazuje wszystko, co następuje po --, prosto do programu serwera. Bez tego separatora flagi przeznaczone dla serwera (takie jak -y) są odczytywane jako opcje Claude Code.
Gdy używasz --env, wstaw inną opcję między nią a nazwą serwera, jak w przykładzie, inaczej nazwa zostanie odczytana jako kolejna zmienna.

Wybierz zakres

Zakres	Gdzie działa	Zapisywany w
`local` (domyślny)	W tym projekcie, tylko dla ciebie	`~/.claude.json`, pod ścieżką projektu
`project`	W tym projekcie, dla każdego, kto go sklonuje	`.mcp.json` w głównym folderze projektu (zatwierdź go w repozytorium)
`user`	We wszystkich twoich projektach	`~/.claude.json`

Wybierz user dla narzędzi, które chcesz mieć wszędzie, na przykład aplikacji do notatek, a project dla narzędzi potrzebnych całemu zespołowi w jednym repozytorium. Jeśli jeden serwer jest zdefiniowany w kilku miejscach, Claude Code łączy się z nim raz, w tej kolejności priorytetu: local, project, user, potem serwery z wtyczek, a na końcu konektory claude.ai. Trzy zakresy są dopasowywane po nazwie; serwery z wtyczek i konektory liczą się jako duplikaty, gdy wskazują ten sam adres lub polecenie. Zwycięski wpis jest używany w całości; pola nie są łączone.

Nie wpisuj sekretów bezpośrednio do udostępnianego .mcp.json. Plik akceptuje zmienne, takie jak ${API_KEY} czy ${API_BASE_URL:-https://api.example.com}, które każda osoba ustawia we własnym środowisku.

Zaloguj się do serwera, który wymaga konta

Uruchom Claude Code poleceniem claude.
Wpisz /mcp. Panel pokazuje serwery, do których musisz się jeszcze zalogować.
Wybierz serwer i przejdź logowanie w przeglądarce. Token jest przechowywany na twoim komputerze i odświeżany automatycznie.
Możesz też uruchomić w powłoce claude mcp login name. Wylogujesz się poleceniem claude mcp logout name.

Niektóre usługi wymagają, żeby najpierw zarejestrować u nich aplikację. W takim przypadku dodaj serwer z --client-id, --client-secret (zostaniesz poproszony o jego wpisanie) i, jeśli ich instrukcja wymaga stałego adresu przekierowania, --callback-port.

Sprawdź, czy działa

claude mcp list pokazuje każdy serwer z jego statusem: Connected (połączony), Needs authentication (wymaga logowania), Failed to connect (nie udało się połączyć), Pending approval (czeka na zgodę) lub Disabled for this project (wyłączony w tym projekcie).
claude mcp get name pokazuje szczegóły jednego serwera, w tym błąd HTTP, gdy coś nie działa.
W sesji /mcp pokazuje ten sam status i pozwala połączyć się ponownie.
Na koniec poproś Claude o coś, co potrafi zrobić tylko ten serwer, na przykład „pokaż moje otwarte zgłoszenia w Linear”.

Serwer usuniesz poleceniem claude mcp remove name.

Warto wiedzieć

Serwery projektu najpierw pytają: gdy sesja po raz pierwszy znajdzie serwery w pliku .mcp.json repozytorium, Claude Code prosi cię o ich zatwierdzenie. Swoje decyzje cofniesz poleceniem claude mcp reset-project-choices. Zatwierdzaj tylko serwery z repozytoriów, którym ufasz.
Uprawnienia nadal obowiązują: każde wywołanie narzędzia MCP może pytać cię o zgodę jak każde inne narzędzie; zobacz poradnik jak zarządzać uprawnieniami w Claude Code.
Duże wyniki: Claude Code ostrzega, gdy narzędzie zwraca więcej niż 10 000 tokenów, i domyślnie ogranicza wynik do 25 000. Limit podniesiesz zmienną środowiskową MAX_MCP_OUTPUT_TOKENS.
Wtyczki: niektóre wtyczki zawierają własne serwery MCP, więc instalacja wtyczki może być prostszą drogą; zobacz poradnik jak instalować wtyczki w Claude Code.

Jeśli to nie działa

Failed to connect: uruchom claude mcp get name, żeby zobaczyć błąd, sprawdź adres URL, a potem w sesji uruchom /mcp reconnect all (nowsze wersje), żeby spróbować ponownie.
Wolny serwer lokalny przekracza limit czasu przy starcie: uruchom Claude Code z dłuższym limitem, na przykład MCP_TIMEOUT=10000 claude (w milisekundach).
„has a url but no type”: we wpisie JSON dla serwera zdalnego brakuje "type": "http".
Klucz API jest odrzucany: Claude Code ostrzega o spacjach lub znakach nowej linii na początku lub końcu nagłówka. Dodaj serwer ponownie ze starannie wklejonym tokenem.

Źródła

Claude Code user FAQ (Centrum pomocy Claude, sprawdzono 30 października 2026)
Connect Claude Code to tools via MCP (Claude Code Docs, sprawdzono 30 października 2026)

Najczęściej zadawane pytania

Czy to to samo co konektory na claude.ai?

Są powiązane, ale konfiguruje się je osobno. Konektory z claude.ai też mogą wczytać się w Claude Code, ale mają najniższy priorytet: jeśli serwer dodany przez claude mcp add wskazuje ten sam adres, używany jest twój. Zobacz nasz poradnik o konektorach Claude w aplikacji webowej i desktopowej.

Czy usunięcie serwera wylogowuje mnie z usługi?

Nie całkiem. claude mcp remove usuwa zapisane logowanie na twoim komputerze, ale go nie unieważnia. Jeśli chcesz unieważnić token, najpierw uruchom claude mcp logout name.

Czy mogę dodać serwer z fragmentu JSON?

Tak. Działa claude mcp add-json name, a po nim konfiguracja JSON. Dla serwera zdalnego dodaj w JSON "type": "http", inaczej zostanie potraktowany jako lokalne polecenie i nie zadziała.