Czego szukasz?

Wpisz temat, narzędzie lub problem do rozwiązania.

← Wszystkie artykuły

MCP Server: jak działa komunikacja AI z zewnętrznymi narzędziami

Rysunek dwóch różnych złączy połączonych centralnym adapterem

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

Data publikacji: 13.11.2026.

KP
O AUTORZE

Krystian Proć

Tworzę narzędzia do pracy z danymi, systemy backendowe i automatyzacje. Pracuję z SQL, PHP, TypeScriptem i Dockerem; rozwijam m.in. dragon-island.com. AI pomaga mi przyspieszać pracę, a architekturę, weryfikację i decyzje techniczne biorę na siebie. Na Trybie Technicznym dzielę się doświadczeniami z budowania i utrzymywania własnych projektów.

Dyskusja

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Wymagane pola są oznaczone *