Über den MCP-Server bestellt dein KI-Assistent Nummern, verbindet sie mit deinem Agenten und stellt Weiterleitung und Wartemusik ein. Du sagst in einem Satz, was du brauchst, der Assistent ruft die passenden Werkzeuge auf.
Der Server läuft lokal über npx @trunkbeam/mcp, Voraussetzung ist Node.js 22 oder neuer. Den API-Schlüssel legst du im Dashboard unter API, CLI & MCP an und gibst ihn als Umgebungsvariable TRUNKBEAM_API_KEY mit.
Werkzeuge
| Werkzeug | Was es macht | Recht |
|---|---|---|
trunkbeam_account | Konto, Prüfstatus, Tarif und Rechte des Schlüssels | Lesen |
trunkbeam_prices | Tarife und Preise | Lesen |
trunkbeam_list_sites | Standorte; nur geprüfte bekommen Ortsnetznummern | Lesen |
trunkbeam_search_area_code | Ortsnetz zu Ort oder Vorwahl suchen | Lesen |
trunkbeam_list_numbers | Deine Nummern mit Ziel | Lesen |
trunkbeam_order_number | Ortsnetz- oder 032-Nummer bestellen, mit Rückfrage | Bestellen |
trunkbeam_list_number_requests | Bestellungen und ihr Stand | Lesen |
trunkbeam_release_number | Nummer kündigen, mit Rückfrage | Bestellen |
trunkbeam_connect_number_elevenlabs | Nummer in einem Schritt mit ElevenLabs verbinden | Verwalten |
trunkbeam_set_number_target | Nummer an eine beliebige SIP-Adresse leiten | Verwalten |
trunkbeam_set_number_agent_fallback | Ersatznummer, wenn der Agent nicht erreichbar ist | Verwalten |
trunkbeam_list_connections | Agent-Anbindungen (SIP-Ziele) | Lesen |
trunkbeam_create_connection | Agent-Anbindung anlegen | Verwalten |
trunkbeam_delete_connection | Agent-Anbindung löschen | Verwalten |
trunkbeam_provider_guide | Einrichtungsanleitung je Anbieter mit deinen echten Werten | Lesen |
trunkbeam_get_transfer_policy | Weiterleitung an Menschen anzeigen | Lesen |
trunkbeam_set_transfer_policy | Weiterleitung ändern, als Standard oder je Nummer | Verwalten |
trunkbeam_reset_number_transfer_policy | Eigene Weiterleitung einer Nummer löschen | Verwalten |
trunkbeam_list_hold_music | Wartemusik mit Beschreibung, damit der Assistent ein passendes Stück wählt | Lesen |
trunkbeam_list_calls | Letzte Anrufe | Lesen |
trunkbeam_usage | Nutzung und Kosten eines Monats | Lesen |
Bestellen und Kündigen laufen immer in zwei Schritten: Zuerst holt der Assistent ein Angebot mit Preis und zeigt es dir. Erst nach deiner Zustimmung bestätigt er. Eine Bestätigung ohne vorheriges Angebot lehnt der Server ab.
Claude Code
claude mcp add trunkbeam \
-e TRUNKBEAM_API_KEY=tb_live_… \
-- npx -y @trunkbeam/mcp
Mit --scope user steht der Server in allen Projekten zur Verfügung. Mit --scope project landet er in der .mcp.json des Repos und damit bei deinem ganzen Team, dann gehört der Schlüssel aber nicht in die Datei. Prüfen mit:
claude mcp list
Codex
codex mcp add trunkbeam \
--env TRUNKBEAM_API_KEY=tb_live_… \
-- npx -y @trunkbeam/mcp
Oder direkt in ~/.codex/config.toml:
[mcp_servers.trunkbeam]
command = "npx"
args = ["-y", "@trunkbeam/mcp"]
[mcp_servers.trunkbeam.env]
TRUNKBEAM_API_KEY = "tb_live_…"
Prüfen mit codex mcp list.
Cursor, Claude Desktop und andere
In .cursor/mcp.json im Projekt, ~/.cursor/mcp.json für alle Projekte oder bei Claude Desktop in claude_desktop_config.json:
{
"mcpServers": {
"trunkbeam": {
"command": "npx",
"args": ["-y", "@trunkbeam/mcp"],
"env": { "TRUNKBEAM_API_KEY": "tb_live_…" }
}
}
}
Windsurf und die meisten anderen Clients lesen denselben mcpServers-Block.
Schlüssel für Assistenten
Gib deinem Assistenten einen eigenen Schlüssel mit begrenzter Gültigkeit. Für reines Nachschauen genügt das Recht „Lesen“. „Verwalten“ braucht er, wenn er Ziele oder die Weiterleitung ändern soll, „Bestellen“ nur, wenn er wirklich Nummern kaufen darf. Einen Schlüssel kannst du im Dashboard jederzeit widerrufen.
Beispiel
Besorg uns eine Nummer für unseren Standort Schramberg und verbinde sie mit unserem ElevenLabs-Agenten.
Der Assistent listet die Standorte, holt das Angebot für eine Ortsnetznummer im Ortsnetz 07422 und fragt dich nach dem Preis. Nach deinem OK bestellt er, verbindet die Nummer mit ElevenLabs und zeigt dir, was du bei ElevenLabs eintragen musst.