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

# Använd ThunderPhone som en MCP-server

> Anslut valfri Streamable HTTP MCP-klient till ThunderPhone för att lista agenter, granska samtal och transkriptioner samt ringa utgående samtal med en organisations-API-nyckel.

ThunderPhone exponerar en Model Context Protocol-server på:

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

Peka en MCP-klient mot den Streamable HTTP-slutpunkten för att göra din organisations
agenter och samtal tillgängliga som verktyg. Detta är motsatt riktning jämfört med
[att ansluta en fjärransluten MCP-server till en röstagent](/sv/guides/mcp-servers):

| Riktning                                      | Resultat                                                               |
| --------------------------------------------- | ---------------------------------------------------------------------- |
| Fjärransluten MCP-server → ThunderPhone-agent | Din röstagent kan anropa den fjärranslutna serverns verktyg.           |
| ThunderPhone → din MCP-klient                 | Din MCP-klient kan anropa ThunderPhone-verktyg för agenter och samtal. |

## Autentisera

Skapa en `sk_live_`-nyckel under **Organisation → Nycklar** och skicka den som en Bearer-token.
MCP-slutpunkten accepterar organisationens API-nycklar, inte
dashboardens sessionskakor eller publicerbara widgetnycklar.

```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_`-nyckel kan komma åt organisationsdata och ringa samtal. Håll den borta från
  webbläsarkod, repositorier, skärmbilder och chattloggar. Använd en hemlighetslagring
  som stöds av din MCP-klient och återkalla en nyckel omedelbart om den exponeras.
</Warning>

## Tillgängliga verktyg

| Verktyg               | Argument                                    | Vad det gör                                                                                                   |
| --------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `list_agents`         | inga                                        | Listar organisationens agenter med id, namn, produkt och röst.                                                |
| `get_agent`           | `agent_id`                                  | Hämtar en agent.                                                                                              |
| `place_call`          | `agent_id`, `from_number`, `to_number`      | Ringer ett utgående samtal med samma validerings- och faktureringskontroller som REST-slutpunkten för samtal. |
| `get_call`            | `call_id`                                   | Hämtar samtalsstatus, sammanfattning och betyg.                                                               |
| `list_calls`          | valfritt `limit` (1–100), valfritt `status` | Listar senaste samtalen.                                                                                      |
| `get_call_transcript` | `call_id`                                   | Hämtar det fullständiga transkriptet för ett samtal.                                                          |

Alla verktyg är begränsade till organisationen som är kopplad till API-nyckeln. Ett id från
en annan organisation behandlas som otillgängligt.

## Protokollmetoder

Slutpunkten implementerar MCP JSON-RPC-metoderna som behövs för Streamable HTTP-
klienter:

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

Du kan granska verktygskatalogen direkt:

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

Anropa ett verktyg med dess namn och argument:

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

Verktygsresultat är MCP-innehållsobjekt av typen text. Verktygsfel returneras i
resultatet med `isError: true`; okända JSON-RPC-metoder returnerar ett protokollfel.

## Ring samtal säkert

`place_call` följer samma regler som
[`POST /v1/call`](/api-reference/outbound-calls): agenten och numret måste
tillhöra nyckelns organisation, numret måste vara kvalificerat för utgående
samtal, organisationen måste ha tillräckligt saldo och eventuell tillämplig
bekräftelse för utgående samtal måste vara slutförd.

Behandla en klient med åtkomst till `place_call` som en produktionsklient för samtal. Begränsa vem
som kan använda klienten, ange tydligt avsedd agent och nummer i klientens egen prompt
och granska samtal i Samtalshistorik.

## Fullständig wire-referens

Se [MCP Servers API](/api-reference/mcp-servers#thunderphone-as-an-mcp-server)
för svarsexempel, JSON-RPC-fel och API:t för hantering av fjärrservrar.