Host agenta może potrzebować połączenia, które da się skonfigurować. Programista aplikacji może potrzebować biblioteki do zaimportowania w kodzie. Te wymagania prowadzą do różnych powierzchni integracji.
Co każde z nich udostępnia wywołującemu?
Serwer MCP udostępnia interfejs protokołu; SDK udostępnia funkcje i typy dla języka programowania.
Przewodnik po architekturze MCP opisuje serwery udostępniające możliwości podłączonym klientom. Serwer może działać jako proces lokalny lub udostępniać zdalny punkt końcowy.
| Interfejs | Wywołujący | Z czego korzysta wywołujący | Odpowiedzialność za środowisko uruchomieniowe |
|---|---|---|---|
| Serwer MCP | Klient MCP w hoście agenta lub aplikacji | Żądania protokołu i wykryte możliwości | Ktoś uruchamia proces serwera lub usługę zdalną |
| API SDK | Kod aplikacji | Metody biblioteczne wywołujące API | Aplikacja uruchamia bibliotekę i zarządza jej integracją |
| MCP SDK | Kod implementujący klienta lub serwer MCP | Typy protokołu i helpery implementacyjne | Aplikacja nadal uruchamia wynikowego klienta lub serwer |
Pakiet SDK nie staje się działającym serwerem tylko dlatego, że go zainstalujesz.
Czy serwer może używać SDK?
Tak. Programista może użyć protokołowego SDK, aby zaimplementować serwer MCP, a następnie użyć innej biblioteki klienckiej wewnątrz jego handlerów.
Dokumentacja MCP SDK opisuje biblioteki do budowania klientów i serwerów. Tutaj SDK oznacza kod służący do implementacji protokołu.
API SDK ma inny cel: wywołuje API usługi. Hipotetyczny serwer zamówień mógłby udostępniać narzędzie do sprawdzania statusu zamówienia, którego handler pobiera zamówienie za pomocą API SDK.
Zewnętrzny interfejs MCP i wewnętrzne wywołanie API mają osobne kontrakty. Obsługa operacji API nie oznacza automatycznego udostępnienia jej jako narzędzia MCP.
Jakie obowiązki pozostają po stronie mojej aplikacji?
Twoja aplikacja nadal decyduje, które operacje wywołać. Decyduje też, jak obsłużyć ich wyniki.
W przypadku API SDK Twój kod wybiera metodę i przekazuje jej argumenty. W przypadku MCP host kieruje żądania przez klienta do udostępnionych możliwości serwera.
Architektura MCP pozostawia wykorzystanie kontekstu modelu przez hosta poza zakresem protokołu. Połączenie z narzędziem nie decyduje o Twoich regułach biznesowych, polityce autoryzacji ani kryteriach zakończenia.
W przypadku wyszukiwania zamówienia odebranie żądanego statusu może kończyć zadanie. W przypadku wysyłania wiadomości nadanie i późniejsze doręczenie to osobne wyniki.
Jak wybrać integrację Bird?
Możesz podłączyć kompatybilnego hosta agenta do serwera MCP Bird lub zintegrować kod aplikacji przez klienta API.
Dla ścieżki bibliotecznej wybór Bird SDK obejmuje decyzję między SDK a bezpośrednim HTTP. Dla ścieżki narzędziowej inwentarz Bird Twojego klienta dostarcza dostępne nazwy narzędzi i schematy wejściowe.
Porównaj potrzebną operację na interfejsie, którego zamierzasz użyć. Obecność operacji w jednym interfejsie nie oznacza jej obecności w innym.
- Użyj połączenia MCP, gdy Twój host musi wykrywać i wywoływać narzędzia Bird.
- Użyj klienta API, gdy Twój kod aplikacji wybiera i wywołuje operacje usługi.
- Użyj MCP SDK, gdy implementujesz sam klient lub serwer protokołu.