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

# Gebruik ThunderPhone als een MCP-server

> Verbind elke Streamable HTTP MCP-client met ThunderPhone om agents weer te geven, oproepen en transcripties te bekijken en uitgaande oproepen te plaatsen met een organisatie-API-sleutel.

ThunderPhone biedt een Model Context Protocol-server op:

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

Wijs een MCP-client naar dat Streamable HTTP-eindpunt om de agents en oproepen van je organisatie beschikbaar te maken als tools. Dit is de omgekeerde richting van
[een externe MCP-server koppelen aan een spraakagent](/nl/guides/mcp-servers):

| Richting                                | Resultaat                                                               |
| --------------------------------------- | ----------------------------------------------------------------------- |
| Externe MCP-server → ThunderPhone-agent | Je spraakagent kan de tools van de externe server aanroepen.            |
| ThunderPhone → je MCP-client            | Je MCP-client kan ThunderPhone-tools voor agents en oproepen aanroepen. |

## Authenticeren

Maak een `sk_live_`-sleutel onder **Organisatie → Sleutels** en verstuur deze als Bearer-token. Het MCP-eindpunt accepteert API-sleutels van de organisatie, geen dashboardsessiecookies of publiceerbare widgetsleutels.

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

<Warning>
  Een `sk_live_`-sleutel heeft toegang tot organisatiegegevens en kan oproepen plaatsen. Houd deze buiten
  browsercode, repositories, schermafbeeldingen en chatlogboeken. Gebruik een geheimenopslag
  die door je MCP-client wordt ondersteund en trek een sleutel onmiddellijk in als deze is blootgesteld.
</Warning>

## Beschikbare tools

| Tool                  | Argumenten                                    | Wat deze doet                                                                                              |
| --------------------- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `list_agents`         | geen                                          | Geeft een lijst van organisatieagents met id, naam, product en stem.                                       |
| `get_agent`           | `agent_id`                                    | Haalt één agent op.                                                                                        |
| `place_call`          | `agent_id`, `from_number`, `to_number`        | Plaatst een uitgaande oproep met dezelfde validatie- en factureringscontroles als het REST-oproepeindpunt. |
| `get_call`            | `call_id`                                     | Haalt de oproepstatus, samenvatting en beoordeling op.                                                     |
| `list_calls`          | optionele `limit` (1–100), optionele `status` | Geeft een lijst van recente oproepen.                                                                      |
| `get_call_transcript` | `call_id`                                     | Haalt het volledige transcript van een oproep op.                                                          |

Alle tools zijn beperkt tot de organisatie die aan de API-sleutel is gekoppeld. Een id van
een andere organisatie gedraagt zich als niet beschikbaar.

## Protocolmethoden

Het eindpunt implementeert de MCP JSON-RPC-methoden die nodig zijn voor Streamable HTTP-clients:

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

Je kunt de toolcatalogus rechtstreeks bekijken:

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

Roep een tool aan met de naam en argumenten:

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

Toolresultaten zijn MCP-tekstinhouditems. Toolfouten worden in het
resultaat geretourneerd met `isError: true`; onbekende JSON-RPC-methoden retourneren een protocolfout.

## Oproepen veilig plaatsen

`place_call` volgt dezelfde regels als
[`POST /v1/call`](/api-reference/outbound-calls): de agent en het nummer moeten
toebehoren aan de organisatie van de sleutel, het nummer moet in aanmerking komen voor uitgaand
bellen, de organisatie moet voldoende saldo hebben en alle toepasselijke
bevestigingen voor uitgaand bellen moeten voltooid zijn.

Behandel een client met toegang tot `place_call` als een productiesysteem dat oproepen plaatst. Beperk wie
de client kan gebruiken, maak de beoogde agent en het nummer duidelijk in de eigen prompt,
en controleer oproepen in de Oproepgeschiedenis.

## Volledige wire-referentie

Zie [MCP Servers API](/api-reference/mcp-servers#thunderphone-as-an-mcp-server)
voor antwoordvoorbeelden, JSON-RPC-fouten en de API voor beheer van externe servers.