---
title: "Co agent AI może robić w Bird: CLI, MCP, rejestracja z terminala i kontrola wydatków"
description: "Z czego agent AI korzysta w Bird, wraz z linkami: CLI bird, hostowany serwer MCP, rejestracja konta z terminala oraz kontrola tego, ile agent może wydać."
canonical: "https://bird.com/pl-pl/blog/what-an-ai-agent-can-do-on-bird"
---

We wrześniu ogłosiliśmy, że [infrastruktura komunikacyjna Bird jest otwarta dla agentów AI](/blog/bird-450-million-financing-agentic-harness). 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.

```bash
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](/docs/ai/cli-for-agents) opisuje ten kontrakt, a [dokumentacja CLI](/docs/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](https://claude.ai/directory/bird).

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](/docs/ai/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](/docs/ai/mcp-server) 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:

```bash
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](/docs/ai/agent-controls#choose-the-credential-the-agent-holds). [Samodzielna rejestracja](/docs/ai/self-serve-signup) 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](/docs/ai/agent-controls) 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ń.

```bash
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](/docs/guides/verify/destinations) ma własną listę, na której wszystkie kraje są początkowo włączone, a [Voice](/docs/guides/voice/destinations) 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:

```bash
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](/docs/guides/billing-and-usage#the-wallet), 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ą](/docs/ai/agent-number-and-inbox): adres `inbox.ai` i 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](/docs/knowledge-base/compliance/european-customers): holenderski podmiot, z którym zawierasz umowę, region `eu1` oraz umowa powierzenia przetwarzania danych.
- [Wysyłaj kody SMS z Supabase Auth przez Bird](/docs/knowledge-base/integrations/supabase): kody logowania telefonicznego dla projektu Supabase, wysyłane przez Bird SMS API.
- [Skonfiguruj swojego agenta kodującego](/docs/ai/set-up-your-agent): wklej jeden prompt, a Twój agent zainstaluje CLI i umiejętności Bird.

## Related resources

- [Bird pricing](/pricing) (product)
- [Setting up your coding agent](/learn/basics/setting-up-your-coding-agent) (video)
- [What is an MCP server, and how does an agent use one to send messages?](/explained/platform/what-is-an-mcp-server-and-how-does-an-agent-send-messages) (answer)
- [Build with AI agents](/learn/paths/agents) (course)

[Get an implementation brief](/learn/workspace?topic=billing)
