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

# Utilizați ThunderPhone ca server MCP

> Conectați orice client MCP Streamable HTTP la ThunderPhone pentru a lista agenții, a inspecta apelurile și transcrierile și a iniția apeluri outbound cu o cheie API a organizației.

ThunderPhone expune un server Model Context Protocol la:

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

Direcționați un client MCP către acel endpoint HTTP transmisibil pentru a pune la dispoziție ca instrumente agenții și apelurile organizației dumneavoastră. Aceasta este direcția opusă față de
[conectarea unui server MCP la distanță la un agent vocal](/ro/guides/mcp-servers):

| Direcție                                    | Rezultat                                                                                    |
| ------------------------------------------- | ------------------------------------------------------------------------------------------- |
| Server MCP la distanță → agent ThunderPhone | Agentul dumneavoastră vocal poate apela instrumentele serverului la distanță.               |
| ThunderPhone → clientul dumneavoastră MCP   | Clientul dumneavoastră MCP poate apela instrumentele ThunderPhone pentru agenți și apeluri. |

## Autentificare

Creați o cheie `sk_live_` în **Organizație → Chei** și trimiteți-o ca token Bearer. Endpointul MCP acceptă chei API ale organizației, nu cookie-uri de sesiune din tabloul de bord sau chei publicabile pentru widgeturi.

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

<Warning>
  O cheie `sk_live_` poate accesa datele organizației și poate iniția apeluri. Nu o includeți în codul de browser, depozitoare, capturi de ecran și jurnale de chat. Utilizați un depozit de secrete compatibil cu clientul dumneavoastră MCP și revocați imediat o cheie dacă este expusă.
</Warning>

## Instrumente disponibile

| Instrument            | Argumente                                   | Ce face                                                                                                   |
| --------------------- | ------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `list_agents`         | niciunul                                    | Listează agenții organizației cu id, nume, produs și voce.                                                |
| `get_agent`           | `agent_id`                                  | Obține un agent.                                                                                          |
| `place_call`          | `agent_id`, `from_number`, `to_number`      | Inițiază un apel de ieșire cu aceleași reguli de validare și facturare ca endpointul REST pentru apeluri. |
| `get_call`            | `call_id`                                   | Obține starea, rezumatul și evaluarea apelului.                                                           |
| `list_calls`          | `limit` opțional (1–100), `status` opțional | Listează apelurile recente.                                                                               |
| `get_call_transcript` | `call_id`                                   | Obține transcrierea completă a unui apel.                                                                 |

Toate instrumentele sunt limitate la organizația asociată cheii API. Un id dintr-o altă organizație se comportă ca indisponibil.

## Metode de protocol

Endpointul implementează metodele MCP JSON-RPC necesare pentru clienții HTTP transmisibili:

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

Puteți inspecta direct catalogul de instrumente:

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

Apelați un instrument cu numele și argumentele sale:

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

Rezultatele instrumentelor sunt elemente MCP de conținut text. Eșecurile instrumentelor sunt returnate în rezultat cu `isError: true`; metodele JSON-RPC necunoscute returnează o eroare de protocol.

## Inițierea apelurilor în siguranță

`place_call` urmează aceleași reguli ca
[`POST /v1/call`](/api-reference/outbound-calls): agentul și numărul trebuie să aparțină organizației cheii, numărul trebuie să fie eligibil pentru apeluri de ieșire, organizația trebuie să aibă sold suficient, iar orice confirmare aplicabilă pentru apelurile de ieșire trebuie să fie finalizată.

Tratați un client cu acces la `place_call` ca pe un inițiator de apeluri în producție. Restricționați cine poate utiliza clientul, precizați clar agentul și numărul intenționate în propriul prompt al clientului și verificați apelurile în Istoricul apelurilor.

## Referință completă de comunicație

Consultați [API-ul serverelor MCP](/api-reference/mcp-servers#thunderphone-as-an-mcp-server) pentru exemple de răspunsuri, erori JSON-RPC și API-ul de gestionare a serverelor la distanță.