Im September haben wir angekündigt, dass die Kommunikationsinfrastruktur von Bird für KI-Agenten offen ist. Dieser Beitrag ist die Fassung dieser Ankündigung für Entwickler. Er nennt die Befehle, die ein Agent ausführt, womit er sich verbindet, wie er ein Konto erhält und welche Grenzen Sie ihm setzen können, jeweils mit der Seite, die es dokumentiert.
Die CLI
Ein Agent, der Shell-Befehle ausführen kann, etwa Claude Code, das Terminal von Cursor oder ein CI-Job, sollte mit der CLI beginnen: Sie verbraucht pro Operation weit weniger Tokens als MCP. Der im Folgenden beschriebene MCP-Server ist für Hosts gedacht, die Tools aufrufen, aber keine Shell ausführen können, sowie für MCP Events.
bird ist eine einzelne Binärdatei, die für die Steuerung durch einen Agenten gebaut ist. Die Ausgabe erfolgt als JSON auf stdout, Fehler gehen an stderr, und der Exit-Code gibt die Fehlerkategorie an. So kann ein Agent anhand des Ergebnisses verzweigen, ohne Fließtext zu parsen.
curl -fsSL https://cli.bird.com/install.sh | sh
bird auth login
Drei Flags erledigen für einen Agenten den Großteil der Arbeit. --example gibt einen gültigen Request-Body aus, --dry-run zeigt den Request, ohne ihn zu senden, und --idempotency-key macht einen erneuten Versuch sicher, wenn eine Antwort verloren geht. CLI für Agenten beschreibt den Vertrag, und die CLI-Referenz listet jeden Befehl auf.
Der gehostete MCP-Server
Manche Hosts rufen Tools auf und können keine Shell ausführen, etwa Claude Desktop, ChatGPT oder eine mobile App. Für sie läuft der Bird MCP-Server unter https://mcp.bird.com. Geben Sie diese URL an einen MCP-Client und melden Sie sich über Ihren Browser an. Danach hält der Client ein Token, das in Ihrem Namen handelt. Der Zustimmungsbildschirm zeigt die Berechtigungen, die der Client anfordert, und Sie können diejenigen abwählen, die der Agent nicht braucht. Sie installieren nichts und kopieren keinen API-Schlüssel. Zu den unterstützten Clients gehören Claude Code, Cursor, VS Code, Codex, Claude, ChatGPT und Muse, und Bird ist im Connector-Verzeichnis von Claude gelistet.
Der Server stellt die Bird API als Tools bereit. Ein verbundener Agent kann damit über die Kanäle senden, die Bird betreibt, diese Kanäle einrichten und Ihren Workspace einsehen. Ein Client mit einer Begrenzung der Tool-Anzahl kann sich mit https://mcp.bird.com/dynamic verbinden, der zwei Tools auflistet: search findet eine Operation und execute ruft sie auf. Mit MCP Events abonniert ein Client Ereignisse in Ihrem Workspace, etwa eine eingehende SMS oder neue E-Mails in einem Postfach, sodass der Agent nicht danach abfragen muss.
MCP-Server enthält die Schritte für jeden Client. Sobald die CLI installiert ist, startet bird mcp einen lokalen Server über stdio. Er bietet zusätzlich die Registrierungs-Tools und Uploads aus lokalen Dateien, stellt aber keine MCP Events bereit.
Registrierung über ein Terminal
Ein Agent ohne Konto kann sich über ein Terminal eines anlegen, ohne Browsersitzung und ohne Besuch im Dashboard. Dafür braucht er Zugriff auf ein E-Mail-Postfach, denn der Anmeldecode kommt per E-Mail:
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 legt die Organisation und ihren Workspace an und speichert ein Credential, das die CLI und der lokale MCP-Server ab dann verwenden. --region legt fest, wo das Konto und seine Daten liegen, us1 oder eu1. Dieselben drei Schritte funktionieren auch mit curl, für einen Agenten ohne CLI. Der gehostete MCP-Server bietet keine Registrierung an, weil ein Client ein Credential braucht, bevor er sich dort verbinden kann.
Dieses erste Credential hat weitreichende Rechte. Es enthält die Berechtigungen, die der Inhaber der neuen Organisation delegieren kann, einschließlich der Abrechnung der Organisation, und bei der Registrierung gibt es keinen Zustimmungsbildschirm, um sie einzuschränken. Bevor ein Agent unbeaufsichtigt läuft, erstellen Sie einen eingeschränkten API-Schlüssel für ihn. Self-Service-Registrierung beschreibt beide Wege.
Kontrollen für das, was ein Agent tun kann
Ein Agent, der über Bird sendet, besitzt ein Credential und verbraucht Ihr Guthaben. Agent controls dokumentiert auf einer Seite, was ihn begrenzt. Die folgenden vier Kontrollen sollten Sie einrichten, bevor ein Agent unbeaufsichtigt läuft. Die Zielland-Allowlist und das tägliche Ausgabenlimit gelten für SMS. E-Mail und WhatsApp haben keines von beiden, dort begrenzen die Scopes des Schlüssels und das Wallet einen Agenten. Dieselbe Seite behandelt sichere erneute Versuche: Senden Sie einen Idempotency-Key-Header oder --idempotency-key in der CLI, dann wird eine wiederholte Anfrage nur einmal angenommen.
Eingeschränkte API-Schlüssel. Ein API-Schlüssel gehört zu einem Workspace und trägt die Scopes, die Sie ihm geben, jeweils einen Produktbereich auf read- oder write-Ebene. Ein Schlüssel, der nur SMS sendet, hat sms:write, und eine Anfrage außerhalb seiner Scopes gibt 403 zurück. Ein Schlüssel kann keinen weiteren Schlüssel ausstellen und hat keinen Zugriff auf die Abrechnung.
bird auth login --scope api_keys:write --scope sms:write # an existing account
bird api-keys create --name "Support agent" --scope sms:write
Die Anmeldung muss api_keys:write und die Scopes besitzen, die der Schlüssel tragen soll. Das Credential aus der Registrierung im Terminal besitzt sie bereits, daher führen Sie nach bird auth create-org nur den zweiten Befehl aus. Melden Sie sich dort nicht erneut an, denn eine neue Anmeldung ersetzt das Credential aus der Registrierung. Führen Sie den Befehl in einer Shell aus, in der BIRD_API_KEY nicht gesetzt ist, weil die CLI diesen Schlüssel einer Anmeldung vorzieht und ein Schlüssel keine Schlüssel ausstellen kann.
Geben Sie dem Agenten dann den Schlüssel und nichts mit weiteren Rechten. Setzen Sie BIRD_API_KEY in der Umgebung des Agenten, oder senden Sie den Schlüssel aus Ihrem Code als Bearer-Token. Eine Anmeldung bleibt auf dem Rechner gespeichert, auf dem sie ausgeführt wurde, und ein Agent ohne BIRD_API_KEY auf diesem Rechner verwendet sie. Führen Sie den Agenten woanders aus, oder entfernen Sie die Anmeldung mit bird auth logout.
Standardmäßig gesperrte SMS-Ziele. Ein Workspace sendet SMS an die Länder auf seiner Zielland-Allowlist. Die Allowlist ist anfangs leer, und Bird fügt das Heimatland Ihrer Organisation hinzu, sobald es festgelegt ist. Ein Versand über die SMS API in ein anderes Land wird mit 422 SMSDestinationNotEnabled abgelehnt, bevor ein Absender ermittelt wird, sodass ein Agent, der auf ein unerwartetes Land zielt, abgewiesen wird. Verifizierungscodes nutzen diese Liste nicht. Verify hat eine eigene, in der jedes Land anfangs aktiviert ist, und auch Voice hat eigene Einstellungen.
Tägliche Ausgabenlimits. Jedes SMS-Zielland kann ein tägliches Ausgabenlimit in der Währung Ihres Wallets haben. Sobald die Tagesausgaben für dieses Land das Limit erreichen, lehnt Bird dort neue Nachrichten bis Mitternacht UTC ab. Das Limit ist nicht exakt: Ausgaben zählen, sobald eine Nachricht berechnet wird, daher können bereits angenommene Nachrichten die Tagessumme darüber hinaus treiben. Von SMS gesendete Verifizierungscodes zählen zum Limit. Dieser Befehl aktiviert die Niederlande mit einem Limit von 25 EUR pro Tag in einem Workspace, dessen Wallet in EUR geführt wird:
bird sms destinations update --destination "NL=true;25EUR"
Um die Allowlist oder ein Limit zu ändern, ist der Scope sms_management auf write-Ebene nötig. Geben Sie dem sendenden Agenten sms und behalten Sie sms_management dem Credential vor, das den Workspace konfiguriert, dann kann der Agent seine eigenen Limits nicht erhöhen.
Das Prepaid-Guthaben. Pay-as-you-go-Sendungen werden aus dem Prepaid-Guthaben Ihrer Organisation bezahlt. Eine SMS-Sendung, die das Guthaben nicht deckt, wird mit 402 abgelehnt. Manche Kosten werden erst abgerechnet, nachdem eine Sendung angenommen wurde (E-Mail in einem kostenpflichtigen Email-Tarif und Gebühren, die bei der Zustellung anfallen), und die automatische Aufladung füllt das Guthaben von einer gespeicherten Karte auf. Lesen Sie deshalb die Regeln zum Guthaben, bevor Sie das Guthaben als feste Obergrenze behandeln. Abrechnungsvorgänge erfordern die Abrechnungsberechtigung der Organisation, die ein API-Schlüssel nicht haben kann. Geben Sie einem unbeaufsichtigten Agenten einen eingeschränkten Schlüssel, dann bleibt das Aufladen von Guthaben bei den Personen, die das Budget verantworten.
Wie es weitergeht
- Einem Agenten eine eigene Telefonnummer und ein eigenes Postfach geben: eine
inbox.ai-Adresse und eine dedizierte Nummer, die beide senden und empfangen. Vor der ersten Nummer lädt eine Person das Guthaben auf, und ein Inhaber der Organisation schließt die Identitätsprüfung ab. Die Anleitung nennt die Schritte einer Bestellung, für die eine Person nötig ist. - Bird für europäische Kunden: die niederländische Gesellschaft, mit der Sie den Vertrag schließen, die Region
eu1und der Auftragsverarbeitungsvertrag. - Supabase-Auth-SMS-Codes mit Bird senden: Anmeldecodes per Telefon für ein Supabase-Projekt, gesendet über die Bird SMS API.
- Ihren Coding-Agenten einrichten: Fügen Sie einen Prompt ein, und Ihr Agent installiert die CLI und die Skills von Bird.