Konfiguracja MCP: łączenie narzędzi zewnętrznych

Prowadzisz triaging błędu produkcyjnego. Musisz sprawdzić błąd w Sentry, spojrzeć na powiązany PR na GitHub, zapytać bazę danych o dotkniętych użytkowników i zaktualizować ticket w Jira — cztery różne karty przeglądarki, cztery różne konteksty, ciągłe kopiowanie i wklejanie między narzędziami. Z połączonymi serwerami MCP możesz zrobić to wszystko z jednej sesji Claude Code: “Sprawdź najnowsze błędy Sentry, znajdź PR, który wprowadził problem, zapytaj, ilu użytkowników jest dotkniętych i utwórz poprawkę.”

MCP (Model Context Protocol) to otwarty standard, który pozwala Claude Code łączyć się z narzędziami zewnętrznymi i źródłami danych. Ten przewodnik poprowadzi Cię od zera do pierwszego połączonego serwera MCP w 15 minut.

Co zdobędziesz

Przynajmniej jeden serwer MCP połączony i działający
Zrozumienie zdalnych serwerów HTTP kontra lokalne serwery stdio
Wiedzę o zakresach użytkownika, projektu i lokalnym dla konfiguracji MCP
Praktyczne przykłady dla najpopularniejszych serwerów MCP

Jak działa MCP w Claude Code

Serwery MCP dają Claude dodatkowe narzędzia poza wbudowanymi operacjami na plikach i poleceniami bash. Gdy podłączysz serwer MCP GitHub, Claude może wyświetlać PR-y, tworzyć issues i przeglądać kod. Gdy podłączysz Sentry, Claude może wyszukiwać błędy i analizować ślady stosu. Narzędzia są dostępne dla Claude automatycznie — po prostu pytasz o to, czego chcesz, w naturalnym języku.

Istnieją dwa typy serwerów MCP:

Zdalne serwery HTTP — Usługi hostowane w chmurze, z którymi łączysz się przez URL. Większość popularnych usług (GitHub, Sentry, Slack, Linear, Notion) je oferuje. Jedna komenda do dodania, bez potrzeby instalacji lokalnej.
Lokalne serwery stdio — Programy działające na Twoim komputerze. Użyj ich dla baz danych, narzędzi systemu plików lub niestandardowych integracji.

Dodawanie pierwszego serwera MCP

Zdalny serwer HTTP (zalecany start)

Najłatwiejszym serwerem do skonfigurowania jest zdalny serwer HTTP. Połączmy GitHub:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Następnie wewnątrz sesji Claude Code uwierzytelnij się:

/mcp
# Wybierz "Authenticate" dla GitHub, postępuj zgodnie z procesem w przeglądarce

To wszystko. Możesz teraz poprosić Claude o interakcję z GitHub:

Pokaż mi wszystkie otwarte PR-y przypisane do mnie w tym repozytorium.

Inne popularne serwery zdalne

# Sentry - monitorowanie błędów
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# Linear - śledzenie problemów
claude mcp add --transport http linear https://mcp.linear.app/mcp

# Slack - komunikacja
claude mcp add slack --transport http https://mcp.slack.com/mcp

# Notion - dokumentacja
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Figma - pliki projektowe
claude mcp add --transport http figma https://mcp.figma.com/mcp

# Stripe - płatności
claude mcp add --transport http stripe https://mcp.stripe.com

# Atlassian (Jira/Confluence)
claude mcp add --transport http atlassian https://mcp.atlassian.com/v1/mcp

# Vercel - wdrożenia
claude mcp add --transport http vercel https://mcp.vercel.com

Każdy serwer wymaga uwierzytelnienia przez /mcp po dodaniu. Tokeny OAuth są bezpiecznie przechowywane i automatycznie odświeżane.

Prompt do skopiowania i wklejenia po połączeniu GitHub + Sentry:

Sprawdź Sentry pod kątem najnowszych nierozwiązanych błędów z ostatnich
24 godzin. Dla każdego błędu znajdź powiązany kod w tym repozytorium
i zasugeruj poprawkę. Jeśli jest niedawny PR, który mógł wprowadzić
błąd, zidentyfikuj go.

Lokalny serwer stdio (przykład bazy danych)

Dla narzędzi, które potrzebują bezpośredniego dostępu do Twojej infrastruktury, użyj lokalnych serwerów:

# Dostęp do bazy danych PostgreSQL
claude mcp add --transport stdio db -- \
  npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:password@localhost:5432/myapp"

Teraz Claude może odpytywać Twoją bazę danych w naturalnym języku:

Ilu użytkowników zarejestrowało się w ciągu ostatnich 7 dni? Rozpisz to dzień po dniu.

Zakresy MCP: gdzie konfigurowane są serwery

Serwery MCP mogą być dodawane na trzech poziomach:

Zakres	Flaga	Przechowywane w	Współdzielone?
Local (domyślny)	`--scope local`	`~/.claude.json` (per projekt)	Nie
Project	`--scope project`	`.mcp.json` w katalogu głównym repo	Tak (commitowane)
User	`--scope user`	`~/.claude.json` (globalny)	Nie

Użyj zakresu local (domyślny) dla serwerów z Twoimi osobistymi poświadczeniami, jak Twoje konto Sentry.

Użyj zakresu project dla serwerów potrzebnych całemu zespołowi:

claude mcp add --transport http linear --scope project https://mcp.linear.app/mcp

To tworzy lub aktualizuje .mcp.json w katalogu głównym Twojego projektu, który committujesz do git. Członkowie zespołu są proszeni o zatwierdzenie serwera przy pierwszym otwarciu projektu.

Użyj zakresu user dla serwerów, których chcesz we wszystkich projektach:

claude mcp add --transport http slack --scope user https://mcp.slack.com/mcp

Zarządzanie serwerami MCP

# Wyświetl wszystkie skonfigurowane serwery
claude mcp list

# Sprawdź szczegóły konkretnego serwera
claude mcp get github

# Usuń serwer
claude mcp remove github

# Sprawdź status serwera (wewnątrz sesji Claude Code)
/mcp

MCP w zakresie projektu z .mcp.json

Dla konfiguracji MCP współdzielonej zespołowo plik .mcp.json w katalogu głównym projektu definiuje serwery, które każdy członek zespołu powinien mieć:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    },
    "db": {
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"],
      "env": {}
    }
  }
}

Zauważ rozszerzenie zmiennej środowiskowej ${DATABASE_URL}. Pozwala to każdemu deweloperowi używać własnego URL bazy danych bez hardcodowania poświadczeń w współdzielonej konfiguracji.

Prompt do skopiowania i wklejenia w celu skonfigurowania MCP dla zespołu:

Przeczytaj nasz plik .mcp.json i zweryfikuj, czy wszystkie skonfigurowane
serwery MCP działają poprawnie. Dla każdego serwera, który nie może się
połączyć, wyjaśnij, co może być nie tak i jak to naprawić. Następnie
zasugeruj dodatkowe serwery MCP, które byłyby przydatne w oparciu o
narzędzia i usługi, których używa ten projekt.

Rozszerzanie zmiennych środowiskowych

.mcp.json obsługuje zmienne środowiskowe w poleceniach, argumentach, URL-ach i nagłówkach:

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_TOKEN}"
      }
    }
  }
}

Składnia ${VAR:-default} zapewnia wartość domyślną, gdy zmienna nie jest ustawiona.

Wyszukiwanie narzędzi MCP

Gdy masz wiele serwerów MCP z wieloma narzędziami, definicje narzędzi mogą zużywać znaczący kontekst. Claude Code automatycznie włącza wyszukiwanie narzędzi MCP, gdy opisy narzędzi przekraczają 10% okna kontekstowego. Zamiast ładować wszystkie narzędzia z góry, Claude odkrywa i ładuje narzędzia na żądanie.

Możesz kontrolować to zachowanie:

# Zawsze włącz wyszukiwanie narzędzi
ENABLE_TOOL_SEARCH=true claude

# Wyłącz wyszukiwanie narzędzi (załaduj wszystkie narzędzia z góry)
ENABLE_TOOL_SEARCH=false claude

# Niestandardowy próg (np. 5% kontekstu)
ENABLE_TOOL_SEARCH=auto:5 claude

Gdy coś nie działa

“Connection closed” dla lokalnych serwerów stdio w Windows — Windows nie może bezpośrednio wykonywać npx. Opakuj polecenie za pomocą cmd /c:

claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package

Serwer dodany, ale narzędzia się nie pojawiają — Uruchom /mcp wewnątrz Claude Code, aby sprawdzić status serwera. Jeśli serwer wyświetla się jako rozłączony, spróbuj go usunąć i dodać ponownie. Sprawdź, czy URL jest poprawny i czy usługa działa.

Uwierzytelnienie OAuth nie działa — Użyj /mcp, aby ponownie się uwierzytelnić. Jeśli widzisz “does not support dynamic client registration”, serwer wymaga wstępnie skonfigurowanych poświadczeń OAuth z --client-id i --client-secret.

Wyjście MCP przekracza limit tokenów — Dla serwerów, które zwracają duże wyniki (zapytania do bazy danych, zrzuty logów), zwiększ limit: export MAX_MCP_OUTPUT_TOKENS=50000. Domyślnie to 25 000 tokenów.

Serwery z projektu .mcp.json nie ładują się — Claude Code prosi o zatwierdzenie przed użyciem serwerów w zakresie projektu. Jeśli odmówiłeś, zresetuj za pomocą claude mcp reset-project-choices.

Co dalej

Z połączonymi serwerami MCP masz wszystko, czego potrzebujesz, aby zbudować swoją pierwszą funkcję od końca do końca z Claude Code.

Przepływ pracy rozwoju Zbuduj swoją pierwszą funkcję z Claude Code

Kontrola wersji Integracja Git i zarządzanie gałęziami