MCP Server udostępnia aplikacji AI określone narzędzia i dane przez wspólny protokół. Może pozwalać na wyszukanie dokumentu, odczyt stanu zadania albo przygotowanie szkicu. Sam nie jest modelem językowym i nie powinien dostawać nieograniczonych uprawnień tylko dlatego, że współpracuje z AI.
Jeśli znasz już ogólne wprowadzenie do MCP, tutaj prześledzisz konkretną rozmowę między klientem a serwerem. Przykłady opierają się na wersji specyfikacji 2025-11-25. To objaśnienie protokołu, nie relacja z wdrożenia kompletnego serwera produkcyjnego.
Host, klient i serwer pełnią różne role
Hostem jest aplikacja, w której pracuje użytkownik. Zarządza rozmową, integracją z modelem i sposobem udzielania zgody na operacje. W jej ramach klient MCP komunikuje się z konkretnym serwerem.
Serwer udostępnia możliwości. Przykładowo może mieć narzędzie find_note, które przyjmuje identyfikator i zwraca jedną notatkę. Dane pobiera ze swojego zaplecza: plików, bazy lub zewnętrznego API.
Model może zaproponować użycie narzędzia, ale wykonanie przechodzi przez aplikację. Dlatego aplikacja i serwer muszą egzekwować zakres dostępu. Tekst „używaj tylko bezpiecznie” w opisie narzędzia nie zastępuje sprawdzenia uprawnień.
Praktyczny podział odpowiedzialności:
| Element | Odpowiedzialność w przykładowym projekcie |
|---|---|
| Host | pokazanie operacji użytkownikowi i prowadzenie rozmowy |
| Klient MCP | wymiana komunikatów z serwerem |
| Serwer MCP | walidacja wywołania i wykonanie dozwolonej funkcji |
| Zaplecze | przechowywanie danych i własna kontrola dostępu |
Taki podział pomaga diagnozować awarię. Nie każda nieudana odpowiedź modelu oznacza problem z serwerem, a poprawna odpowiedź protokołu nie dowodzi poprawności danych biznesowych.
Od inicjalizacji do wywołania narzędzia
Połączenie zaczyna się od inicjalizacji. Strony ustalają wersję protokołu i informują o wspieranych możliwościach. Klient po odpowiedzi wysyła powiadomienie o zakończeniu inicjalizacji.
Dopiero później przechodzi do operacji takich jak pobranie listy narzędzi. Uproszczona kolejność to:
klient -> initialize
serwer -> odpowiedź initialize
klient -> notifications/initialized
klient -> tools/list
serwer -> lista narzędzi
klient -> tools/call
serwer -> wynik narzędzia
Nie pomijaj pierwszych kroków w implementacji. Klient powinien korzystać z możliwości zadeklarowanych przez serwer, a nie zakładać obsługę każdej funkcji opisanej w specyfikacji.
Schemat narzędzia jest kontraktem wejścia
Załóżmy, że projekt udostępnia odczyt jednej notatki. Fragment definicji narzędzia może wyglądać tak:
{
"name": "find_note",
"description": "Odczytaj jedną dostępną notatkę po identyfikatorze.",
"inputSchema": {
"type": "object",
"properties": {"note_id": {"type": "integer", "minimum": 1}},
"required": ["note_id"],
"additionalProperties": false
}
}
Schemat ogranicza kształt argumentów. Nie rozstrzyga jednak, czy użytkownik może czytać notatkę numer 42. Dlatego serwer musi sprawdzić to osobno na podstawie tożsamości i uprawnień przypisanych poza argumentami modelu.
Nie dodawaj parametru is_admin, któremu bezwarunkowo zaufa zaplecze. Równie problematyczny jest dowolny adres URL, ścieżka pliku lub polecenie powłoki, jeśli nie ma kontroli dozwolonego zakresu.
Wzorzec ograniczania funkcji pokazuje poradnik o bezpiecznych narzędziach agenta AI.
Żądanie i odpowiedź JSON-RPC
Po inicjalizacji klient może wysłać przykładowe wywołanie:
{
"jsonrpc": "2.0",
"id": 7,
"method": "tools/call",
"params": {"name": "find_note", "arguments": {"note_id": 42}}
}
Odpowiedź używa tego samego identyfikatora:
{
"jsonrpc": "2.0",
"id": 7,
"result": {
"content": [{"type": "text", "text": "Notatka demonstracyjna."}],
"isError": false
}
}
To celowo mały, syntetyczny przykład. Nie zawiera prawdziwej notatki ani wyniku zapytania do działającej bazy. Pozwala zobaczyć oddzielenie metody, argumentów oraz rezultatu.
Odróżniaj błąd protokołu od błędu wykonania narzędzia. Niepoprawne żądanie i prawidłowo wywołana funkcja, która nie mogła zrealizować zadania, mają inne znaczenie dla klienta i diagnostyki.
Do sprawdzania składni takich fragmentów możesz użyć formattera JSON. Jednak poprawna składnia nie oznacza jeszcze zgodności z pełnym protokołem.
stdio i Streamable HTTP
Przy transporcie stdio klient uruchamia proces serwera i wymienia wiadomości przez standardowe wejście oraz wyjście. Komunikaty są rozdzielane znakami nowej linii. Zwykłe logi diagnostyczne powinny trafiać na stderr, żeby nie mieszały się z protokołem na stdout.
To pasuje do lokalnej integracji, ale proces nadal działa z określonymi uprawnieniami systemowymi. Zainstalowanie serwera z nieznanego źródła oznacza uruchomienie kodu, a nie tylko odczyt pliku konfiguracyjnego.
Streamable HTTP służy do komunikacji przez HTTP i ma własne zasady obsługi żądań oraz sesji. Nie jest po prostu dowolnym endpointem REST przemianowanym na MCP. Dlatego publiczny serwer wymaga poprawnej konfiguracji transportu, uwierzytelniania i autoryzacji.
Jeżeli potrzebujesz tylko wywołać jedną znaną usługę z własnego skryptu, zwykłe REST API może być wystarczające. MCP zyskuje sens, kiedy chcesz udostępnić spójny interfejs klientom obsługującym ten protokół.
Narzędzia, zasoby i prompty
Narzędzia wykonują operacje. Zasoby udostępniają treści, które aplikacja może wykorzystać jako kontekst. Prompty są szablonami wiadomości lub instrukcji udostępnianymi przez serwer.
Te pojęcia nie są zamienne. Dokument instrukcji obsługi może być zasobem, wyszukiwanie po indeksie narzędziem, a polecenie przygotowania przeglądu zmian szablonem promptu.
Nie trzeba wdrażać wszystkiego naraz. Dla pierwszego projektu sensowny zakres to jedno narzędzie odczytu, jawny schemat wejścia, kontrola uprawnień i małe odpowiedzi. Dopiero później dodawaj zapis oraz długie operacje.
Co sprawdzić przed udostępnieniem serwera
Przygotuj przypadki poprawne i odmowy: nieistniejący identyfikator, cudzy dokument, zły typ argumentu i timeout zaplecza. Sprawdź, czy odpowiedź nie ujawnia sekretów ani danych spoza zakresu.
Wynik narzędzia również jest treścią, której nie należy automatycznie traktować jako instrukcji administracyjnej. Dokument może zawierać próbę prompt injection. Uprawnienia operacji muszą przetrwać taki przypadek niezależnie od zachowania modelu.
Dodaj identyfikator wywołania, czas wykonania i wynik kontroli dostępu do logów. Z kolei praktyczny format zdarzeń opisuje monitorowanie automatyzacji.
Najczęstsze pytania
Czy MCP Server uruchamia model AI?
Nie musi. Jego zadaniem jest udostępnienie możliwości klientowi. Model może działać w innej części systemu.
Czy opis narzędzia zabezpiecza jego użycie?
Nie. Potrzebna jest walidacja i autoryzacja po stronie wykonującej operację.
Czy każdy serwer MCP musi być publiczny?
Nie. Transport stdio pozwala współpracować z lokalnym procesem, a usługa HTTP może działać w ograniczonej sieci.
Czy trzeba zastąpić istniejące REST API?
Nie. Serwer MCP może korzystać z niego jako zaplecza, zachowując kontrolę zakresu operacji.
Źródła
- Cykl życia połączenia, MCP Specification.
- Narzędzia i wyniki wywołań, MCP Specification.
- Transporty, MCP Specification.
- Zasoby, MCP Specification.
- Szablony promptów, MCP Specification.
- Praktyki bezpieczeństwa, Model Context Protocol.
Data publikacji: 13.11.2026.

Dyskusja