> ## 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.

# Použijte ThunderPhone jako server MCP

> Připojte libovolného klienta Streamable HTTP MCP k ThunderPhone a pomocí organizačního klíče API vypisujte agenty, kontrolujte hovory a přepisy a uskutečňujte odchozí hovory.

ThunderPhone zpřístupňuje server Model Context Protocol na adrese:

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

Nasměrujte klienta MCP na tento koncový bod Streamable HTTP, aby byli agenti a hovory vaší organizace dostupné jako nástroje. Jde o opačný směr než při
[připojení vzdáleného serveru MCP k hlasovému agentovi](/cs/guides/mcp-servers):

| Směr                                     | Výsledek                                                             |
| ---------------------------------------- | -------------------------------------------------------------------- |
| Vzdálený server MCP → agent ThunderPhone | Váš hlasový agent může volat nástroje vzdáleného serveru.            |
| ThunderPhone → váš klient MCP            | Váš klient MCP může volat nástroje ThunderPhone pro agenty a hovory. |

## Ověření

Vytvořte klíč `sk_live_` v nabídce **Organizace → Klíče** a odešlete jej jako token Bearer. Koncový bod MCP přijímá klíče API organizace, nikoli soubory cookie relace dashboardu ani publikovatelné klíče widgetů.

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

<Warning>
  Klíč `sk_live_` může přistupovat k datům organizace a uskutečňovat hovory. Neuchovávejte jej
  v kódu prohlížeče, repozitářích, snímcích obrazovky ani protokolech chatu. Použijte úložiště tajných údajů
  podporované vaším klientem MCP a při zveřejnění klíč okamžitě zrušte.
</Warning>

## Dostupné nástroje

| Nástroj               | Argumenty                                     | Co dělá                                                                                              |
| --------------------- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| `list_agents`         | žádné                                         | Vypíše agenty organizace včetně id, názvu, produktu a hlasu.                                         |
| `get_agent`           | `agent_id`                                    | Načte jednoho agenta.                                                                                |
| `place_call`          | `agent_id`, `from_number`, `to_number`        | Uskuteční odchozí hovor se stejnými kontrolami ověření a fakturace jako koncový bod REST pro hovory. |
| `get_call`            | `call_id`                                     | Načte stav hovoru, shrnutí a hodnocení.                                                              |
| `list_calls`          | volitelný `limit` (1–100), volitelný `status` | Vypíše nedávné hovory.                                                                               |
| `get_call_transcript` | `call_id`                                     | Načte kompletní přepis hovoru.                                                                       |

Všechny nástroje jsou omezeny na organizaci přiřazenou ke klíči API. Id z jiné organizace se chová jako nedostupné.

## Metody protokolu

Koncový bod implementuje metody MCP JSON-RPC potřebné pro klienty Streamable HTTP:

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

Katalog nástrojů můžete zkontrolovat přímo:

```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": {}
  }'
```

Zavolejte nástroj pomocí jeho názvu a argumentů:

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

Výsledky nástrojů jsou položky textového obsahu MCP. Selhání nástrojů se vracejí ve výsledku s `isError: true`; neznámé metody JSON-RPC vracejí chybu protokolu.

## Bezpečné uskutečňování hovorů

`place_call` se řídí stejnými pravidly jako
[`POST /v1/call`](/api-reference/outbound-calls): agent a číslo musí
patřit organizaci klíče, číslo musí být způsobilé pro odchozí
volání, organizace musí mít dostatečný zůstatek a veškeré platné
potvrzení odchozího volání musí být dokončeno.

S klientem s přístupem k `place_call` zacházejte jako s produkčním volajícím. Omezte, kdo
může klienta používat, v jeho vlastním promptu jasně uveďte zamýšleného agenta a číslo,
a hovory kontrolujte v Historii hovorů.

## Kompletní referenční popis komunikace

Příklady odpovědí, chyby JSON-RPC a rozhraní API pro správu vzdálených serverů naleznete v dokumentaci [MCP Servers API](/api-reference/mcp-servers#thunderphone-as-an-mcp-server).