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

# A ThunderPhone használata MCP-szerverként

> Csatlakoztasson bármely Streamable HTTP MCP-klienst a ThunderPhone-hoz ügynökök listázásához, hívások és átiratok vizsgálatához, valamint kimenő hívások indításához szervezeti API-kulccsal.

ThunderPhone egy Model Context Protocol-szervert tesz elérhetővé itt:

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

Irányítson egy MCP-klienst erre a Streamable HTTP-végpontra, hogy szervezete
ügynökei és hívásai eszközként elérhetővé váljanak. Ez ellentétes irányú, mint
[egy távoli MCP-szerver hangalapú AI-ügynökhöz való csatlakoztatása](/hu/guides/mcp-servers):

| Irány                                    | Eredmény                                                                            |
| ---------------------------------------- | ----------------------------------------------------------------------------------- |
| Távoli MCP-szerver → ThunderPhone-ügynök | Hangalapú AI-ügynöke meghívhatja a távoli szerver eszközeit.                        |
| ThunderPhone → az Ön MCP-kliense         | MCP-kliense meghívhatja a ThunderPhone ügynökökhöz és hívásokhoz tartozó eszközeit. |

## Hitelesítés

Hozzon létre egy `sk_live_` kulcsot a **Szervezet → Kulcsok** alatt, és küldje el Bearer
tokenként. Az MCP-végpont szervezeti API-kulcsokat fogad el, nem irányítópult-munkamenet-
cookie-kat vagy publikálható widgetkulcsokat.

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

<Warning>
  Egy `sk_live_` kulcs hozzáférhet a szervezeti adatokhoz és hívásokat kezdeményezhet. Ne
  helyezze böngészőkódba, tárolókba, képernyőképekre vagy csevegési naplókba. Használjon az
  MCP-kliense által támogatott titoktárolót, és azonnal vonjon vissza minden kiszivárgott kulcsot.
</Warning>

## Elérhető eszközök

| Eszköz                | Argumentumok                                    | Funkció                                                                                                        |
| --------------------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `list_agents`         | nincs                                           | Felsorolja a szervezet ügynökeit azonosítóval, névvel, termékkel és hanggal.                                   |
| `get_agent`           | `agent_id`                                      | Lekér egy ügynököt.                                                                                            |
| `place_call`          | `agent_id`, `from_number`, `to_number`          | Kimenő hívást kezdeményez ugyanazokkal az ellenőrzési és számlázási korlátozásokkal, mint a REST-hívásvégpont. |
| `get_call`            | `call_id`                                       | Lekéri a hívás állapotát, összegzését és értékelését.                                                          |
| `list_calls`          | opcionális `limit` (1–100), opcionális `status` | Felsorolja a legutóbbi hívásokat.                                                                              |
| `get_call_transcript` | `call_id`                                       | Lekéri egy hívás teljes átiratát.                                                                              |

Minden eszköz az API-kulcshoz kötött szervezetre van korlátozva. Egy másik
szervezetből származó azonosító nem elérhetőként viselkedik.

## Protokollmetódusok

A végpont megvalósítja a Streamable HTTP-kliensekhez szükséges MCP JSON-RPC-
metódusokat:

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

Az eszközkatalógust közvetlenül is megtekintheti:

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

Hívjon meg egy eszközt a nevével és argumentumaival:

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

Az eszközeredmények MCP-szövegtartalom-elemek. Az eszközhibák a
`isError: true` értékkel jelennek meg az eredményben; az ismeretlen JSON-RPC-
metódusok protokollhibát adnak vissza.

## Hívások biztonságos kezdeményezése

A `place_call` ugyanazokat a szabályokat követi, mint a
[`POST /v1/call`](/api-reference/outbound-calls): az ügynöknek és a telefonszámnak
a kulcshoz tartozó szervezethez kell tartoznia, a telefonszámnak alkalmasnak kell
lennie kimenő hívásokra, a szervezetnek elegendő egyenleggel kell rendelkeznie,
és minden alkalmazandó kimenőhívás-megerősítésnek teljesnek kell lennie.

A `place_call` hozzáféréssel rendelkező klienst éles híváskezdeményezőként kezelje.
Korlátozza, ki használhatja a klienst, egyértelműsítse a saját promptjában a
szándékolt ügynököt és telefonszámot, és ellenőrizze a hívásokat a Híváselőzményekben.

## Teljes vezetékes referencia

Válaszpéldákért, JSON-RPC-hibákért és a távoli szerverek kezelési API-jáért lásd:
[MCP Servers API](/api-reference/mcp-servers#thunderphone-as-an-mcp-server).