---
title: "Was ein KI-Agent auf Bird tun kann: CLI, MCP, Registrierung im Terminal und Ausgabenkontrollen"
description: "Was ein KI-Agent auf Bird nutzt, mit Links: die bird-CLI, der gehostete MCP-Server, die Kontoregistrierung im Terminal und die Kontrollen darüber, was er ausgeben kann."
canonical: "https://bird.com/de-de/blog/what-an-ai-agent-can-do-on-bird"
---

Im September haben wir angekündigt, dass [die Kommunikationsinfrastruktur von Bird für KI-Agenten offen ist](/blog/bird-450-million-financing-agentic-harness). 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.

```bash
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](/docs/ai/cli-for-agents) beschreibt den Vertrag, und die [CLI-Referenz](/docs/cli) 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](https://claude.ai/directory/bird) 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](/docs/ai/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](/docs/ai/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:

```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` 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](/docs/ai/agent-controls#choose-the-credential-the-agent-holds) für ihn. [Self-Service-Registrierung](/docs/ai/self-serve-signup) 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](/docs/ai/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.

```bash
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](/docs/guides/verify/destinations) hat eine eigene, in der jedes Land anfangs aktiviert ist, und auch [Voice](/docs/guides/voice/destinations) 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:

```bash
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](/docs/guides/billing-and-usage#the-wallet), 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](/docs/ai/agent-number-and-inbox): 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](/docs/knowledge-base/compliance/european-customers): die niederländische Gesellschaft, mit der Sie den Vertrag schließen, die Region `eu1` und der Auftragsverarbeitungsvertrag.
- [Supabase-Auth-SMS-Codes mit Bird senden](/docs/knowledge-base/integrations/supabase): Anmeldecodes per Telefon für ein Supabase-Projekt, gesendet über die Bird SMS API.
- [Ihren Coding-Agenten einrichten](/docs/ai/set-up-your-agent): Fügen Sie einen Prompt ein, und Ihr Agent installiert die CLI und die Skills von 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)
