Serwery MCP pozwalają Claude Code łączyć się z zewnętrznymi narzędziami. Przy konfiguracji wybierz zakres: lokalny dla bieżącego projektu, użytkownika dla własnych projektów albo projektowy dla ustawień zapisanych w repozytorium. Jeśli operacja command_batch w PhotoCraft zakończy się błędem, wcześniejsze udane kroki pozostaną wykonane — sprawdź stan dokumentu i historię przed ponowieniem polecenia.
Wybierz zakres MCP w Claude Code
Zakres decyduje o tym, gdzie Claude Code zapisuje konfigurację i do jakich projektów odnosi się serwer. Dokumentacja Claude Code podaje, że konfiguracje lokalne i użytkownika trafiają do ~/.claude.json, a projektowe — do pliku .mcp.json w katalogu głównym projektu. W sesjach interaktywnych Claude Code prosi o zatwierdzenie przed użyciem serwera skonfigurowanego na poziomie projektu (dokumentacja Claude Code).
| Zakres | Do czego się odnosi | Lokalizacja konfiguracji | Udostępnianie i zatwierdzanie |
| Lokalny | Bieżący projekt, prywatnie dla użytkownika | ~/.claude.json | Dotyczy danego projektu użytkownika; nie jest konfiguracją zespołową. |
| Użytkownika | Wszystkie projekty danego użytkownika | ~/.claude.json | Nie jest udostępniany zespołowi. |
| Projektowy | Bieżący projekt | .mcp.json w katalogu głównym projektu | Można go udostępnić przez kontrolę wersji. W sesji interaktywnej Claude Code prosi o zatwierdzenie przed użyciem serwera. |
Jeśli serwer ma służyć tylko w jednym projekcie, wybierz zakres lokalny. Dla własnych połączeń używanych w wielu projektach służy zakres użytkownika. Konfiguracja projektowa może trafić do repozytorium, ale samo jej udostępnienie nie zastępuje zatwierdzenia w sesji interaktywnej.
Dodaj serwer MCP i sprawdź połączenie
Dla lokalnego serwera korzystającego ze standardu stdio ogólny wzór polecenia wygląda tak:
claude mcp add [opcje] <nazwa> -- <polecenie> [argumenty...]
- Wybierz zakres konfiguracji. Zdecyduj, czy serwer ma działać w bieżącym projekcie, we wszystkich Twoich projektach czy jako ustawienie projektowe.
- Zarejestruj serwer. Zastąp elementy w nawiasach nazwą i poleceniem uruchamiającym wybrany serwer. Znak
--oddziela opcje Claude Code od polecenia i argumentów serwera — wszystko po separatorze trafia do serwera (dokumentacja Claude Code). - Sprawdź jego stan. Użyj
claude mcp list, aby wyświetlić skonfigurowane serwery, lub wpisz/mcpw Claude Code, by sprawdzić ich stan w sesji. Sam komunikat o zapisaniu konfiguracji nie potwierdza jeszcze, że serwer nawiązał połączenie.
Każda aplikacja Craft ma własny serwer MCP uruchamiany z poziomu wiersza poleceń, a szczegóły poleceń i argumentów zależą od aplikacji. Ogólny wzór nie zastępuje więc instrukcji dla konkretnego programu. W relacji z testów opublikowanej przez pasqualepillitteri.it aplikacje Craft korzystały z osobnych poleceń CLI (relacja z testów).
Sprawdzaj wynik działania, nie tylko status serwera
Połączenie może działać, a utworzony plik nadal wymagać poprawek. W relacji pasqualepillitteri.it z zadań wykonywanych w aplikacjach Craft wykres w prezentacji DeckCraft nachodził na tytuł slajdu, a list w WordCraft początkowo zajmował dwie strony zamiast jednej. To konkretne problemy z opisanych zadań, nie ocena każdego projektu utworzonego przez te aplikacje (relacja z testów).
Przed wykorzystaniem efektu pracy sprawdź więc sam dokument lub wyeksportowany plik: w prezentacji zweryfikuj układ wykresu względem tytułu, a w dokumencie — liczbę stron i skład. Status serwera mówi o połączeniu; nie zastępuje kontroli jego wyniku.
Granice dostępu do plików
W PhotoCraft skonfigurowane katalogi odczytu i zapisu ograniczają dostęp systemu plików tego serwera do wskazanych ścieżek. Nie ograniczają jednak innych narzędzi dostępnych w Claude Code. W opisanym przez pasqualepillitteri.it zadaniu z FilmCraft serwer nie zapisał renderowanej klatki w wybranym miejscu, więc do zapisu użyto narzędzia powłoki Claude Code (relacja z testów).
Traktuj uprawnienia serwera i uprawnienia pozostałych narzędzi jako osobne granice. Claude Code zaleca, by przed połączeniem ufać serwerowi, zwłaszcza gdy może przetwarzać treści zewnętrzne (dokumentacja Claude Code).
Odzyskaj pracę po błędzie PhotoCraft
command_batch w PhotoCraft wykonuje polecenia po kolei, ale nie działa jak transakcja: gdy późniejszy krok się nie powiedzie, wcześniejsze udane zmiany pozostają. Dokumentacja PhotoCraft zaleca po błędzie sprawdzić stan dokumentu i historię, a przed eksperymentami pracować na kopii albo utworzyć nowy dokument (dokumentacja MCP PhotoCraft).
Ważne jest też rozróżnienie między zmianami w dokumencie a plikami zapisanymi na dysku. Cofnięcie edycji nie usuwa plików, które operacja zdążyła zapisać. Po nieudanej partii najpierw sprawdź dokument i historię, a potem osobno skontroluj wygenerowane pliki — zanim uruchomisz te same kroki ponownie.
