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

# Brug ThunderPhone som en MCP-server

> Forbind en vilkårlig Streamable HTTP MCP-klient til ThunderPhone for at liste agenter, inspicere opkald og transskriptioner samt foretage udgående opkald med en organisations-API-nøgle.

ThunderPhone eksponerer en Model Context Protocol-server på:

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

Peg en MCP-klient mod det Streamable HTTP-endepunkt for at gøre din organisations
agenter og opkald tilgængelige som værktøjer. Dette er den modsatte retning af
[at forbinde en ekstern MCP-server til en stemmeagent](/da/guides/mcp-servers):

| Retning                                 | Resultat                                                               |
| --------------------------------------- | ---------------------------------------------------------------------- |
| Ekstern MCP-server → ThunderPhone-agent | Din stemmeagent kan kalde den eksterne servers værktøjer.              |
| ThunderPhone → din MCP-klient           | Din MCP-klient kan kalde ThunderPhone-værktøjer for agenter og opkald. |

## Godkendelse

Opret en `sk_live_`-nøgle under **Organisation → Nøgler**, og send den som et Bearer-token. MCP-endepunktet accepterer organisationens API-nøgler, ikke dashboardets sessionscookies eller publicerbare widgetnøgler.

```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øgle kan få adgang til organisationsdata og foretage opkald. Hold den ude af
  browserkode, repositories, skærmbilleder og chatlogs. Brug et hemmelighedslager,
  der understøttes af din MCP-klient, og tilbagekald straks en nøgle, hvis den eksponeres.
</Warning>

## Tilgængelige værktøjer

| Værktøj               | Argumenter                                | Hvad det gør                                                                                               |
| --------------------- | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `list_agents`         | ingen                                     | Viser organisationens agenter med id, navn, produkt og stemme.                                             |
| `get_agent`           | `agent_id`                                | Henter én agent.                                                                                           |
| `place_call`          | `agent_id`, `from_number`, `to_number`    | Foretager et udgående opkald med samme validerings- og faktureringskontroller som REST-opkaldsendepunktet. |
| `get_call`            | `call_id`                                 | Henter opkaldsstatus, oversigt og vurdering.                                                               |
| `list_calls`          | valgfri `limit` (1–100), valgfri `status` | Viser seneste opkald.                                                                                      |
| `get_call_transcript` | `call_id`                                 | Henter det komplette transkript for et opkald.                                                             |

Alle værktøjer er afgrænset til den organisation, der er knyttet til API-nøglen. Et id fra
en anden organisation opfører sig som utilgængeligt.

## Protokolmetoder

Endepunktet implementerer de MCP JSON-RPC-metoder, der kræves for Streamable HTTP-klienter:

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

Du kan inspicere værktøjskataloget 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": {}
  }'
```

Kald et værktøj med dets navn og argumenter:

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

Værktøjsresultater er MCP-tekstindholdselementer. Værktøjsfejl returneres i
resultatet med `isError: true`; ukendte JSON-RPC-metoder returnerer en protokolfejl.

## Foretag opkald sikkert

`place_call` følger de samme regler som
[`POST /v1/call`](/api-reference/outbound-calls): agenten og nummeret skal
tilhøre nøglens organisation, nummeret skal være berettiget til udgående
opkald, organisationen skal have tilstrækkelig saldo, og enhver relevant
bekræftelse af udgående opkald skal være gennemført.

Behandl en klient med adgang til `place_call` som en produktionsklient til opkald. Begræns, hvem
der kan bruge klienten, gør den tilsigtede agent og det tilsigtede nummer tydelige i dens egen prompt,
og gennemgå opkald i Opkaldshistorik.

## Komplet wire-reference

Se [MCP Servers API](/api-reference/mcp-servers#thunderphone-as-an-mcp-server)
for svareksempler, JSON-RPC-fejl og API'et til administration af eksterne servere.