# Schnellstart

In vier Schritten von null zur ersten deutschen Rufnummer für deinen KI-Agenten.

> Early Access: Die Schnittstellen sind als Entwurf dokumentiert. Befehle, Pakete und Endpunkte vor der Nutzung mit uns abstimmen.

Quelle: https://trunkbeam.com/docs

TrunkBeam gibt dir deutsche Rufnummern für Voice Agents. Du bestellst und verwaltest sie im Terminal, über einen MCP-Server oder per REST-API. Diese Seite führt einmal durch den ganzen Ablauf.

## Voraussetzungen

- Eine Firma oder ein Gewerbe mit Adresse in Deutschland. Für Ortsnetznummern brauchst du eine Adresse im jeweiligen Ortsnetz, für Berlin (030) also eine Berliner Adresse.
- Node.js 20 oder neuer für CLI und MCP-Server.
- Ein Voice-Stack, der SIP spricht, zum Beispiel Vapi, Retell AI, ElevenLabs, LiveKit, Pipecat oder Asterisk.

## 1. CLI installieren

```bash
npm install -g @trunkbeam/cli
trunkbeam --version
```

## 2. Konto anlegen

```bash
trunkbeam signup
```

Die CLI fragt Firmenname, Rechtsform, Adresse und Ansprechpartner ab und schickt dir einen Bestätigungslink per E-Mail. Wer lieber klickt, legt das Konto unter `app.trunkbeam.com` an. Mehr dazu unter [Konto und Prüfung](/docs/account).

## 3. Unterlagen einreichen

```bash
trunkbeam verify --docs ./handelsregister.pdf
trunkbeam status
```

Den Zeitrahmen für die Prüfung klären wir beim Onboarding. Danach steht der Status auf `approved` oder auf `rejected` mit Grund und dem, was fehlt. Du bekommst zusätzlich eine E-Mail.

## 4. Nummer kaufen und verbinden

```bash
trunkbeam numbers search --area 030
trunkbeam numbers buy +493023125417 --sip sip:agent@voice.example
```

Vor dem Kauf zeigt die CLI den Preis und fragt nach. Ab dann gehen Anrufe auf die Nummer an deinen Agenten.

## Wie geht es weiter

- [Nummern mit deinem Voice-Stack verbinden](/docs/sip), auch für ausgehende Anrufe
- [Durchstellen per SIP REFER](/docs/transfer), wenn ein Mensch übernehmen soll
- [MCP-Server einrichten](/docs/mcp) für Claude Code, Codex und Cursor
