Dodawanie serwera MCP z terminala
Do zdalnych serwerów MCP wybieraj transport HTTP, który jest rekomendowaną opcją dla usług chmurowych. Dodanie takiego serwera wymaga podania transportu, nazwy i adresu URL. Jeśli endpoint wymaga nagłówka autoryzacyjnego, możesz dołączyć go przez --header.
Dla lokalnego serwera uruchamianego jako proces użyj transportu stdio i umieść nazwę serwera przed separatorem --. Separator oddziela opcje Claude Code od polecenia i argumentów uruchamiających serwer; wszystko po nim jest przekazywane bez zmian. Możesz przekazać serwerowi zmienne środowiskowe przez --env, ale wstaw inną opcję przed nazwą serwera, aby CLI nie potraktowało jej jako kolejnej pary KEY=value.
Domyślnie serwer otrzymuje zakres lokalny: jest dostępny tylko w projekcie, w którym go dodano, i pozostaje prywatny dla użytkownika. Konfiguracja lokalna trafia do ~/.claude.json pod ścieżkę bieżącego projektu, więc serwer nie pojawi się automatycznie w innych projektach. Ten zakres sprawdza się przy osobistych serwerach deweloperskich, eksperymentach lub konfiguracjach z danymi dostępowymi, których nie chcesz umieszczać w kontroli wersji.
Dla serwera HTTP wymagającego skonfigurowanych poświadczeń OAuth możesz podać identyfikator klienta, port callbacku i wprowadzić sekret w trybie maskowanym. Tych flag OAuth nie stosuj do serwerów stdio, ponieważ działają wyłącznie z transportami HTTP i SSE.
claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server
claude mcp add --transport http --client-id your-client-id --client-secret --callback-port 8080 my-server https://mcp.example.com/mcp
Zastosowanie w praktyce
Użyj claude mcp add, gdy chcesz podłączyć zdalną usługę MCP przez HTTP, ponieważ ten transport jest rekomendowany dla serwerów zdalnych. Wybierz wariant stdio, gdy serwer ma działać jako lokalny proces i potrzebuje bezpośredniego dostępu do systemu lub uruchamia skrypt. Pozostaw zakres lokalny dla prywatnych konfiguracji projektowych, eksperymentów lub serwerów z danymi dostępowymi, których nie chcesz wersjonować.
--: bez niego Claude Code może próbować rozpoznawać flagi serwera, takie jak --port, jako własne opcje.