Poradnik instalacji wtyczek MCP

Dowiedz się, jak zainstalować i skonfigurować serwery MCP (Model Context Protocol), aby rozszerzyć możliwości Claude o zewnętrzne narzędzia, źródła danych i integracje.

Model Context Protocol (MCP) to otwarty standard stworzony przez Anthropic, który ujednolica sposób łączenia modeli AI z zewnętrznymi źródłami danych i narzędziami. Często określany jako „USB-C dla AI", MCP zapewnia uniwersalny interfejs umożliwiający Claude interakcję z lokalnymi plikami, bazami danych, API i narzędziami deweloperskimi.

Od 2026 roku MCP jest wspierany przez Anthropic, OpenAI, Google i Microsoft — co czyni go de facto standardem integracji dla agentów AI. W ekosystemie dostępnych jest już ponad 593 serwerów MCP, od oficjalnych pakietów Anthropic po integracje tworzone przez społeczność.

Wymagania wstępne

terminal

Node.js (LTS)

Wymagany do uruchamiania większości serwerów MCP za pomocą npx. Pobierz z nodejs.org.

code

Python / uv (opcjonalnie)

Niektóre serwery MCP są napisane w Pythonie i używają uvx zamiast npx.

desktop_mac

Claude Desktop

Aplikacja Claude Desktop musi być zainstalowana. Dostępna na macOS i Windows.

info

Subskrypcja nie jest wymagana

Serwery MCP działają z każdym planem Claude, w tym z darmowym.

Lokalizacja pliku konfiguracyjnego

Serwery MCP konfiguruje się w pliku claude_desktop_config.json. Lokalizacja pliku zależy od systemu operacyjnego:

desktop_mac macOS

~/Library/Application Support/Claude/claude_desktop_config.json

desktop_windows Windows

%APPDATA%\Claude\claude_desktop_config.json

lightbulb

Wskazówka

Nie musisz tworzyć tego pliku ręcznie. Claude Desktop może go wygenerować za Ciebie — szczegóły znajdziesz w krokach instalacji poniżej.

Instalacja krok po kroku

Uruchom Claude Desktop

Otwórz aplikację Claude Desktop na swoim komputerze.

Otwórz Ustawienia

Kliknij menu hamburger → File → Settings (lub użyj skrótu klawiaturowego).

Przejdź do zakładki Developer

W panelu ustawień kliknij zakładkę „Developer" na lewym pasku bocznym.

Kliknij „Edit Config"

To otworzy (lub utworzy) plik claude_desktop_config.json w domyślnym edytorze tekstu.

Dodaj konfigurację serwera MCP

Dodaj wybrane serwery MCP pod kluczem mcpServers (format konfiguracji opisany jest poniżej).

Zapisz i uruchom ponownie

Zapisz plik konfiguracyjny i uruchom ponownie Claude Desktop, aby zmiany zostały zastosowane.

Zweryfikuj instalację

Poszukaj ikony młotka 🔨 w interfejsie Claude Desktop. Po kliknięciu wyświetlą się wszystkie dostępne narzędzia MCP.

Format konfiguracji

Plik konfiguracyjny ma prostą strukturę JSON. Każdy serwer MCP definiuje się pod kluczem mcpServers:

data_object Podstawowa struktura

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@package/server-name"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

folder Przykład serwera Filesystem

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

stacks Przykład wielu serwerów

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-brave-api-key"
      }
    }
  }
}

Popularne serwery MCP

Oto najczęściej używane serwery MCP w ekosystemie:

Serwer	Pakiet	Zastosowanie
Filesystem	`@modelcontextprotocol/server-filesystem`	Odczyt/zapis lokalnych plików, tworzenie dokumentów, organizacja folderów
GitHub	`@modelcontextprotocol/server-github`	Przeglądanie repozytoriów, inspekcja PR-ów, śledzenie workflow
PostgreSQL	`@modelcontextprotocol/server-postgres`	Dostęp do bazy danych tylko do odczytu z inspekcją schematu
Brave Search	`@modelcontextprotocol/server-brave-search`	Wyszukiwanie w internecie
Puppeteer	`@modelcontextprotocol/server-puppeteer`	Automatyzacja przeglądarki i web scraping
Sequential Thinking	`@modelcontextprotocol/server-sequential-thinking`	Dynamiczne rozumowanie i rozwiązywanie problemów krok po kroku
Slack	`@anthropic/mcp-server-slack`	Integracja z przestrzenią roboczą Slack
Google Drive	`@anthropic/mcp-server-gdrive`	Integracja z Google Docs, Sheets i Drive
Docker	`@anthropic/mcp-server-docker`	Zarządzanie kontenerami i orkiestracja
Memory	`@modelcontextprotocol/server-memory`	Trwała pamięć między sesjami

Protokoły transportowe

MCP obsługuje różne mechanizmy transportowe do komunikacji między Claude a serwerami MCP:

terminal

stdio (Standard I/O)

Domyślny transport dla Claude Desktop. Klient uruchamia serwer MCP jako lokalny proces i komunikuje się przez stdin/stdout. To właśnie definiują pola command i args w konfiguracji.

check Zalecany do użytku lokalnego

cloud

StreamableHTTP

Zalecany protokół do dostępu zdalnego i webowego. Obsługuje wielu jednoczesnych klientów i jest następcą przestarzałego transportu SSE.

language Do serwerów zdalnych/webowych

do_not_disturb

SSE (Server-Sent Events)

Przestarzały — zastąpiony przez StreamableHTTP. Nie używaj w nowych integracjach.

Bezpieczeństwo

warning

Ważne

Serwery MCP działają lokalnie z dostępem do Twojego systemu. W styczniu 2026 roku odkryto krytyczne luki w oficjalnym serwerze Git MCP od Anthropic. Zawsze stosuj najlepsze praktyki bezpieczeństwa.

check_circle

Instaluj tylko ze sprawdzonych źródeł — Korzystaj z oficjalnych pakietów Anthropic lub znanych serwerów społecznościowych z aktywnym wsparciem.

check_circle

Aktualizuj serwery — Regularnie uruchamiaj npx @package/server-name, aby otrzymywać najnowsze poprawki bezpieczeństwa.

check_circle

Używaj zmiennych środowiskowych dla sekretów — Nigdy nie wpisuj kluczy API bezpośrednio w pliku konfiguracyjnym. Korzystaj z pola env lub systemowych zmiennych środowiskowych.

check_circle

Ogranicz zakres systemu plików — Korzystając z serwera filesystem, przyznaj dostęp tylko do konkretnych katalogów, których potrzebujesz.

check_circle

Usuwaj nieużywane serwery — Każdy serwer MCP zwiększa powierzchnię ataku. Usuń te, z których aktywnie nie korzystasz.

arrow_forward Przeczytaj nasz pełny poradnik o bezpieczeństwie Prompt Injection

Rozwiązywanie problemów

Ikona młotka nie pojawia się po restarcie expand_more

Zwykle oznacza to błąd składni JSON w pliku konfiguracyjnym. Najczęstsze problemy:

Brakujące lub nadmiarowe przecinki między wpisami serwerów
Niedopasowane nawiasy kwadratowe lub klamrowe
Użycie pojedynczych cudzysłowów zamiast podwójnych

Zwaliduj swój JSON na jsonlint.com lub użyj node -e "JSON.parse(require('fs').readFileSync('path/to/config.json'))"

Serwer MCP nie uruchamia się expand_more

Sprawdź następujące rzeczy:

Upewnij się, że Node.js jest zainstalowany i npx jest dostępny w zmiennej PATH
Spróbuj uruchomić polecenie npx ręcznie w terminalu, aby zobaczyć komunikaty o błędach
Sprawdź, czy nazwa pakietu jest poprawna (literówki zdarzają się często)
W przypadku serwerów wymagających kluczy API zweryfikuj, czy klucz jest prawidłowy i poprawnie ustawiony w polu env

Błędy odmowy dostępu expand_more

Serwery MCP dziedziczą uprawnienia procesu Claude Desktop:

Na macOS sprawdź Ustawienia systemowe → Prywatność i bezpieczeństwo, aby przyznać odpowiednie uprawnienia
Upewnij się, że katalogi podane w konfiguracji są dostępne dla Twojego konta użytkownika
W przypadku serwera filesystem sprawdź, czy ścieżki w polu args istnieją i są możliwe do odczytu

extension

Odkryj ekosystem MCP

Przy ponad 593 dostępnych serwerach MCP z dużym prawdopodobieństwem znajdziesz serwer odpowiadający Twoim potrzebom. Przeglądaj oficjalny katalog serwerów MCP na modelcontextprotocol.io lub sprawdź listy kuratorowane przez społeczność na GitHubie, aby poznać najnowsze dodatki.