---
title: "Wat een AI-agent kan doen op Bird: CLI, MCP, aanmelden via de terminal en uitgavenlimieten"
description: "Wat een AI-agent gebruikt op Bird, met links: de bird-CLI, de gehoste MCP-server, een account aanmaken vanuit een terminal en de limieten op wat een agent kan uitgeven."
canonical: "https://bird.com/nl-nl/blog/what-an-ai-agent-can-do-on-bird"
---

In september maakten we bekend dat [de communicatie-infrastructuur van Bird openstaat voor AI-agents](/blog/bird-450-million-financing-agentic-harness). Dit artikel is de versie van die aankondiging voor developers. Het noemt de commando's die een agent uitvoert, waarmee de agent verbinding maakt, hoe de agent een account krijgt en welke limieten je kunt instellen, telkens met de pagina waarop het gedocumenteerd is.

## De CLI

Een agent die shellcommando's kan uitvoeren, zoals Claude Code, de terminal van Cursor of een CI-job, begint het best met de CLI: die gebruikt per bewerking veel minder tokens dan MCP. De MCP-server, die hierna aan bod komt, is bedoeld voor hosts die tools aanroepen maar geen shell kunnen uitvoeren, en voor MCP Events.

`bird` is één binary die is gebouwd om door een agent te worden aangestuurd. De uitvoer is JSON op stdout, fouten gaan naar stderr en de exitcode geeft de foutcategorie aan. Zo kan een agent op het resultaat reageren zonder tekst te hoeven parsen.

```bash
curl -fsSL https://cli.bird.com/install.sh | sh
bird auth login
```

Drie flags doen het meeste werk voor een agent. `--example` toont een geldige request body, `--dry-run` laat het verzoek zien zonder het te versturen en `--idempotency-key` maakt opnieuw proberen veilig wanneer een antwoord verloren gaat. [CLI voor agents](/docs/ai/cli-for-agents) beschrijft het contract en de [CLI-referentie](/docs/cli) somt elk commando op.

## De gehoste MCP-server

Sommige hosts roepen tools aan maar kunnen geen shell uitvoeren, zoals Claude Desktop, ChatGPT of een mobiele app. Voor die hosts draait de Bird MCP-server op `https://mcp.bird.com`. Geef die URL aan een MCP-client en meld je aan via je browser. De client krijgt dan een token dat namens jou handelt. Het toestemmingsscherm toont de rechten die de client vraagt, en je kunt de rechten uitvinken die de agent niet nodig heeft. Je installeert niets en kopieert geen API-sleutel. Ondersteunde clients zijn onder meer Claude Code, Cursor, VS Code, Codex, Claude, ChatGPT en Muse, en Bird staat in [de connectordirectory van Claude](https://claude.ai/directory/bird).

De server stelt de Bird API beschikbaar als tools. Een verbonden agent kan dus versturen via de kanalen die Bird aanbiedt, die kanalen instellen en je werkruimte bekijken. Een client met een limiet op het aantal tools kan verbinding maken met `https://mcp.bird.com/dynamic`, dat twee tools aanbiedt: `search` zoekt een bewerking en `execute` roept die aan. Met [MCP Events](/docs/ai/mcp-events) abonneert een client zich op wat er in je werkruimte gebeurt, zoals een inkomende SMS of nieuwe mail in een mailbox. De agent hoeft daar dan niet steeds naar te vragen.

[MCP-server](/docs/ai/mcp-server) beschrijft de stappen per client. Zodra de CLI geïnstalleerd is, start `bird mcp` een lokale server via stdio. Die voegt de tools voor aanmelden en uploads van lokale bestanden toe, maar ondersteunt geen MCP Events.

## Aanmelden vanuit een terminal

Een agent zonder account kan er een aanmaken vanuit een terminal, zonder browsersessie en zonder het dashboard te bezoeken. De agent heeft toegang tot een e-mailinbox nodig, omdat de inlogcode per e-mail binnenkomt:

```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` maakt de organisatie en haar werkruimte aan, en slaat een credential op die de CLI en de lokale MCP-server vanaf dan gebruiken. `--region` bepaalt waar het account en de gegevens ervan staan: `us1` of `eu1`. Dezelfde drie stappen werken met curl, voor een agent zonder CLI. De gehoste MCP-server biedt geen aanmelding, omdat een client een credential nodig heeft voordat hij daar verbinding kan maken.

Die eerste credential is ruim. Hij bevat de rechten die de eigenaar van de nieuwe organisatie kan delegeren, inclusief facturering van de organisatie, en bij het aanmelden verschijnt geen toestemmingsscherm om die te beperken. [Maak een API-sleutel met beperkte scopes](/docs/ai/agent-controls#choose-the-credential-the-agent-holds) voor de agent voordat die zonder toezicht draait. [Zelf aanmelden](/docs/ai/self-serve-signup) beschrijft beide routes stap voor stap.

## Beperkingen op wat een agent kan doen

Een agent die via Bird verstuurt, heeft een credential en geeft je saldo uit. [Agentbeperkingen](/docs/ai/agent-controls) beschrijft op één pagina wat die agent begrenst. Dit zijn de vier instellingen die je vastlegt voordat een agent zonder toezicht draait. De allowlist van bestemmingen en de dagelijkse uitgavenlimiet gelden voor SMS. E-mail en WhatsApp hebben geen van beide, dus daar begrenzen de scopes van de sleutel en de wallet een agent. Dezelfde pagina behandelt veilig opnieuw proberen: stuur een `Idempotency-Key`-header mee, of `--idempotency-key` in de CLI, en een herhaald verzoek wordt één keer geaccepteerd.

**API-sleutels met beperkte scopes.** Een API-sleutel hoort bij één werkruimte en heeft de scopes die je eraan geeft, elk een productgebied op `read`- of `write`-niveau. Een sleutel die alleen SMS verstuurt, heeft `sms:write`, en een verzoek buiten de scopes geeft `403` terug. Een sleutel kan geen andere sleutel uitgeven en heeft geen toegang tot facturering.

```bash
bird auth login --scope api_keys:write --scope sms:write   # an existing account
bird api-keys create --name "Support agent" --scope sms:write
```

De inlog moet `api_keys:write` hebben en de scopes die de sleutel krijgt. De credential van het aanmelden via de terminal heeft die al, dus na `bird auth create-org` voer je alleen het tweede commando uit. Log daar niet opnieuw in: een nieuwe inlog vervangt de credential van de aanmelding. Voer het uit in een shell waarin `BIRD_API_KEY` niet is ingesteld, omdat de CLI die sleutel voorrang geeft boven een inlog, en een sleutel geen sleutels kan uitgeven.

Geef de agent daarna de sleutel en niets ruimers. Stel `BIRD_API_KEY` in de omgeving van de agent in, of stuur de sleutel als bearer-token vanuit je code. Een inlog blijft opgeslagen op de machine waar die is uitgevoerd, en een agent op die machine zonder `BIRD_API_KEY` gebruikt hem. Laat de agent ergens anders draaien, of verwijder de inlog met `bird auth logout`.

**SMS-bestemmingen standaard geweigerd.** Een werkruimte verstuurt SMS naar de landen op de allowlist van bestemmingen. De allowlist is eerst leeg, en Bird voegt het thuisland van je organisatie toe zodra dat is ingesteld. Een verzending via de SMS API naar een ander land wordt geweigerd met `422 SMSDestinationNotEnabled` voordat er een afzender wordt bepaald, dus een agent die op een onverwacht land is gericht, wordt tegengehouden. Verificatiecodes gebruiken deze lijst niet. [Verify](/docs/guides/verify/destinations) heeft een eigen lijst, waarin elk land standaard is ingeschakeld, en [Voice](/docs/guides/voice/destinations) heeft ook eigen instellingen.

**Dagelijkse uitgavenlimieten.** Elk SMS-bestemmingsland kan een dagelijkse uitgavenlimiet hebben, in de valuta van je wallet. Zodra de uitgaven van die dag naar dat land de limiet bereiken, weigert Bird nieuwe berichten daarheen tot middernacht UTC. De limiet is niet exact: uitgaven tellen op het moment dat een bericht wordt afgerekend, dus berichten die al zijn geaccepteerd, kunnen het dagtotaal erboven brengen. Verificatiecodes die SMS verstuurt, tellen mee voor de limiet. Dit commando schakelt Nederland in met een limiet van 25 EUR per dag, in een werkruimte waarvan de wallet in EUR is:

```bash
bird sms destinations update --destination "NL=true;25EUR"
```

Voor het wijzigen van de allowlist of een limiet is de scope `sms_management` op `write`-niveau nodig. Geef de verzendende agent `sms` en bewaar `sms_management` voor de credential die de werkruimte configureert. Dan kan de agent zijn eigen limieten niet verhogen.

**De prepaid wallet.** Pay-as-you-go-verzendingen worden afgeschreven van de prepaid wallet van je organisatie. Een SMS-verzending die het saldo niet kan dekken, wordt geweigerd met `402`. Sommige kosten worden pas verrekend nadat een verzending is geaccepteerd (e-mail met een betaald Email-abonnement en kosten die bij aflevering worden berekend), en automatisch opwaarderen vult de wallet aan vanaf een opgeslagen kaart. Lees daarom [de walletregels](/docs/guides/billing-and-usage#the-wallet) voordat je het saldo als harde limiet beschouwt. Factureringsbewerkingen vereisen de factureringsbevoegdheid van de organisatie, die een API-sleutel niet kan hebben. Geef een agent die zonder toezicht draait een sleutel met beperkte scopes, dan blijft het toevoegen van tegoed bij de mensen die het budget beheren.

## Volgende stappen

- [Geef een agent een eigen telefoonnummer en inbox](/docs/ai/agent-number-and-inbox): een `inbox.ai`-adres en een eigen nummer die allebei kunnen verzenden en ontvangen. Voor het eerste nummer vult iemand de wallet aan en voltooit een eigenaar van de organisatie de identiteitsverificatie. De handleiding vermeldt welke stappen van een bestelling een persoon vereisen.
- [Bird voor Europese klanten](/docs/knowledge-base/compliance/european-customers): de Nederlandse entiteit waarmee je een contract sluit, de regio `eu1` en de verwerkersovereenkomst.
- [Supabase Auth-SMS-codes verzenden met Bird](/docs/knowledge-base/integrations/supabase): inlogcodes per telefoon voor een Supabase-project, verzonden via de Bird SMS API.
- [Je coding agent instellen](/docs/ai/set-up-your-agent): plak één prompt en je agent installeert de CLI en de skills van 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)
