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

# Käytä ThunderPhonea MCP-palvelimena

> Yhdistä mikä tahansa Streamable HTTP MCP -asiakas ThunderPhoneen listataksesi agentit, tarkastellaksesi puheluita ja transkriptioita sekä soittaaksesi lähteviä puheluita organisaation API-avaimella.

ThunderPhone tarjoaa Model Context Protocol -palvelimen osoitteessa:

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

Määritä MCP-asiakas käyttämään tätä Streamable HTTP -päätepistettä, jotta organisaatiosi
agentit ja puhelut ovat käytettävissä työkaluina. Tämä on vastakkainen suunta kuin
[etä-MCP-palvelimen yhdistäminen puheagenttiin](/fi/guides/mcp-servers):

| Suunta                                  | Tulos                                                                            |
| --------------------------------------- | -------------------------------------------------------------------------------- |
| Etä-MCP-palvelin → ThunderPhone-agentti | Puheagenttisi voi kutsua etäpalvelimen työkaluja.                                |
| ThunderPhone → MCP-asiakkaasi           | MCP-asiakkaasi voi kutsua ThunderPhonen työkaluja agentteja ja puheluita varten. |

## Todennus

Luo `sk_live_`-avain kohdassa **Organisaatio → Avaimet** ja lähetä se Bearer-
tunnuksena. MCP-päätepiste hyväksyy organisaation API-avaimet, ei hallintapaneelin
istuntoevästeitä tai julkaistavia widget-avaimia.

```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_`-avain voi käyttää organisaation tietoja ja soittaa puheluita. Älä
  sisällytä sitä selainkoodiin, tietovarastoihin, kuvakaappauksiin tai
  keskustelulokeihin. Käytä MCP-asiakkaasi tukemaa salaisuussäilöä ja peruuta
  avain välittömästi, jos se paljastuu.
</Warning>

## Käytettävissä olevat työkalut

| Työkalu               | Argumentit                                        | Toiminto                                                                                                |
| --------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `list_agents`         | ei mitään                                         | Listaa organisaation agentit tunnuksineen, nimineen, tuotteineen ja äänineen.                           |
| `get_agent`           | `agent_id`                                        | Hakee yhden agentin.                                                                                    |
| `place_call`          | `agent_id`, `from_number`, `to_number`            | Soittaa lähtevän puhelun käyttäen samoja validointi- ja laskutusrajoituksia kuin REST-puhelupäätepiste. |
| `get_call`            | `call_id`                                         | Hakee puhelun tilan, yhteenvedon ja arvosanan.                                                          |
| `list_calls`          | valinnainen `limit` (1–100), valinnainen `status` | Listaa viimeisimmät puhelut.                                                                            |
| `get_call_transcript` | `call_id`                                         | Hakee puhelun täydellisen transkriptin.                                                                 |

Kaikki työkalut rajataan API-avaimeen sidottuun organisaatioon. Toisen
organisaation tunnus käsitellään kuin se ei olisi käytettävissä.

## Protokollamenetelmät

Päätepiste toteuttaa Streamable HTTP -asiakkaiden tarvitsemat MCP JSON-RPC
-menetelmät:

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

Voit tarkastella työkaluvalikoimaa suoraan:

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

Kutsu työkalua sen nimellä ja argumenteilla:

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

Työkalujen tulokset ovat MCP-tekstisisältökohteita. Työkalujen virheet palautetaan
tuloksessa arvolla `isError: true`; tuntemattomat JSON-RPC-menetelmät palauttavat
protokollavirheen.

## Puheluiden soittaminen turvallisesti

`place_call` noudattaa samoja sääntöjä kuin
[`POST /v1/call`](/api-reference/outbound-calls): agentin ja numeron on
kuuluttava avaimen organisaatioon, numeron on oltava kelpoinen lähteviin
puheluihin, organisaatiolla on oltava riittävästi saldoa ja kaikkien sovellettavien
lähtevien puheluiden vahvistusten on oltava valmiita.

Käsittele asiakasta, jolla on pääsy `place_call`-työkaluun, tuotantokäyttöön
tarkoitettuna soittajana. Rajoita, kuka voi käyttää asiakasta, kerro sen omassa
kehotteessa selvästi tarkoitettu agentti ja numero sekä tarkista puhelut
Puheluhistoriassa.

## Täydellinen wire-viite

Katso [MCP-palvelinten API](/api-reference/mcp-servers#thunderphone-as-an-mcp-server)
vastausesimerkkien, JSON-RPC-virheiden ja etäpalvelinten hallinta-API:n osalta.