Zelfregistratie

De meeste agents werken met een account dat je al hebt: je stelt je agent in en die logt in via de browser. Deze gids beschrijft het andere pad, waarbij een agent zonder account er zelf een aanmaakt, volledig vanuit de terminal. Gebruik de CLI of curl om een e-mailadres te verifiëren en een organisatie, werkruimte en credential aan te maken. Lokale stdio MCP heeft een opgeslagen credential nodig om te kunnen starten; gehoste MCP biedt geen signup-tools. Je hebt toegang tot de e-mailinbox nodig om de verificatiecode op te halen. Signups via de Bird CLI of MCP-server worden toegeschreven aan de tool die ze heeft gedaan.

Gebruik de CLI

Voor de onderstaande CLI-commando's heb je de bird CLI nodig. Registratie en verificatie zijn regio-onafhankelijk en vereisen geen initiële configuratie. Geef in de laatste stap --region (us1 of eu1) door aan create-org om te kiezen waar het account en de bijbehorende data worden opgeslagen. Hostnamen of omgevingsvariabelen zijn niet nodig.

1. Vraag een inlogcode aan

bird auth signup mailt een zescijferige inlogcode. Het verifiëren van die code maakt het account aan als het e-mailadres nieuw is. Het gebruikt hetzelfde wachtwoordloze magic-link-pad als het dashboard, dus de gemailde code is alles wat je nodig hebt. Bewaar het e-mailadres voor de volgende stap.

bird auth signup you@example.com
# { "email": "you@example.com", "status": "code_sent" }

2. Verifieer het e-mailadres

De zescijferige code komt per e-mail, dus van buiten de CLI: lees hem uit de inbox. Geef hem samen met hetzelfde e-mailadres door aan bird auth verify-email, dat je inlogt en bij een gloednieuw account een eenmalig onboarding_ticket retourneert.

bird auth verify-email you@example.com --code 123456
# { "onboarding_ticket": "...", "user_id": "usr_..." }

3. Maak de organisatie aan

bird auth create-org verbruikt het ticket om je organisatie en werkruimte aan te maken, en slaat vervolgens de aangemaakte credential op zodat de CLI en de lokale stdio MCP-server vanaf dat moment authenticeren als het nieuwe account. Dit is eenmalig: een tweede aanroep retourneert 409. --region kiest waar het account en de bijbehorende data worden opgeslagen (us1 of eu1) en routeert de aanroep naar die regio; de CLI leidt de host daaruit af, dus je hoeft geen URL in te stellen.

bird auth create-org "Acme" --workspace-name "Production" --region us1 --onboarding-ticket "YOUR_ONBOARDING_TICKET"

Controleer of de credential werkt:

bird auth status   # authenticated: true, valid: true

Het account is actief en geauthenticeerd. De agent kan nu de CLI gebruiken om kanalen te configureren en berichten te verzenden.

Bekijk CLI-invoer voordat je uitvoert

Elke stap beschrijft zichzelf en vereist geen credential, zodat een agent de hele keten kan plannen voordat er iets wordt verstuurd. bird auth --help toont de geordende stappen, --example toont een bewerkbare request body, en --response-schema toont de velden die elk commando retourneert.

Gebruik curl

Je hebt curl en jq nodig, maar geen Bird CLI, MCP-verbinding, API-sleutel of browsersessie. Voer de commando's uit in dezelfde shell en stop als een verzoek mislukt. Kies us1 of eu1 voordat je begint; het verzoek om de organisatie aan te maken moet naar de host gaan die overeenkomt met de bijbehorende region.

umask 077
BIRD_SIGNUP_DIR=$(mktemp -d)
BIRD_REGION=us1
BIRD_BASE_URL="https://${BIRD_REGION}.platform.bird.com"
BIRD_EMAIL=you@example.com

De privédirectory bevat het verificatieantwoord en de credentials. Houd deze bestanden buiten versiebeheer, chattranscripten en gedeelde logs.

1. Vraag een inlogcode aan

jq -n --arg email "$BIRD_EMAIL" '{email: $email}' |
  curl --fail-with-body --silent --show-error \
    "$BIRD_BASE_URL/v1/auth/magic-link" \
    -H 'Content-Type: application/json' --data-binary @-

Een succesvol verzoek retourneert 204 zonder body. Lees de zescijferige code uit de e-mail; deze verloopt na 15 minuten. Het antwoord onthult niet of het account al bestaat.

2. Verifieer het e-mailadres

Vervang 123456 door de gemailde code. Sla het antwoord op zonder het onboarding-ticket te tonen:

BIRD_CODE=123456
jq -n --arg email "$BIRD_EMAIL" --arg code "$BIRD_CODE" \
  '{email: $email, code: $code}' |
  curl --fail-with-body --silent --show-error \
    "$BIRD_BASE_URL/v1/auth/magic-link/verify-code" \
    -H 'Content-Type: application/json' --data-binary @- \
    --output "$BIRD_SIGNUP_DIR/verified.json"
jq -e '.onboarding_ticket | type == "string" and length > 0' \
  "$BIRD_SIGNUP_DIR/verified.json" > /dev/null

Ga alleen verder als de verificatie slaagt en de ticketcontrole succesvol afsluit. Een nieuw geverifieerd account ontvangt een eenmalig onboarding_ticket. Een bestaand account met een organisatie heeft deze registratiestroom niet nodig; als de verificatie MFA vereist, doorloop dan in plaats daarvan de inlogstroom van het bestaande account.

3. Maak de organisatie en werkruimte aan

Kies je organisatie- en werkruimtenamen en houd region in lijn met BIRD_BASE_URL. Dit verzoek gebruikt het ticket, dus er is geen cookie jar of bearer token nodig:

jq -n --arg region "$BIRD_REGION" \
  --slurpfile verified "$BIRD_SIGNUP_DIR/verified.json" \
  '{org_name: "Acme", workspace_name: "Production", region: $region,
    onboarding_ticket: $verified[0].onboarding_ticket}' |
  curl --fail-with-body --silent --show-error \
    "$BIRD_BASE_URL/v1/auth/onboarding" \
    -H 'Content-Type: application/json' --data-binary @- \
    --output "$BIRD_SIGNUP_DIR/account.json"

Een succesvol antwoord is 201 en bevat organization, workspace, access_token, token_type en expires_in, plus een refresh token wanneer er een wordt uitgegeven. Het access token verloopt na het aantal seconden in expires_in. Sla het antwoord veilig op. Dit is een eenmalige accountconfiguratie; een account dat al een organisatie heeft, ontvangt 409.

4. Doe een geauthenticeerd verzoek

Schrijf de bearer header naar een privé curl-configuratiebestand en lees vervolgens de identiteit achter de credential:

jq -er '.access_token | select(type == "string" and length > 0) |
  "header = \"Authorization: Bearer \(.)\""' \
  "$BIRD_SIGNUP_DIR/account.json" > "$BIRD_SIGNUP_DIR/curl-auth.conf"
curl --fail-with-body --silent --show-error \
  --config "$BIRD_SIGNUP_DIR/curl-auth.conf" "$BIRD_BASE_URL/v1/auth/me"

Een 200-identiteitsantwoord bevestigt dat de credential werkt. Gebruik dezelfde bearer header en regionale host voor volgende API-aanroepen. Curl installeert geen credentials in de CLI of een MCP-client; verplaats de opgeslagen credentials naar de secretstore van je applicatie voordat je de tijdelijke directory verwijdert.

Vervolgstappen

• CLI voor agents is het commandocontract dat de aangemaakte credential nu ontgrendelt.
• MCP-server verbindt lokale stdio MCP na CLI-registratie, of gehoste MCP via OAuth.
• Verstuur je eerste e-mail is het pad zodra het account bestaat.