Czym jest serwer MCP i jak agent używa go do wysyłania wiadomości?

Asystent organizujący powiadomienie o dostawie potrzebuje dostępu do nadawcy, odbiorcy i treści wiadomości. Podłączone narzędzie pozwala mu przesłać te pola bez umieszczania danych uwierzytelniających w konwersacji.

MCP to protokół łączący aplikację z tymi narzędziami.

Co udostępnia serwer MCP?

Serwer przekazuje klientowi AI nazwy narzędzi, schematy wejściowe i wywoływalne operacje.

W ramach modelu narzędzi MCP klient odkrywa narzędzia. Przesyła ustrukturyzowane argumenty, gdy agent wybierze jedno z nich.

Narzędzia Bird obejmują wysyłanie wiadomości e-mail, SMS i WhatsApp. Narzędzia konfiguracyjne zarządzają domenami wysyłkowymi, numerami i wymaganiami nadawcy. Narzędzia weryfikacji rozpoczynają weryfikację. Sprawdzają też kody. Osobne narzędzie przełącza na inny kanał.

Lista dostępnych narzędzi w kliencie identyfikuje każdą operację i jej wymagane dane wejściowe. Sprawdź tę listę, gdy oczekiwana operacja nie jest widoczna.

Jak połączyć się z hostowanym serwerem?

Dodaj https://mcp.bird.com jako zdalny serwer MCP. Zaloguj się przez przeglądarkę.

Nie musisz instalować CLI ani podawać klucza API. Logowanie przez przeglądarkę pozwala klientowi przechowywać token z podzbiorem Twoich uprawnień. Bird weryfikuje każde żądanie względem uprawnień w tym tokenie.

Niektóre klienty pokazują serwer jako wymagający uwierzytelnienia, dopóki nie rozpoczniesz logowania. Klient z samym URL-em może wylistować narzędzia. Bez uwierzytelnienia wywołanie narzędzia może zwrócić 401.

Zakończ uwierzytelnianie przed testowaniem wywołania narzędzia. Przewodnik połączenia zawiera kroki konfiguracji dla obsługiwanych klientów.

Jak agent wysyła i sprawdza wiadomość?

Potwierdź, że odbiorca wyraził zgodę na wiadomość, a treść spełnia Twoją obowiązującą politykę. Wywołaj narzędzie send kanału. Odczytaj zdarzenia dostarczenia wynikowej wiadomości.

Dla e-maila sekwencja jest następująca:

1. Potwierdź obszar roboczy, tożsamość nadawczą, odbiorcę i treść.
2. Wywołaj email_send z wymaganymi polami z jego schematu wejściowego.
3. Zapisz zwrócony identyfikator wiadomości.
4. Użyj email_get, aby sprawdzić status dostarczenia, wyniki dla odbiorcy i oś czasu zdarzeń.

Przyjęta wysyłka nie dowodzi dostarczenia. Późniejsze odrzucenie lub zwrot wymaga obsługi błędu przez agenta lub aplikację.

Brakujący nadawca lub uprawnienie mogą uniemożliwić wysyłkę. Narzędzia konfiguracyjne i diagnostyczne pozwalają agentowi sprawdzić te wymagania przed ponowną próbą.

Czy mogę uruchomić serwer lokalnie?

Tak. Zainstaluj Bird CLI. Zaloguj się za pomocą bird auth login. Skonfiguruj klienta, aby uruchamiał bird mcp.

Klient uruchamia proces. Komunikuje się przez strumienie wejścia i wyjścia procesu. Wymaga bird jako polecenia i mcp jako argumentu.

Serwer lokalny i hostowany udostępniają ten sam zestaw narzędzi. Lokalne uruchomienie procesu nadal wymaga dostępu do sieci dla operacji Bird API.

Użyj procesu lokalnego, gdy chcesz zarządzać nim samodzielnie. Klient musi mieć możliwość uruchamiania poleceń. Użyj hostowanego URL-a, gdy klient nie może uruchomić lokalnego pliku binarnego.

Co kontroluje, jakie działania może wykonywać agent?

Podłączone dane uwierzytelniające ograniczają dostęp. Host AI kontroluje, kiedy wykonanie narzędzia wymaga potwierdzenia.

Bird oznacza destrukcyjne narzędzia adnotacjami, aby host mógł je rozpoznać. Na przykład usunięcie blokady e-mail jest oznaczone jako destrukcyjne, ponieważ może wznowić niechcianą wysyłkę.

Same adnotacje nie wymuszają monitu o zatwierdzenie. Skonfiguruj politykę hosta, zanim zezwolisz na zmiany w zasobach produkcyjnych.

Agent, który może stworzyć szkic i przesłać szablon e-mail, może też go opublikować. Sam krok szkicu nie uniemożliwia agentowi wywołania narzędzia przesyłania.

Przesłanie szablonu WhatsApp wysyła szablon do Meta w celu weryfikacji. Nie zapewnia kroku zatwierdzania przez człowieka dla każdego innego działania dostępnego agentowi.

Narzędzia głosowe sprawdzają połączenia. Wydają też dane uwierzytelniające klienta. Żadne narzędzie MCP nie inicjuje połączenia głosowego. CLI udostępnia operację połączenia testowego.

Dla agentów z dostępem do powłoki CLI zapewnia dane wyjściowe JSON i kody zakończenia. Wybierz interfejs, który Twój host może wykonać. Ustaw jego politykę potwierdzania dla zamierzonych działań.