We wrześniu ogłosiliśmy, że infrastruktura komunikacyjna Bird jest otwarta dla agentów AI. Ten wpis to wersja tego ogłoszenia dla programistów. Wymienia polecenia, które uruchamia agent, usługi, z którymi się łączy, sposób, w jaki uzyskuje konto, oraz limity, które możesz na niego nałożyć, a przy każdym z tych elementów podaje stronę z dokumentacją.
CLI
Agent, który może uruchamiać polecenia powłoki, taki jak Claude Code, terminal w Cursorze czy zadanie CI, powinien zacząć od CLI, ponieważ na każdą operację zużywa znacznie mniej tokenów niż MCP. Serwer MCP, opisany dalej, jest przeznaczony dla hostów, które wywołują narzędzia i nie mogą uruchomić powłoki, a także do obsługi MCP Events.
bird to pojedynczy plik binarny zaprojektowany do obsługi przez agenta. Wynik trafia jako JSON na stdout, błędy trafiają na stderr, a kod wyjścia określa kategorię błędu, dzięki czemu agent może rozgałęziać działanie na podstawie wyniku bez analizowania tekstu.
curl -fsSL https://cli.bird.com/install.sh | sh
bird auth login
Większość pracy agenta wykonują trzy flagi. --example wyświetla poprawną treść żądania, --dry-run pokazuje żądanie bez wysyłania go, a --idempotency-key sprawia, że ponowna próba jest bezpieczna, gdy odpowiedź zostanie utracona. Strona CLI dla agentów opisuje ten kontrakt, a dokumentacja CLI wymienia wszystkie polecenia.
Hostowany serwer MCP
Niektóre hosty wywołują narzędzia i nie mogą uruchomić powłoki, na przykład Claude Desktop, ChatGPT czy aplikacja mobilna. Dla nich serwer MCP Bird działa pod adresem https://mcp.bird.com. Podaj ten URL klientowi MCP i zaloguj się w przeglądarce, a klient otrzyma token, który działa w Twoim imieniu. Ekran zgody pokazuje uprawnienia, o które prosi klient, a Ty możesz odznaczyć te, których agent nie potrzebuje. Niczego nie instalujesz i nie kopiujesz żadnego klucza API. Obsługiwane klienty to m.in. Claude Code, Cursor, VS Code, Codex, Claude, ChatGPT i Muse, a Bird znajduje się w katalogu konektorów Claude.
Serwer udostępnia API Bird jako narzędzia, więc podłączony agent może wysyłać wiadomości kanałami obsługiwanymi przez Bird, konfigurować te kanały i przeglądać Twój obszar roboczy. Klient z limitem liczby narzędzi może połączyć się z https://mcp.bird.com/dynamic, który udostępnia dwa narzędzia: search wyszukuje operację, a execute ją wywołuje. Dzięki MCP Events klient subskrybuje zdarzenia w Twoim obszarze roboczym, takie jak przychodząca wiadomość SMS czy nowa poczta w skrzynce, więc agent nie musi ich odpytywać.
Strona Serwer MCP zawiera instrukcje dla każdego klienta. Po zainstalowaniu CLI polecenie bird mcp uruchamia lokalny serwer przez stdio. Dodaje on narzędzia rejestracji i przesyłanie plików lokalnych, ale nie obsługuje MCP Events.
Rejestracja z terminala
Agent, który nie ma konta, może je utworzyć z terminala, bez sesji w przeglądarce i bez wchodzenia do panelu. Potrzebuje dostępu do skrzynki e-mail, ponieważ kod logowania przychodzi e-mailem:
bird auth signup you@example.com
bird auth verify-email you@example.com --code 123456
bird auth create-org "Acme" --workspace-name "Production" --region eu1 --onboarding-ticket "YOUR_ONBOARDING_TICKET"
bird auth create-org tworzy organizację i jej obszar roboczy oraz zapisuje poświadczenie, którego od tej pory używają CLI i lokalny serwer MCP. --region określa, gdzie znajdują się konto i jego dane: us1 lub eu1. Te same trzy kroki działają z curl, dla agenta, który nie ma CLI. Hostowany serwer MCP nie oferuje rejestracji, ponieważ klient potrzebuje poświadczenia, zanim będzie mógł się z nim połączyć.
To pierwsze poświadczenie ma szeroki zakres. Obejmuje uprawnienia, które właściciel nowej organizacji może delegować, łącznie z rozliczeniami organizacji, a rejestracja nie wyświetla ekranu zgody, na którym można je zawęzić. Zanim agent zacznie działać bez nadzoru, utwórz dla niego klucz API z ograniczonym zakresem. Samodzielna rejestracja opisuje obie ścieżki krok po kroku.
Kontrola nad tym, co może zrobić agent
Agent, który wysyła wiadomości przez Bird, ma poświadczenie i wydaje Twoje saldo. Kontrola agentów opisuje na jednej stronie, co go ogranicza. Oto cztery ustawienia, które warto skonfigurować, zanim agent zacznie działać bez nadzoru. Lista dozwolonych miejsc docelowych i dzienny limit wydatków dotyczą SMS. E-mail i WhatsApp nie mają żadnego z nich, więc tam agenta ograniczają zakresy klucza i portfel. Ta sama strona opisuje bezpieczne ponowne próby: wyślij nagłówek Idempotency-Key lub użyj --idempotency-key w CLI, a powtórzone żądanie zostanie przyjęte tylko raz.
Klucze API z ograniczonym zakresem. Klucz API należy do jednego obszaru roboczego i ma zakresy, które mu nadasz. Każdy zakres to obszar produktu na poziomie read lub write. Klucz, który wysyła tylko SMS, ma sms:write, a żądanie spoza jego zakresów zwraca 403. Klucz nie może wystawić innego klucza ani uzyskać dostępu do rozliczeń.
bird auth login --scope api_keys:write --scope sms:write # an existing account
bird api-keys create --name "Support agent" --scope sms:write
Zalogowane konto musi mieć api_keys:write oraz zakresy, które ma otrzymać klucz. Poświadczenie z rejestracji w terminalu już je ma, więc po bird auth create-org uruchom tylko drugie polecenie. Nie loguj się tam ponownie: nowe logowanie zastępuje poświadczenie z rejestracji. Uruchom je w powłoce, w której nie ustawiono BIRD_API_KEY, ponieważ CLI używa tego klucza zamiast zalogowanego konta, a klucz nie może wystawiać kluczy.
Następnie przekaż agentowi klucz i nic o szerszym zakresie. Ustaw BIRD_API_KEY w środowisku agenta lub wysyłaj klucz jako token bearer ze swojego kodu. Logowanie pozostaje zapisane na maszynie, na której je wykonano, a agent działający na niej bez BIRD_API_KEY z niego korzysta. Uruchom agenta w innym miejscu lub usuń logowanie za pomocą bird auth logout.
Domyślnie zablokowane miejsca docelowe SMS. Obszar roboczy wysyła SMS do krajów z jego listy dozwolonych miejsc docelowych. Lista jest początkowo pusta, a Bird dodaje do niej kraj macierzysty Twojej organizacji, jeśli jest ustawiony. Wysyłka przez SMS API do dowolnego innego kraju jest odrzucana z 422 SMSDestinationNotEnabled, zanim zostanie ustalony nadawca, więc agent skierowany do nieoczekiwanego kraju otrzyma odmowę. Kody weryfikacyjne nie korzystają z tej listy. Verify ma własną listę, na której wszystkie kraje są początkowo włączone, a Voice również ma własne ustawienia.
Dzienne limity wydatków. Każdy kraj docelowy SMS może mieć dzienny limit wydatków w walucie Twojego portfela. Gdy dzienne wydatki na dany kraj osiągną limit, Bird odrzuca nowe wiadomości do niego do północy UTC. Limit nie jest dokładny: wydatki są liczone w chwili obciążenia za wiadomość, więc wiadomości już przyjęte mogą sprawić, że dzienna suma go przekroczy. Kody weryfikacyjne wysyłane przez SMS wliczają się do limitu. To polecenie włącza Holandię z limitem 25 EUR dziennie w obszarze roboczym, którego portfel jest w EUR:
bird sms destinations update --destination "NL=true;25EUR"
Zmiana listy dozwolonych krajów lub limitu wymaga zakresu sms_management na poziomie write. Nadaj agentowi wysyłającemu sms, zachowaj sms_management dla poświadczenia, które konfiguruje obszar roboczy, a agent nie będzie mógł podnieść własnych limitów.
Portfel przedpłacony. Wysyłki w modelu pay-as-you-go są pokrywane z przedpłaconego portfela Twojej organizacji. Wysyłka SMS, której saldo nie pokrywa, zostaje odrzucona z kodem 402. Niektóre opłaty są rozliczane po przyjęciu wysyłki (e-mail w płatnym planie Email oraz opłaty naliczane przy doręczeniu), a automatyczne doładowanie uzupełnia portfel z zapisanej karty, więc zapoznaj się z zasadami portfela, zanim potraktujesz saldo jako sztywny limit. Operacje rozliczeniowe wymagają uprawnienia organizacji do rozliczeń, którego klucz API nie może mieć. Daj agentowi działającemu bez nadzoru klucz z ograniczonymi zakresami, a dodawanie środków pozostanie w rękach osób odpowiedzialnych za budżet.
Co dalej
- Daj agentowi własny numer telefonu i skrzynkę odbiorczą: adres
inbox.aii dedykowany numer, które wysyłają i odbierają wiadomości. Przed pierwszym numerem osoba zasila portfel, a właściciel organizacji przechodzi weryfikację tożsamości. Przewodnik wskazuje, które kroki zamówienia wymagają udziału człowieka. - Bird dla klientów z Europy: holenderski podmiot, z którym zawierasz umowę, region
eu1oraz umowa powierzenia przetwarzania danych. - Wysyłaj kody SMS z Supabase Auth przez Bird: kody logowania telefonicznego dla projektu Supabase, wysyłane przez Bird SMS API.
- Skonfiguruj swojego agenta kodującego: wklej jeden prompt, a Twój agent zainstaluje CLI i umiejętności Bird.