---
title: "ThunderPhone CLI"
description: "Prijavite se, upravljajte glasovne agente in klice, konfigurirajte odjemalce MCP ter ustvarite ogrodja projektov iz terminala."
---

CLI zahteva Node.js 18.18 ali novejšo različico. Zaženite ga z `npx` ali ga namestite globalno:

```bash
npm install -g thunderphone
thunderphone --help
```

## Prijava

```bash
npx thunderphone login
thunderphone whoami --json
```

Prijava izpiše kodo za preverjanje, odpre brskalnik in čaka na avtorizacijo.
Na računalniku brez grafičnega vmesnika uporabite `--no-browser` in izpisani URL odprite drugje.
Prijava z napravo zahteva uvedbo poteka OAuth za naprave v API-ju. Ključ API organizacije
v `THUNDERPHONE_API_KEY` lahko prav tako preveri pristnost ukazov in ima prednost
pred shranjenimi poverilnicami za prijavo.

Poverilnice so shranjene po profilih v `~/.config/thunderphone/credentials.json`
z načinom datoteke `0600`. `XDG_CONFIG_HOME` in `THUNDERPHONE_CONFIG_DIR` preglasita
imenik. Žetoni za dostop se samodejno osvežijo, rotirajoči žetoni za osvežitev pa se
shranijo atomsko. Prijava nikoli ne izpiše žetonov.

```bash
thunderphone login --profile work
thunderphone agents list --profile work --json
thunderphone logout --profile work
```

`THUNDERPHONE_PROFILE` nastavi privzeti profil. Odjava odstrani lokalne poverilnice;
ne prekliče odobritve na strežniku. Privzeti API je `https://api.thunderphone.com`.
Za drug API uporabite `--api-base-url` ali `THUNDERPHONE_API_BASE_URL`. Žetona profila
ni mogoče poslati na drug konfiguriran URL API-ja; v ta URL se prijavite z ločenim profilom.

## Ukazi

Vsak ukaz sprejme `--json`. Uspešni podatki se izpišejo v stdout; napake se izpišejo v stderr
z izhodno kodo, ki ni nič. Brez `--json` je izhod strnjena tabela ali seznam polj.
JSON ohrani strukturo odgovora API-ja, polja s poverilnicami pa so prikrita. Streženje MCP
rezervira stdout za protokol MCP.

| Ukaz | Namen |
| --- | --- |
| `login [--no-browser] [--scope "scopes"]` | Avtorizacija s kodo naprave |
| `logout`, `whoami` | Odstranitev lokalnih poverilnic; seznam dostopnih organizacij |
| `agents list`, `agents get ID` | Pridobivanje agentov |
| `agents create --file agent.json` | Ustvarjanje agenta |
| `agents update ID --file agent.json` | Shranjevanje osnutka agenta |
| `agents deploy ID`, `agents delete ID` | Objavljanje osnutka; brisanje agenta |
| `numbers list` | Pridobivanje telefonskih številk |
| `numbers provision --country US --area-code 415` | Pridobivanje dohodne številke v ZDA |
| `numbers assign NUMBER_ID --agent ID` | Dodeljevanje glasovnega agenta za dohodne klice |
| `call TO --agent ID --from FROM [--wait]` | Opravljanje odhodnega klica; po želji čakanje na njegov prepis |
| `calls list [--limit N] [--agent ID]` | Seznam klicev (omejitev 1–200) |
| `calls get ID`, `calls transcript ID` | Pridobivanje posameznega klica ali njegovega prepisa |
| `test run AGENT_ID [--scenario ID] --consent-to-charge` | Zagon plačljivih shranjenih scenarijev prek spletnega kanala |
| `test status RUN_ID [--agent ID]` | Pregled paketa s podrobnostmi scenarija, ko je podan agent |
| `import VENDOR export.json` | Priprava uvoza JSON ponudnika za pregled |
| `imports get UUID`, `imports commit UUID` | Pregled uvoza; uveljavitev izbranih agentov po pregledu |
| `mcp setup`, `mcp serve` | Konfiguriranje odjemalca; zagon mostu stdio |
| `init [directory]` | Ustvarjanje ogrodja projekta |

Odhodni klici zahtevajo povezano številko operaterja. `THUNDERPHONE_FROM_NUMBER` lahko
zagotovi `--from`. Številke, ki jih zagotovi ThunderPhone, so samo za dohodne klice. `--wait`
privzeto uporablja enourno časovno omejitev; za spremembo nastavite `--timeout SECONDS`.
Časovna omejitev prekine čakanje, ne da bi končala klic.

Uvozi podpirajo `vapi`, `retell`, `elevenlabs` in `bland`. Drugi argument je pot do
izvoza JSON ponudnika, ne oddaljeni ID ponudnika. API asinhrono pripravi preslikavo;
preglejte jo z `imports get UUID` in jo uveljavite šele, ko je pripravljena
ter ste pregledali preslikana polja in opozorila. Oglejte si [uvoze agentov](/sl/guides/import-agents).

## Nastavitev MCP

```bash
thunderphone mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
thunderphone mcp setup --client codex --scope user --api-key-env THUNDERPHONE_API_KEY
thunderphone mcp setup --client claude-desktop --scope user
```

Odjemalci: `claude-code`, `codex`, `cursor`, `vscode`, `gemini`, `claude-desktop` in
`windsurf`. Obseg projekta je privzet. Desktop in Windsurf zahtevata uporabniški obseg.
Izpustite `--client`, da zaznate enega odjemalca iz projekta; dvoumno zaznavanje
interaktivno zahteva vnos ali pa v neinteraktivni seji ne uspe z navodili.
Nastavitev izpiše datoteko, ki jo je zapisala, in ohrani nepovezane strežnike. Obstoječi JSON
mora biti veljaven strogi JSON; vrednosti TOML za Codex se ohranijo, vendar se lahko komentarji preoblikujejo.

Nastavitev daje prednost neposrednemu oddaljenemu HTTP. Z možnostjo `--api-key-env` zapiše
sklic na spremenljivko, nikoli ključa. Brez te možnosti se neposredni HTTP zanaša na podporo
odjemalca za OAuth; ne uporablja datoteke s poverilnicami CLI. Za ponovno uporabo poverilnic
`thunderphone login` v katerem koli odjemalcu, ki podpira stdio, uporabite:

```json
{
  "mcpServers": {
    "thunderphone": {
      "command": "npx",
      "args": ["-y", "@thunderphone/mcp"]
    }
  }
}
```

Ovijalnik preveri `THUNDERPHONE_API_KEY`, nato trenutni profil CLI (po potrebi ga osveži),
nato pa OAuth prepusti paketu `mcp-remote`. `THUNDERPHONE_MCP_URL` preglasi
končno točko. Ne pošilja telemetrije. Samostojna nastavitev je na voljo tudi prek
`npx -y @thunderphone/mcp setup --client cursor` ali `thunderphone-mcp setup` po
globalni namestitvi `@thunderphone/mcp`.

## Ustvarite projekt

```bash
npx create-thunderphone-agent my-receptionist
npx create-thunderphone-agent my-outbound --template python --agent-type outbound
# Equivalent:
thunderphone init my-receptionist --template node --agent-type receptionist
```

Predlogi so `node` in `python`; vrste agentov so `receptionist`, `outbound` in
`custom`. Privzeti agent je angleško-španski zobozdravstveni recepcijski agent z izrecnimi
dejstvi za predstavitev. Projekti vključujejo `agent.json`, skripte za uvedbo, konfiguracije MCP za
Claude Code, Cursor in VS Code, navodila za agenta, `.env.example` in datoteko README.
Generiranje ogrodja deluje brez povezave in ne dovoli prepisovanja nepraznega imenika.

Pred uvedbo uredite poslovna dejstva. Izvozite ključ API, povezano številko klicatelja
in prejemnika testnega klica, kot je opisano v ustvarjeni datoteki README. `npm run deploy`
ali `python deploy.py` ustvari ali posodobi agenta, uvede njegov osnutek in opravi
obračunljiv testni klic. Skripte uporabljajo preverjanje pristnosti s ključem API; CLI in ovijalnik
MCP stdio podpirata tudi prijavo z napravo. Skripte Python zahtevajo Python 3.9 ali novejši.