Kontakt
(Poradnik)

Serwer MCP czy API?Kiedy potrzebujesz obu

Aktualizacja · 3 min czytania

Skoro masz już REST API, po co serwer MCP? Krótko: API jest dla programistów, a MCP dla asystentów AI. Wyjaśniamy różnicę, kiedy serwer MCP opakowuje istniejące API i kiedy samo API wystarczy.

Krótka odpowiedź

  • API (REST albo GraphQL) to umowa między programami. Programista czyta dokumentację i pisze kod, który woła endpointy.
  • Serwer MCP to warstwa nad API dla modeli AI. Asystent sam pobiera listę narzędzi, czyta ich opisy i decyduje, kiedy ich użyć. Nikt nie pisze kodu po stronie ChatGPT czy Claude.
  • Nie wybierasz jednego z dwóch. Serwer MCP zwykle woła twoje istniejące API.

Czym to się różni w praktyce

  • Odkrywanie: aplikacja AI pyta serwer MCP o listę narzędzi i dostaje nazwy, opisy i schematy parametrów. Z API ktoś musi najpierw przeczytać dokumentację i zaprogramować integrację.
  • Odbiorca: API zwraca dane dla kodu. Narzędzie MCP zwraca odpowiedź, którą model ma zrozumieć i przekazać użytkownikowi.
  • Zasięg: jeden serwer MCP działa w ChatGPT, Claude, Cursorze i Visual Studio Code. Integracja przez API to osobny kod w każdej aplikacji.
  • Zgoda użytkownika: narzędzia MCP są oznaczone jako tylko do odczytu albo zmieniające dane, więc aplikacje wiedzą, kiedy zapytać o zgodę.
  • Logowanie: specyfikacja MCP opisuje autoryzację na OAuth 2.1, więc każda aplikacja AI loguje użytkownika w ten sam sposób. W API każdy integrator robi to po swojemu.

Dlaczego nie wystawić całego API jako narzędzi

Kuszące jest wygenerowanie narzędzia z każdego endpointu, np. z dokumentacji OpenAPI. Asystent radzi sobie jednak gorzej, gdy narzędzi jest dużo i są drobne: musi wybrać właściwe, a każdy opis zajmuje miejsce w jego kontekście.

Lepiej zaprojektować kilka narzędzi pod zadania użytkownika. „Wyceń zamówienie z dostawą” zamiast trzech osobnych wywołań produktu, cennika i kuriera. Claude odrzuca w swoim katalogu jedno ogólne narzędzie typu api_request, które przyjmuje dowolny endpoint.

Kiedy wystarczy samo API

  • Łączysz dwa systemy bez udziału człowieka, np. sklep z ERP albo magazynem.
  • Partnerzy budują na twoich danych własne aplikacje.
  • Piszesz własnego agenta w kodzie, który woła konkretne funkcje. Tu MCP jest opcjonalne, ale przydaje się, gdy ten sam zestaw narzędzi ma działać w kilku aplikacjach.

Kiedy potrzebujesz serwera MCP

  • Chcesz, żeby klienci znajdowali i kupowali twoje produkty w ChatGPT albo Claude. Opisujemy to w poradniku Jak sprzedawać w ChatGPT.
  • Twoi użytkownicy pracują w Claude albo ChatGPT i chcą mieć tam dane z twojego produktu. Szczegóły w poradniku Konektor Claude dla SaaS.
  • Chcesz wpisu w katalogu pluginów ChatGPT albo konektorów Claude. Oba przyjmują serwery MCP, a nie zwykłe API.
  • Twój zespół chce pracować na danych firmy z poziomu asystenta: raporty, obsługa zamówień, wyszukiwanie w dokumentach.

Jak to wygląda technicznie

Serwer MCP to zwykle mała usługa obok API, na twojej domenie (np. pod adresem /mcp), dostępna przez transport Streamable HTTP. Każde narzędzie ma nazwę, opis, schemat parametrów w JSON Schema i funkcję, która woła API i układa wynik w czytelną odpowiedź.

Uprawnienia zostają w API. Serwer działa w imieniu zalogowanego użytkownika (z własnym tokenem do API, nie z tym od ChatGPT czy Claude), więc asystent widzi to samo, co ten użytkownik w twojej aplikacji. Tak zbudowaliśmy serwer dla Drukalo: wyszukiwanie, wycena i koszyk korzystają z tych samych danych co sklep.

FAQ
Czy MCP zastępuje REST API?
Nie. Serwer MCP korzysta z API i dodaje warstwę dla asystentów AI. Twoje integracje, aplikacje mobilne i partnerzy dalej używają API.
Czy mogę wygenerować serwer MCP z dokumentacji OpenAPI?
Tak, są narzędzia, które to robią, i to dobry punkt startu do testów. Przed publikacją w katalogach warto przejrzeć listę i połączyć drobne narzędzia w kilka pod konkretne zadania.
Czy serwer MCP zwiększa ryzyko bezpieczeństwa?
Udostępnia tylko to, co zaprogramujesz, i działa z uprawnieniami zalogowanego użytkownika. Podstawy: osobne narzędzia do odczytu i zapisu, OAuth zamiast kluczy wklejanych do czatu i te same limity zapytań co w API.
Poradniki

Masz API i chcesz serwer MCP?

Serwery MCP

ZRÓBMYCOŚ, COZOSTAJE→W GŁOWIE

Napisz do nas