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

# Używaj ThunderPhone jako serwera MCP

> Połącz dowolnego klienta Streamable HTTP MCP z ThunderPhone, aby wyświetlać listę agentów, analizować połączenia i transkrypcje oraz wykonywać połączenia wychodzące za pomocą klucza API organizacji.

ThunderPhone udostępnia serwer Model Context Protocol pod adresem:

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

Skieruj klienta MCP na ten punkt końcowy Streamable HTTP, aby udostępnić agentów i połączenia swojej organizacji jako narzędzia. Jest to kierunek przeciwny do [łączenia zdalnego serwera MCP z agentem głosowym](/pl/guides/mcp-servers):

| Kierunek                               | Rezultat                                                                      |
| -------------------------------------- | ----------------------------------------------------------------------------- |
| Zdalny serwer MCP → agent ThunderPhone | Twój agent głosowy może wywoływać narzędzia zdalnego serwera.                 |
| ThunderPhone → Twój klient MCP         | Twój klient MCP może wywoływać narzędzia ThunderPhone dla agentów i połączeń. |

## Uwierzytelnianie

Utwórz klucz `sk_live_` w sekcji **Organizacja → Klucze** i wyślij go jako token Bearer. Punkt końcowy MCP akceptuje klucze API organizacji, a nie pliki cookie sesji panelu ani publikowalne klucze widżetu.

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

<Warning>
  Klucz `sk_live_` może uzyskiwać dostęp do danych organizacji i wykonywać połączenia. Nie umieszczaj go w kodzie przeglądarkowym, repozytoriach, zrzutach ekranu ani dziennikach czatu. Użyj magazynu sekretów obsługiwanego przez klienta MCP i natychmiast unieważnij klucz, jeśli zostanie ujawniony.
</Warning>

## Dostępne narzędzia

| Narzędzie             | Argumenty                                       | Działanie                                                                                                          |
| --------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `list_agents`         | brak                                            | Wyświetla agentów organizacji wraz z identyfikatorem, nazwą, produktem i głosem.                                   |
| `get_agent`           | `agent_id`                                      | Pobiera jednego agenta.                                                                                            |
| `place_call`          | `agent_id`, `from_number`, `to_number`          | Wykonuje połączenie wychodzące z takimi samymi zasadami walidacji i rozliczeń jak punkt końcowy REST dla połączeń. |
| `get_call`            | `call_id`                                       | Pobiera status połączenia, podsumowanie i ocenę.                                                                   |
| `list_calls`          | opcjonalny `limit` (1–100), opcjonalny `status` | Wyświetla ostatnie połączenia.                                                                                     |
| `get_call_transcript` | `call_id`                                       | Pobiera pełną transkrypcję połączenia.                                                                             |

Wszystkie narzędzia są ograniczone do organizacji powiązanej z kluczem API. Identyfikator z innej organizacji zachowuje się jak niedostępny.

## Metody protokołu

Punkt końcowy implementuje metody MCP JSON-RPC wymagane przez klientów Streamable HTTP:

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

Możesz bezpośrednio sprawdzić katalog narzędzi:

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

Wywołaj narzędzie, podając jego nazwę i argumenty:

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

Wyniki narzędzi są elementami treści tekstowej MCP. Błędy narzędzi są zwracane w wyniku z `isError: true`; nieznane metody JSON-RPC zwracają błąd protokołu.

## Bezpieczne wykonywanie połączeń

`place_call` stosuje te same zasady co
[`POST /v1/call`](/api-reference/outbound-calls): agent i numer muszą należeć do organizacji powiązanej z kluczem, numer musi kwalifikować się do połączeń wychodzących, organizacja musi mieć wystarczające saldo, a wszelkie wymagane potwierdzenia połączeń wychodzących muszą być ukończone.

Traktuj klienta z dostępem do `place_call` jak narzędzie do wykonywania połączeń produkcyjnych. Ogranicz, kto może korzystać z klienta, jasno określ w jego własnym poleceniu docelowego agenta i numer, a następnie sprawdzaj połączenia w Historii połączeń.

## Pełna dokumentacja komunikacji

Przykłady odpowiedzi, błędy JSON-RPC i API do zarządzania zdalnymi serwerami znajdziesz w [API serwerów MCP](/api-reference/mcp-servers#thunderphone-as-an-mcp-server).