Czego szukasz?

Wpisz temat, narzędzie lub problem do rozwiązania.

← Wszystkie artykuły

Jak podłączyć MCP do Claude Code

Metalowy łącznik przed fioletowym gniazdem i trzy końcówki narzędzi

Dodanie serwera MCP do Claude Code nie sprowadza się do wklejenia przypadkowej komendy z internetu. Najpierw ustal, jaki program uruchamiasz, do jakich danych ma dostęp i czy narzędzia mogą coś zapisywać. Dopiero potem wybierz transport i zakres konfiguracji.

Poniżej pokazuję konfigurację klienta oraz sposób sprawdzenia połączenia. Przykładowy adres i ścieżka są miejscami do zastąpienia, nie działającą usługą. Nie trzeba zmieniać ustawień wszystkich projektów, żeby przetestować jedną integrację.

Co ma działać po obu stronach

Claude Code jest klientem korzystającym z możliwości serwera MCP. Sam serwer może działać jako lokalny proces albo usługa dostępna przez HTTP. Musi obsługiwać protokół, a nie tylko zwracać dowolny JSON.

Jeśli chcesz najpierw zrozumieć tę granicę, przeczytaj jak działa MCP Server. Zwykły endpoint REST nie stanie się serwerem MCP po zmianie nazwy w konfiguracji.

Przed dodaniem przygotuj cztery informacje: nazwę integracji, sposób uruchomienia lub adres, wymagane uwierzytelnienie oraz listę operacji. Dla pierwszej próby wybierz jedną funkcję odczytu niesekretnych danych.

Sprawdź lokalną wersję i pomoc

claude --version
claude mcp add --help

Pomoc pokazuje składnię zainstalowanej wersji. Podczas przygotowania poradnika sprawdzono dostępność opcji --transport i --scope oraz wartości zakresu local, user i project. Nie uruchamiano zewnętrznego serwera ani sesji modelu na potrzeby tego sprawdzenia.

Jeśli komenda nie istnieje, najpierw rozwiąż problem instalacji i ścieżki programu. Dodawanie kolejnych plików konfiguracyjnych nie naprawi klienta, którego powłoka nie znajduje.

Dobierz zakres konfiguracji

Zakres Kiedy pasuje
local prywatne ustawienie dla bieżącego projektu
project wspólna konfiguracja projektu w .mcp.json
user integracja dostępna w wielu projektach użytkownika

Na początek jawnie użyj local. Dzięki temu nie pomylisz lokalnej próby z konfiguracją współdzieloną przez repozytorium. Przy zakresie projektowym przejrzyj zmiany w pliku przed dodaniem ich do Git.

Adres usługi nie musi być sekretem, ale nagłówek autoryzacji zwykle nim jest. Nie zapisuj tokenu w repozytorium tylko dlatego, że konfiguracja MCP ma format JSON. Oddziel definicję połączenia od sposobu dostarczenia poświadczeń.

Wariant HTTP

Schemat komendy wygląda tak:

claude mcp add --transport http --scope local dokumenty https://mcp.example.com/mcp

mcp.example.com to adres demonstracyjny. Podstaw endpoint z dokumentacji zaufanego serwera. Sprawdź HTTPS, nazwę hosta i wymagany sposób logowania.

W sesji Claude Code polecenie /mcp pozwala przejrzeć skonfigurowane połączenia. Jeżeli serwer wymaga autoryzacji, wykonaj przewidziany dla niego proces. Nie dodawaj przypadkowych nagłówków ani nie wyłączaj sprawdzania TLS, żeby ukryć błąd certyfikatu.

Przy diagnozie oddziel dostępność HTTP od zgodności MCP. Odpowiedź 200 na stronę główną usługi nie potwierdza inicjalizacji protokołu. Do podstawowej diagnostyki połączenia przyda się cURL, lecz nie zastępuje on klienta MCP.

Wariant lokalny stdio

Gdy masz sprawdzony skrypt serwera, możesz skonfigurować proces:

claude mcp add --transport stdio --scope local notatki -- python /pelna/sciezka/server.py

Ścieżka musi prowadzić do rzeczywistej implementacji MCP. Separator -- oddziela argumenty konfiguracji klienta od polecenia procesu. W Windows użyj właściwej ścieżki do interpretera i pliku.

Nie każdy serwer Python działa bez instalacji zależności. Uruchamiaj go w przewidzianym środowisku i przypnij wersje. Komenda pobierająca pakiet przy każdym starcie może z czasem uruchomić inny kod niż ten, który wcześniej oceniono.

Przy stdio standardowe wyjście służy protokołowi. Zwykłe komunikaty diagnostyczne serwera powinny trafiać na stderr. Powitalny napis wypisany na stdout może zepsuć rozmowę mimo poprawnego działania samej funkcji.

Potwierdź połączenie i zakres narzędzi

claude mcp list
claude mcp get dokumenty

Następnie przejrzyj status w /mcp i dostępne funkcje. Pierwszą próbę sformułuj precyzyjnie: odczytaj konkretny niesekretny dokument i niczego nie zmieniaj.

Sprawdź, czy wynik pochodzi z oczekiwanego narzędzia. Sama płynna odpowiedź modelu nie jest dowodem wywołania integracji. Zapis przebiegu i log serwera pomagają ustalić, czy żądanie faktycznie dotarło.

Zgodę klienta i uprawnienia zaplecza traktuj osobno. Serwer nadal powinien odrzucić odczyt cudzego dokumentu. Przykłady takich granic opisuje projektowanie narzędzi agenta AI.

Najczęstsze przyczyny problemów

Objaw Co sprawdzić
Proces nie startuje pełna ścieżka, interpreter, zależności
HTTP działa, MCP nie endpoint, transport, inicjalizacja i autoryzacja
Narzędzie jest niewidoczne status połączenia, deklarowane możliwości, ustawienia klienta
Działa tylko w jednym katalogu zakres konfiguracji i bieżący projekt
Wynik jest pusty argumenty, uprawnienia i dane po stronie serwera

Nie rozszerzaj wszystkich uprawnień jako pierwszej próby naprawy. Odczytaj błąd i sprawdź najwęższy etap, który zawiódł. Nie przesyłaj do zgłoszenia pełnej konfiguracji z tokenami.

Treść zwrócona przez serwer może zawierać instrukcje pochodzące z dokumentu. Nie nadaje im to prawa do zmiany zasad pracy. Ten problem rozwija artykuł o prompt injection.

Usuń nieużywaną integrację

claude mcp remove dokumenty

Sprawdź zakres usuwanej konfiguracji i ponownie odczytaj listę. Usunięcie wpisu klienta nie musi odwołać poświadczenia u dostawcy. Jeśli integracja otrzymała osobny token, zarządzaj jego wycofaniem oddzielnie.

Opis protokołu bez konfiguracji konkretnego programu znajdziesz we wprowadzeniu do MCP.

Najczęstsze pytania

Jaki transport wybrać na początek?

Wybierz transport wspierany przez serwer. Lokalny program zwykle korzysta ze stdio, a usługa zdalna może udostępniać HTTP.

Gdzie zapisać konfigurację współdzieloną w zespole?

Zakres project korzysta z .mcp.json. Przejrzyj plik i nie umieszczaj w nim jawnych sekretów.

Dlaczego narzędzie nie pojawia się mimo poprawnego adresu?

Sprawdź inicjalizację, autoryzację i możliwości serwera. Sam adres HTTP nie potwierdza działającego MCP.

Czy lokalny serwer jest automatycznie bezpieczny?

Nie. To kod uruchamiany z uprawnieniami procesu. Jego pochodzenie i dostęp do plików nadal mają znaczenie.

Źródła

Data publikacji: 18.11.2026.

KP
O AUTORZE

Krystian Proć

Tworzę narzędzia do pracy z danymi, systemy backendowe i automatyzacje. Pracuję z SQL, PHP, TypeScriptem i Dockerem; rozwijam m.in. dragon-island.com. AI pomaga mi przyspieszać pracę, a architekturę, weryfikację i decyzje techniczne biorę na siebie. Na Trybie Technicznym dzielę się doświadczeniami z budowania i utrzymywania własnych projektów.

Dyskusja

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Wymagane pola są oznaczone *