Czym jest MCP: łączenie Claude Code z zewnętrznym światem

Claude Code ma domyślnie określony zakres działania: odczyt i zapis lokalnych plików, wykonywanie poleceń w terminalu, korzystanie z wbudowanych narzędzi. Ale prawdziwe projekty wymagają więcej — zapytania do bazy danych, czytanie dokumentów Notion, wyszukiwanie wiadomości Slack, wywoływanie wewnętrznych API.

MCP rozwiązuje właśnie ten problem.

Czym jest MCP

MCP (Model Context Protocol) to otwarty protokół od Anthropic, który definiuje, jak modele AI komunikują się z zewnętrznymi narzędziami i źródłami danych. Można to rozumieć jako instalowanie wtyczek dla Claude Code — każdy MCP Server to niezależna usługa udostępniająca zestaw narzędzi, które Claude może wywoływać bezpośrednio w trakcie sesji.

W odróżnieniu od Hooks (które uruchamiają skrypty, gdy Claude wykonuje akcję), MCP aktywnie rozszerza granice możliwości Claude: cokolwiek podłączysz, Claude może tym operować.

Jak to działa

Architektura jest prosta:

Claude Code (Client)  ←→  MCP Server  ←→  System zewnętrzny

Deklarujesz MCP Server w konfiguracji (lokalny proces lub zdalny serwis)
Przy uruchomieniu Claude Code łączy się z tym Serverem i pobiera listę dostępnych narzędzi
Podczas sesji Claude może wywoływać te narzędzia tak samo jak wbudowane Read/Write/Bash
MCP Server przetwarza żądanie i zwraca wynik do Claude

Cały proces jest przezroczysty dla użytkownika. Widzisz, jak Claude mówi „sprawdzę w bazie danych" i wraca z odpowiedzią — MCP obsługuje komunikację w tle.

Trzy typy możliwości MCP

MCP Server może udostępniać trzy rzeczy:

Tools (narzędzia)
Funkcje, które Claude może aktywnie wywoływać — „zapytaj tabelę users", „wyszukaj dokumenty", „wyślij wiadomość Slack". To najczęściej używany typ, pokrywający 90% rzeczywistych przypadków użycia.

Resources (zasoby)
Dane strukturalne, które Claude może odczytać jako kontekst — schemat bazy danych, dokumentacja API, pliki konfiguracyjne.

Prompts (szablony promptów)
Predefiniowane fragmenty promptów, które użytkownicy mogą bezpośrednio wywoływać.

W praktyce prawie zawsze będziesz pracować z Tools.

Szybki start: dodawanie istniejącego MCP Server

Jako przykład weźmy oficjalny Filesystem MCP — ten Server daje Claude dostęp do systemu plików poza katalogiem roboczym.

Instalacja

npm install -g @modelcontextprotocol/server-filesystem

Konfiguracja

Edytuj ~/.claude/settings.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Documents"
      ]
    }
  }
}

Weryfikacja

Uruchom ponownie Claude Code i spróbuj:

Wylistuj wszystkie pliki PDF w /Users/yourname/Documents

Jeśli Claude zwróci wyniki zamiast powiedzieć „nie mogę uzyskać dostępu do systemu plików", MCP działa.

Struktura konfiguracji

{
  "mcpServers": {
    "nazwa-serwisu": {
      "command": "polecenie uruchomienia",
      "args": ["lista argumentów"],
      "env": {
        "API_KEY": "xxx"
      }
    }
  }
}

command + args: polecenie, którym Claude Code uruchamia proces MCP Server
Nazwa serwisu to tylko lokalna etykieta — nazwij ją jak chcesz
Używaj env do kluczy API i wrażliwej konfiguracji; nie hardkoduj ich w kodzie

Gdzie umieścić konfigurację

Konfiguracja MCP może znajdować się w trzech miejscach, od najniższego do najwyższego priorytetu:

Lokalizacja	Plik	Kiedy używać
Globalna	`~/.claude/settings.json`	Narzędzia we wszystkich projektach
Projekt	`.claude/settings.json`	Narzędzia specyficzne dla tego projektu
Lokalny override	`.claude/settings.local.json`	Konfiguracja osobista, nie commitowana do git

Dla połączeń z bazami danych i wewnętrznymi API używaj konfiguracji projektu i commituj ją razem z kodem. Członkowie zespołu klonujący repozytorium automatycznie otrzymają to samo środowisko MCP.

Gdzie znaleźć istniejące MCP Servery

Anthropic utrzymuje zestaw oficjalnych serwerów:

@modelcontextprotocol/server-filesystem — dostęp do systemu plików
@modelcontextprotocol/server-github — operacje GitHub (PR, issue, wyszukiwanie kodu)
@modelcontextprotocol/server-postgres — zapytania PostgreSQL
@modelcontextprotocol/server-slack — czytanie i wysyłanie wiadomości Slack
@modelcontextprotocol/server-google-maps — mapy i informacje geograficzne

Społeczność stworzyła wiele implementacji stron trzecich obejmujących Notion, Linear, Jira i różne bazy danych.

MCP vs Hooks: co wybrać

	Hooks	MCP
Uruchamiane przez	Claude wykonujące konkretną akcję	Claude aktywnie wywołujące narzędzie
Cel	Przechwycenie lub ulepszenie istniejących zachowań	Dodanie nowych możliwości
Typowe przypadki	Formatowanie przy zapisie, sprawdzenie przed commitem	Zapytanie do DB, wywołanie zewnętrznego API
Złożoność konfiguracji	Niska	Średnia

Uzupełniają się nawzajem. Hooks kontrolują jak Claude pracuje; MCP kontroluje co Claude może robić.

Co dalej

Ten artykuł jest konceptualnym wprowadzeniem do MCP. Kolejne artykuły obejmą:

Podłączenie Claude Code do prawdziwej bazy PostgreSQL z prawdziwym schematem
Podłączenie wewnętrznych narzędzi i API
Budowanie własnego MCP Server od podstaw

Jeśli masz już system, który chcesz podłączyć, sprawdź najpierw listę MCP Serverów — prawdopodobnie ktoś już to zbudował.