Serwer MCP działa w jednym projekcie a w innym nie - konfiguracja

Claude Code

Serwer MCP działa w jednym projekcie a w innym nie - konfiguracja

W skrócie

Konfigurujesz serwer MCP, sprawdzasz - działa. Przechodzisz do innego projektu i tam po tym samym serwerze nie ma śladu. To nie błąd, tylko efekt tego, że Claude Code świadomie rozdziela konfigurację na różne zasięgi. Wyjaśnimy Ci, jak te zasięgi działają i który wybrać, żeby serwer był dostępny tam, gdzie go potrzebujesz.

Jak to wygląda w praktyce

W projekcie A wpisujesz claude mcp list i serwer jest na liście, połączony i sprawny. Otwierasz projekt B, wpisujesz to samo polecenie i lista jest pusta albo serwera na niej brakuje. Bywa odwrotnie: serwer dodał kolega, u niego działa, a u Ciebie w tym samym repozytorium nie. W obu przypadkach nic nie jest zepsute - po prostu konfiguracja serwera została zapisana w zasięgu, który nie obejmuje miejsca, w którym właśnie pracujesz.

Dlaczego Claude Code tak działa

Claude Code pozwala konfigurować serwery MCP w trzech zasięgach, a wybiera się je flagą --scope. Zasięg lokalny (domyślny) jest prywatny i widoczny tylko w bieżącym projekcie. Zasięg projektu zapisuje konfigurację do pliku .mcp.json w katalogu głównym repozytorium i jest pomyślany do dzielenia z zespołem przez system kontroli wersji - ale tylko w obrębie tego repozytorium. Zasięg użytkownika obejmuje wszystkie Twoje projekty i jest prywatny. Stąd biorą się objawy: serwer dodany domyślnie (lokalnie) albo w zasięgu projektu nie pojawi się w innym projekcie, bo tamtejsza konfiguracja go nie zna. A serwer w zasięgu projektu wymaga dodatkowo zatwierdzenia - w sesji interaktywnej Claude Code przy pierwszym użyciu prosi o przejrzenie i akceptację konfiguracji z .mcp.json.

Jak to rozwiązać krok po kroku

1. Ustal, gdzie serwer jest teraz. W projekcie, w którym działa, uruchom claude mcp get <nazwa> - zobaczysz jego konfigurację i zorientujesz się, w jakim zasięgu został dodany.
2. Zdecyduj, jak szeroko ma być dostępny. Do wszystkich Twoich projektów - zasięg użytkownika. Do jednego repozytorium, wspólnie z zespołem - zasięg projektu. Tylko dla Ciebie w jednym projekcie - zasięg lokalny.
3. Chcesz go mieć wszędzie? Dodaj ponownie w zasięgu użytkownika, na przykład claude mcp add --scope user --transport http nazwa https://adres/mcp (dla serwera zdalnego) albo z odpowiednim poleceniem dla serwera lokalnego.
4. Chcesz dzielić go z zespołem w danym repozytorium? Dodaj w zasięgu projektu (--scope project). Claude Code utworzy lub uzupełni plik .mcp.json w katalogu głównym - dołóż go do repozytorium, żeby reszta zespołu miała tę samą konfigurację.
5. Przy serwerze w zasięgu projektu potwierdź go: przy pierwszym użyciu w sesji interaktywnej zaakceptuj konfigurację, gdy Claude Code o to poprosi. Zatwierdzenia możesz zresetować poleceniem claude mcp reset-project-choices.
6. Nie dubluj tego samego serwera w kilku zasięgach bez potrzeby - trzymaj jedno źródło prawdy dla danej integracji, żeby uniknąć zamieszania.

Jak sprawdzić, że zadziałało

Przejdź do projektu, w którym serwera wcześniej brakowało, i uruchom claude mcp list - teraz powinien się na niej znaleźć, ze statusem połączonym (Connected). Jeśli dodałeś go w zasięgu użytkownika, sprawdź go w jeszcze jednym, dowolnym projekcie, żeby potwierdzić, że jest widoczny globalnie. Dla zasięgu projektu upewnij się, że plik .mcp.json istnieje w katalogu głównym repozytorium i że po jego zatwierdzeniu narzędzia serwera są dostępne. Ostateczny dowód to jak zwykle udane wywołanie serwera w tym nowym miejscu.

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