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

# Bruk ThunderPhone som en MCP-server

> Koble en hvilken som helst Streamable HTTP MCP-klient til ThunderPhone for å liste opp agenter, undersøke samtaler og transkripsjoner og foreta utgående samtaler med en organisasjons-API-nøkkel.

ThunderPhone eksponerer en Model Context Protocol-server på:

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

Pek en MCP-klient mot dette Streamable HTTP-endepunktet for å gjøre organisasjonens
stemmeagenter og anrop tilgjengelige som verktøy. Dette går i motsatt retning av
[å koble en ekstern MCP-server til en stemmeagent](/nb/guides/mcp-servers):

| Retning                                 | Resultat                                                                    |
| --------------------------------------- | --------------------------------------------------------------------------- |
| Ekstern MCP-server → ThunderPhone-agent | Stemmeagenten din kan kalle verktøyene på den eksterne serveren.            |
| ThunderPhone → MCP-klienten din         | MCP-klienten din kan kalle ThunderPhone-verktøy for stemmeagenter og anrop. |

## Autentiser

Opprett en `sk_live_`-nøkkel under **Organisasjon → Nøkler**, og send den som et Bearer-token. MCP-endepunktet godtar organisasjons-API-nøkler, ikke
øktinformasjonskapsler for dashboardet eller publiserbare widget-nøkler.

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

<Warning>
  En `sk_live_`-nøkkel kan få tilgang til organisasjonsdata og foreta anrop. Hold den utenfor
  nettleserkode, repositorier, skjermbilder og chatlogger. Bruk et hemmelighetslager
  som støttes av MCP-klienten din, og tilbakekall en nøkkel umiddelbart hvis den eksponeres.
</Warning>

## Tilgjengelige verktøy

| Verktøy               | Argumenter                                | Hva det gjør                                                                                           |
| --------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `list_agents`         | ingen                                     | Viser organisasjonens stemmeagenter med id, navn, produkt og stemme.                                   |
| `get_agent`           | `agent_id`                                | Henter én stemmeagent.                                                                                 |
| `place_call`          | `agent_id`, `from_number`, `to_number`    | Foretar et utgående anrop med samme validerings- og faktureringskontroller som REST-anropsendepunktet. |
| `get_call`            | `call_id`                                 | Henter anropsstatus, sammendrag og vurdering.                                                          |
| `list_calls`          | valgfri `limit` (1–100), valgfri `status` | Viser nylige anrop.                                                                                    |
| `get_call_transcript` | `call_id`                                 | Henter hele transkripsjonen for et anrop.                                                              |

Alle verktøy er avgrenset til organisasjonen som er knyttet til API-nøkkelen. En id fra
en annen organisasjon behandles som utilgjengelig.

## Protokollmetoder

Endepunktet implementerer MCP JSON-RPC-metodene som kreves for Streamable HTTP-
klienter:

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

Du kan undersøke verktøykatalogen direkte:

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

Kall et verktøy med navnet og argumentene:

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

Verktøyresultater er MCP-tekstinnholdselementer. Verktøyfeil returneres i
resultatet med `isError: true`; ukjente JSON-RPC-metoder returnerer en protokollfeil.

## Foreta anrop på en trygg måte

`place_call` følger de samme reglene som
[`POST /v1/call`](/api-reference/outbound-calls): stemmeagenten og nummeret må
tilhøre organisasjonen til nøkkelen, nummeret må være kvalifisert for utgående
anrop, organisasjonen må ha tilstrekkelig saldo, og eventuell påkrevd
bekreftelse for utgående anrop må være fullført.

Behandle en klient med tilgang til `place_call` som en produksjonsoppringer. Begrens hvem
som kan bruke klienten, gjør den tiltenkte stemmeagenten og nummeret tydelig i klientens egen ledetekst,
og gjennomgå anrop i Anropshistorikk.

## Fullstendig wire-referanse

Se [MCP Servers API](/api-reference/mcp-servers#thunderphone-as-an-mcp-server)
for responseksempler, JSON-RPC-feil og API-et for administrasjon av eksterne servere.