Konfiguracja MCP - integracje podstawowych narzędzi

Zwiększ możliwości Claude Code łącząc go z zewnętrznymi narzędziami i usługami poprzez Model Context Protocol (MCP). Ten przewodnik obejmuje konfigurację podstawowych serwerów MCP, które przekształcają Claude z generatora kodu w kompleksową platformę deweloperską.

Czym jest MCP?

Model Context Protocol wyjaśniony

MCP to otwarty standard umożliwiający asystentom AI interakcję z zewnętrznymi narzędziami i źródłami danych. Serwery MCP można traktować jako wyspecjalizowane API, które dają Claude nowe możliwości:

• Bezpośredni dostęp do narzędzi: Kontrola Git, uruchamianie testów Playwright, zapytania do baz danych
• Dane w czasie rzeczywistym: Pobieranie dokumentacji, issues z GitHub, projektów Figma
• Integracja usług: Połączenia ze Slack, Jira, systemami monitorowania
• Operacje na plikach: Rozszerzony dostęp do systemu plików z kontrolą bezpieczeństwa

Zakresy konfiguracji

Serwery MCP można skonfigurować na trzech poziomach, każdy z określonymi przypadkami użycia:

Hierarchia zakresów

Zakres	Lokalizacja przechowywania	Przypadek użycia	Flaga komendy
Local	Ustawienia użytkownika specyficzne dla projektu	Osobiste serwery deweloperskie	-s local (domyślny)
Project	.mcp.json w głównym katalogu projektu	Narzędzia współdzielone przez zespół	-s project
User	Globalna konfiguracja użytkownika	Osobiste narzędzia	-s user

Pierwszeństwo: Local → Project → User (gdy serwery mają tę samą nazwę)

Podstawowe serwery MCP

1. Git - operacje kontroli wersji

Najbardziej podstawowy serwer MCP dla każdego programisty:

# Instalacja globalna dla wszystkich projektów
claude mcp add git -s user -- npx -y @modelcontextprotocol/git@latest

Możliwości

• Odczyt historii repozytorium i różnic
• Tworzenie commitów z sensownymi wiadomościami
• Zarządzanie gałęziami i merge’ami
• Analiza zmian w kodzie
• Obsługa konfliktów merge

Przykład użycia

> Jakie zmiany zostały ostatnio wprowadzone w systemie uwierzytelniania?
> Stwórz commit dla funkcji logowania, którą właśnie zaimplementowałem
> Pokaż mi różnice między main a feature/oauth

2. GitHub - zarządzanie repozytorium

Połącz się z API GitHub dla kompleksowej kontroli repozytorium:

# Zdalne połączenie OAuth (zalecane)
claude mcp add --transport sse github https://api.githubcopilot.com/mcp/

# Lub z osobistym tokenem dostępu
claude mcp add github -e GITHUB_TOKEN=ghp_yourtoken -- npx -y @modelcontextprotocol/server-github

Możliwości

• Tworzenie i zarządzanie pull requestami
• Praca z issues i projektami
• Uruchamianie GitHub Actions
• Przeglądanie kodu i komentarzy
• Dostęp do metadanych repozytorium

Przykład użycia

> Stwórz PR dla bieżącej gałęzi z podsumowaniem zmian
> Znajdź wszystkie otwarte issues związane z uwierzytelnianiem
> Przejrzyj PR #123 i zasugeruj ulepszenia

3. Filesystem - rozszerzone operacje na plikach

Bezpieczniejszy dostęp do systemu plików z konfigurowalnymi granicami:

# Dodaj z określonym katalogiem głównym
claude mcp add fs -- npx -y @modelcontextprotocol/server-filesystem /path/to/project

Możliwości

• Odczyt/zapis plików z kontrolą bezpieczeństwa
• Nawigacja po strukturach katalogów
• Operacje na wielu plikach
• Przeszukiwanie zawartości plików
• Respektowanie wzorców .gitignore

Uwaga bezpieczeństwa

Zawsze określ katalog główny aby zapobiec dostępowi do wrażliwych plików systemowych. Serwer MCP filesystem ogranicza operacje do określonej ścieżki.

4. PostgreSQL - operacje na bazie danych

Bezpośredni dostęp do bazy danych dla rozwoju i debugowania:

# Dodaj z connection string
claude mcp add postgres -e DATABASE_URL="postgresql://user:pass@localhost:5432/mydb" \
  -- npx -y @modelcontextprotocol/server-postgres

Możliwości

• Eksploracja schematu i dokumentacja
• Zapytania tylko do odczytu domyślnie
• Analiza danych i raportowanie
• Planowanie migracji
• Sugestie optymalizacji wydajności

Przykład użycia

> Opisz schemat tabeli users
> Znajdź wszystkie zamówienia złożone w ostatnich 30 dniach
> Zasugeruj indeksy w celu poprawy wydajności zapytań

5. Playwright - automatyzacja przeglądarki

Włącz testowanie przeglądarki i web scraping:

claude mcp add playwright -- npx -y @playwright/mcp@latest

Możliwości

• Generowanie testów E2E z opisów
• Debugowanie nieudanych testów
• Scraping danych web
• Automatyzacja przepływów pracy przeglądarki
• Testowanie regresji wizualnej

Przykład użycia

> Napisz test weryfikujący czy proces logowania działa poprawnie
> Debuguj dlaczego test checkout nie działa
> Pobierz dane produktów ze strony konkurencji

6. Context7 - dokumentacja bibliotek

Dostęp do aktualnej dokumentacji tysięcy bibliotek:

claude mcp add --transport sse context7 https://mcp.context7.com/sse

Obsługiwane biblioteki

React, Vue, Next.js, Nuxt, Express, Django, Rails, Laravel i ponad 1000 innych bibliotek z dostępem do dokumentacji w czasie rzeczywistym.

Konfiguracja projektu

Tworzenie współdzielonego .mcp.json

Dla współpracy zespołowej utwórz plik .mcp.json w głównym katalogu projektu:

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/git@latest"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL:-postgresql://localhost:5432/dev}"
      }
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}

Wskazówka

Używaj rozwijania zmiennych środowiskowych (${VAR} lub ${VAR:-default}) aby zachować wrażliwe dane poza kontrolą wersji zachowując elastyczność.

Wdrażanie zespołu

Gdy członkowie zespołu klonują repozytorium:

1. Claude Code wykrywa plik .mcp.json
2. Prosi o zatwierdzenie każdego serwera (środek bezpieczeństwa)
3. Automatycznie ładuje zatwierdzone serwery w przyszłych sesjach
4. Członkowie zespołu mogą zresetować zatwierdzenia za pomocą: claude mcp reset-project-choices

Zaawansowane konfiguracje serwerów

Typy serwerów MCP

Typy transportu

Typ	Przypadek użycia	Przykład
stdio	Lokalne wykonywanie komend	Git, filesystem
SSE	Streaming Server-Sent Events	Zdalne API
HTTP	API request/response	Usługi REST

Dodawanie serwerów SSE/HTTP

# Serwer SSE z uwierzytelnianiem
claude mcp add api-server --transport sse \
  https://api.example.com/mcp \
  --header "Authorization: Bearer ${API_TOKEN}"

# Serwer HTTP
claude mcp add data-service --transport http \
  https://data.example.com/mcp

Importowanie z Claude Desktop

Jeśli już skonfigurowałeś serwery MCP w Claude Desktop:

# Importuj wszystkie serwery z Claude Desktop
claude mcp add-from-claude-desktop

# Zobaczysz interaktywny wybór serwerów do zaimportowania

Przepływy pracy z rzeczywistych scenariuszy

Przykład 1: rozwijanie funkcji full-stack

> Muszę dodać stronę profilu użytkownika. Użyj Figma MCP aby pobrać projekt,
> stwórz komponent React, dodaj endpoint API i napisz testy.

Claude wykona:

1. Pobranie projektu z Figma MCP
2. Wygenerowanie komponentu React odpowiadającego projektowi
3. Stworzenie backend API endpoint
4. Napisanie testów E2E Playwright
5. Commit zmian z opisową wiadomością

Przykład 2: refaktoryzacja oparta na bazie danych

> Przeanalizuj naszą tabelę orders i zasugeruj ulepszenia wydajności.
> Następnie zaimplementuj zmiany i zaktualizuj dotknięte endpointy API.

Przykład 3: automatyczny przepływ pracy PR

> Przejrzyj zmiany w tej gałęzi, stwórz PR z kompleksowym
> opisem i połącz go z odpowiednimi GitHub issues.

Zarządzanie serwerami MCP

Listowanie skonfigurowanych serwerów

# Lista wszystkich serwerów
claude mcp list

# Pobierz szczegóły konkretnego serwera
claude mcp get github

# Sprawdź status serwera w sesji
/mcp

Usuwanie serwerów

# Usuń serwer
claude mcp remove playwright

# Usuń z określonego zakresu
claude mcp remove playwright -s project

Debugowanie problemów MCP

# Uruchom z wyjściem debug
claude --mcp-debug

# Sprawdź logi serwerów MCP
tail -f ~/.claude/logs/mcp-*.log

Najlepsze praktyki bezpieczeństwa

Lista kontrolna bezpieczeństwa

✅ Przeglądaj serwery zewnętrzne - Używaj tylko serwerów MCP z zaufanych źródeł

✅ Ogranicz uprawnienia serwerów - Konfiguruj minimalny wymagany dostęp

✅ Używaj zmiennych środowiskowych - Nigdy nie hardkoduj poświadczeń w .mcp.json

✅ Audytuj serwery projektowe - Przejrzyj .mcp.json przed zatwierdzeniem

✅ Kontroluj dostęp do narzędzi - Użyj .claude/settings.json aby ograniczyć narzędzia:

{
  "allowedTools": ["mcp__git__*", "mcp__github__*"]
}

Uwaga

Serwery MCP mogą narazić cię na ryzyko prompt injection, szczególnie te które wchodzą w interakcję z internetem. Zawsze weryfikuj zachowanie serwera i ogranicz uprawnienia.

Szybka referencja

Popularne komendy MCP

# Dodawanie serwerów
claude mcp add <name> <command>           # Zakres lokalny
claude mcp add <name> -s project <cmd>    # Zakres projektu
claude mcp add <name> -s user <cmd>       # Zakres użytkownika

# Zarządzanie serwerami
claude mcp list                           # Lista wszystkich
claude mcp get <name>                     # Pobierz szczegóły
claude mcp remove <name>                  # Usuń serwer

# Zaawansowane
claude mcp add-json <name> '<json>'       # Dodaj z JSON
claude mcp add-from-claude-desktop        # Importuj serwery
claude mcp reset-project-choices          # Resetuj zatwierdzenia

# W sesji
/mcp                                      # Sprawdź status serwera

Następne kroki

Teraz gdy masz skonfigurowane serwery MCP, kontynuuj z:

Przepływ pracy programistycznej Zbuduj swoją pierwszą funkcję z pomocą AI

Niestandardowe serwery MCP Zbuduj własne serwery MCP dla wyspecjalizowanych narzędzi

Pamiętaj: Serwery MCP to to, co przekształca Claude Code ze smart autocomplete w kompleksową platformę deweloperską. Zacznij od podstaw, a następnie rozszerzaj w oparciu o potrzeby twojego przepływu pracy.