Dobry serwer MCP daje agentowi taki sam dostęp, jaki ma użytkownik. Angażuje człowieka w pętlę decyzyjną tylko tam, gdzie pomyłka mogłaby być kosztowna, a resztę pozwala agentowi obsłużyć samodzielnie. Oto co jest do tego potrzebne.
Narzędzia, które agent potrafi poprawnie wybrać
Agent musi wybrać operację na podstawie Twojego żądania i podać właściwe argumenty. Sprawdź, czy opisy narzędzi wyjaśniają, co robi każda operacja i jakie argumenty przyjmuje.
Spróbuj wyszukać zadanie takie jak konfiguracja domeny wysyłkowej. Wyniki powinny zawierać pasujące narzędzie i jego schemat wejściowy.
Bird generuje swoje narzędzia z katalogu operacji API. Opisy dla agentów wyjaśniają, jak ich używać. Dynamiczny endpoint MCP oferuje search i execute. Wyszukiwanie zwraca pasujące narzędzia, ich schematy, adnotacje efektów i odpowiednie procedury. Agent może sprawdzić narzędzie przed jego wywołaniem.
Człowiek w pętli decyzyjnej tam, gdzie pomyłka mogłaby być kosztowna
Agent potrzebuje człowieka w pętli decyzyjnej tam, gdzie pomyłka mogłaby być kosztowna. Sprawdź, czy ekran przeglądu pokazuje, co się stanie. Sprawdź, czy agent może wznowić pracę na podstawie zapisanego wyniku.
Brakujące szczegóły wymagają osobnego pytania. MCP nazywa to elicytacją: serwer prosi klienta o uzyskanie informacji od człowieka. Elicytacja URL otwiera zewnętrzną interakcję, na przykład ekran przeglądu w przeglądarce.
Bird używa potwierdzenia w przeglądarce dla oznaczonych operacji, w tym zamówień numerów, zamówień eSIM, operacji rejestracji 10DLC i wychodzących połączeń głosowych. Agent przygotowuje żądanie i zwraca link do przeglądu. Przeglądasz i uruchamiasz żądanie w przeglądarce. Zaakceptowanie elicytacji otwiera przegląd. Zapisany wynik operacji pozwala agentowi wznowić pracę. Przewodnik konfiguracji MCP wyjaśnia, jak połączyć klienta.
Błędy, które agent potrafi naprawić sam
Agent musi wiedzieć, co się nie udało, co zmienić i co wywołać dalej. Sprawdź odrzucone pole: błąd powinien wskazywać problem i akcję, która go rozwiązuje.
W przypadku tymczasowego błędu odpowiedź powinna informować, czy spróbować ponownie i ile czekać. Po utraconej odpowiedzi na akcję z konsekwencjami agent musi ustalić, co się wydarzyło, zanim spróbuje ponownie.
Odpowiedzi z błędem MCP od Bird zawierają stały kod, szczegóły pól i korektę, jeśli jest dostępna. Pole next opisuje następną akcję. retryable i retry_after informują agenta, czy i kiedy powtórzyć wywołanie. Identyfikator potwierdzenia pozwala pobrać zapisany status i wynik. Przewodnik po błędach API opisuje pola błędów.
Bezpieczne działanie
Agent musi rozróżniać odczyty, zapisy i akcje destrukcyjne. Sprawdź wskazówki dotyczące efektów narzędzia oraz jego reguły powtarzania żądania.
Klucz idempotentności identyfikuje zamierzoną akcję, dzięki czemu obsługiwana operacja może zwrócić zachowaną odpowiedź przy powtórnym żądaniu. Sprawdź okno powtórzenia i co agent powinien zrobić po jego wygaśnięciu.
Narzędzia Bird mają wskazówki read-only, destructive i idempotent. W operacjach z buforowanym powtórzeniem odpowiedzi domyślne okno wynosi trzy godziny. Użyj tego samego klucza i żądania w tym oknie. Po jego wygaśnięciu ponowna próba może wykonać akcję jeszcze raz. Sprawdź status operacji przed kolejną próbą. Przewodnik po idempotentności opisuje reguły właściwe dla poszczególnych operacji.
Zna produkt
Agent potrzebuje instrukcji produktowych podczas pracy. Zadaj pytanie o konfigurację i sprawdź, czy potrafi znaleźć odpowiednią dokumentację i przeczytać całą stronę.
Serwer powinien też udostępniać procedury wielokrotnego użytku. Umiejętności dają agentowi instrukcje zadań i pliki pomocnicze, które może załadować w razie potrzeby.
Bird udostępnia docs_search dla uszeregowanych sekcji dokumentacji i docs_read dla pełnej strony. Instrukcje serwera zawierają opracowane procedury. Skills over MCP udostępnia umiejętności bird-cli i email-audit z czytelnymi plikami i skrótami plików. Przewodnik po umiejętnościach agenta opisuje zadania, które obejmują.
Informuje agenta na bieżąco
Agent musi odróżniać przyjęcie żądania od jego ukończenia. Sprawdź, czy wynik zawiera identyfikatory i ustrukturyzowane pola, które agent może odczytać później.
Gdy praca kończy się później, klient powinien móc otrzymywać odpowiednie zmiany. Na przykład powiadomienie o dostarczeniu pozwala agentowi kontynuować po początkowej odpowiedzi na wysyłkę.
Bird zwraca zapisane wyniki potwierdzeń jako ustrukturyzowane JSON. Odczyty e-maili obejmują status wiadomości, status odbiorcy i zdarzenia. Hostowane zdarzenia MCP pozwalają agentom wyświetlać zdarzenia i subskrybować podpisane powiadomienia.
Pokazuje wyniki
Człowiek musi mieć możliwość przejrzenia szczegółowych wyników i podjęcia na ich podstawie działań. Sprawdź, czy Twój klient renderuje MCP Apps, rozszerzenie do interaktywnych interfejsów wewnątrz konwersacji.
Przydatny interfejs pozwala przeglądać bazowe rekordy lub odświeżać ich status. ChatGPT, Claude web i Desktop oraz VS Code GitHub Copilot obsługują renderowanie MCP Apps.
Standardowy endpoint MCP serwera Bird zawiera widżety weryfikacji DNS i dostarczania e-maili. Możesz przeglądać rekordy DNS i ponownie sprawdzać domenę wysyłkową. Widoki e-maili pokazują status dostarczenia, odbiorców i oś czasu zdarzeń. Przewodnik konfiguracji klienta MCP wyjaśnia, jak połączyć klienta.
Łączy jednym kliknięciem
Człowiek potrzebuje prostego sposobu na połączenie agenta. Sprawdź, czy klient może wykryć serwer i otworzyć logowanie.
Hostowany serwer Bird łączy się przez przeglądarkowe OAuth. Instrukcje połączenia klienta obejmują konfigurację i logowanie.
Bird znajduje się w oficjalnym rejestrze MCP i katalogu konektorów Claude. Instrukcje katalogu Bird wyjaśniają, jak połączyć się z poziomu Claude.
Jak ocenić serwer MCP
Wykonaj jedno prawdziwe zadanie od początku do końca i zapytaj:
- Czy agent otrzymuje taki sam dostęp jak użytkownik, bez dodatkowej konfiguracji?
- Czy wybiera właściwe narzędzie i argumenty na podstawie zwykłego zapytania?
- Czy przed kosztowną operacją człowiek ma możliwość jej zatwierdzenia?
- Gdy wywołanie kończy się błędem, czy odpowiedź z błędem wskazuje co naprawić, co wywołać dalej i czy spróbować ponownie?
- Czy agent może spróbować ponownie bez wykonywania tej samej operacji dwa razy?
- Czy potrafi samodzielnie znaleźć dokumentację produktu i instrukcje?
- Czy może sprawdzić, co się stało później, i otrzymywać informacje o zmianach?
- Czy widzisz wynik w swoim kliencie, a nie tylko czytasz o nim?