> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Izmantojiet ThunderPhone kā MCP serveri

> Savienojiet jebkuru Streamable HTTP MCP klientu ar ThunderPhone, lai uzskaitītu balss aģentus, pārskatītu zvanus un transkriptus, kā arī veiktu izejošos zvanus, izmantojot organizācijas API atslēgu.

ThunderPhone nodrošina Model Context Protocol serveri šādā adresē:

```text theme={null}
https://api.thunderphone.com/v1/mcp
```

Norādiet MCP klientam šo straumējamā HTTP galapunktu, lai jūsu organizācijas
aģenti un zvani būtu pieejami kā rīki. Tas ir pretējs virziens nekā
[attāla MCP servera savienošana ar balss aģentu](/lv/guides/mcp-servers):

| Virziens                                  | Rezultāts                                                            |
| ----------------------------------------- | -------------------------------------------------------------------- |
| Attāls MCP serveris → ThunderPhone aģents | Jūsu balss aģents var izsaukt attālā servera rīkus.                  |
| ThunderPhone → jūsu MCP klients           | Jūsu MCP klients var izsaukt ThunderPhone rīkus aģentiem un zvaniem. |

## Autentificēšana

Izveidojiet `sk_live_` atslēgu sadaļā **Organizācija → Atslēgas** un nosūtiet to kā Bearer
marķieri. MCP galapunkts pieņem organizācijas API atslēgas, nevis informācijas paneļa sesijas
sīkdatnes vai publicējamās logrīka atslēgas.

```json Generic client configuration theme={null}
{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}
```

<Warning>
  `sk_live_` atslēga var piekļūt organizācijas datiem un veikt zvanus. Neglabājiet to
  pārlūkprogrammas kodā, repozitorijos, ekrānuzņēmumos un tērzēšanas žurnālos. Izmantojiet
  jūsu MCP klienta atbalstītu noslēpumu glabātuvi un nekavējoties atsauciet atslēgu, ja tā ir atklāta.
</Warning>

## Pieejamie rīki

| Rīks                  | Argumenti                                       | Darbība                                                                                       |
| --------------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------- |
| `list_agents`         | nav                                             | Uzskaita organizācijas aģentus ar ID, nosaukumu, produktu un balsi.                           |
| `get_agent`           | `agent_id`                                      | Iegūst vienu aģentu.                                                                          |
| `place_call`          | `agent_id`, `from_number`, `to_number`          | Veic izejošu zvanu ar tādām pašām validācijas un norēķinu pārbaudēm kā REST zvanu galapunkts. |
| `get_call`            | `call_id`                                       | Iegūst zvana statusu, kopsavilkumu un vērtējumu.                                              |
| `list_calls`          | neobligāts `limit` (1–100), neobligāts `status` | Uzskaita nesenos zvanus.                                                                      |
| `get_call_transcript` | `call_id`                                       | Iegūst pilnu zvana transkriptu.                                                               |

Visi rīki ir ierobežoti ar organizāciju, kas saistīta ar API atslēgu. ID no
citas organizācijas tiek uzskatīts par nepieejamu.

## Protokola metodes

Galapunkts īsteno MCP JSON-RPC metodes, kas nepieciešamas straumējamā HTTP
klientiem:

* `initialize`
* `notifications/initialized`
* `tools/list`
* `tools/call`

Varat tieši pārbaudīt rīku katalogu:

```bash theme={null}
curl -X POST https://api.thunderphone.com/v1/mcp \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'
```

Izsauciet rīku ar tā nosaukumu un argumentiem:

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_calls",
    "arguments": { "limit": 20, "status": "completed" }
  }
}
```

Rīku rezultāti ir MCP teksta satura vienumi. Rīku kļūdas tiek atgrieztas
rezultātā ar `isError: true`; nezināmas JSON-RPC metodes atgriež protokola kļūdu.

## Droša zvanu veikšana

`place_call` ievēro tos pašus noteikumus kā
[`POST /v1/call`](/api-reference/outbound-calls): aģentam un numuram ir
jāpieder atslēgas organizācijai, numuram jābūt piemērotam izejošajiem
zvaniem, organizācijai jābūt pietiekamam atlikumam, un jebkuram piemērojamam
izejošo zvanu apstiprinājumam jābūt pabeigtam.

Uzskatiet klientu ar piekļuvi `place_call` par produkcijas zvanu veicēju. Ierobežojiet,
kas var izmantot klientu, skaidri norādiet tā uzvednē paredzēto aģentu un numuru,
un pārskatiet zvanus sadaļā Zvanu vēsture.

## Pilnīga savienojuma atsauce

Skatiet [MCP serveru API](/api-reference/mcp-servers#thunderphone-as-an-mcp-server),
lai iegūtu atbilžu piemērus, JSON-RPC kļūdas un attālo serveru pārvaldības API.