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

# ThunderPhone'u MCP sunucusu olarak kullanın

> Ajanları listelemek, çağrıları ve transkriptleri incelemek ve bir kuruluş API anahtarıyla giden çağrılar başlatmak için herhangi bir Streamable HTTP MCP istemcisini ThunderPhone'a bağlayın.

ThunderPhone, şu adreste bir Model Context Protocol sunucusu sunar:

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

Kuruluşunuzun ajanlarını ve çağrılarını araç olarak kullanılabilir hale getirmek için bir MCP istemcisini bu Streamable HTTP uç noktasına yönlendirin. Bu, [uzak bir MCP sunucusunu sesli AI ajanına bağlama](/tr/guides/mcp-servers) işleminin ters yönüdür:

| Yön                                    | Sonuç                                                                        |
| -------------------------------------- | ---------------------------------------------------------------------------- |
| Uzak MCP sunucusu → ThunderPhone ajanı | Sesli AI ajanınız uzak sunucunun araçlarını çağırabilir.                     |
| ThunderPhone → MCP istemciniz          | MCP istemciniz ajanlar ve çağrılar için ThunderPhone araçlarını çağırabilir. |

## Kimlik doğrulama

**Organization → Keys** altında bir `sk_live_` anahtarı oluşturun ve bunu Bearer
belirteci olarak gönderin. MCP uç noktası, pano oturum tanımlama bilgilerini veya yayımlanabilir widget anahtarlarını değil, kuruluş API anahtarlarını kabul eder.

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

<Warning>
  Bir `sk_live_` anahtarı kuruluş verilerine erişebilir ve çağrı başlatabilir. Bu anahtarı
  tarayıcı kodundan, depolardan, ekran görüntülerinden ve sohbet günlüklerinden uzak tutun. MCP istemcinizin desteklediği bir gizli anahtar deposu kullanın ve anahtar açığa çıkarsa hemen iptal edin.
</Warning>

## Kullanılabilir araçlar

| Araç                  | Bağımsız değişkenler                                | İşlevi                                                                                         |
| --------------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `list_agents`         | yok                                                 | Kuruluş ajanlarını kimlik, ad, ürün ve ses bilgileriyle listeler.                              |
| `get_agent`           | `agent_id`                                          | Tek bir ajanı getirir.                                                                         |
| `place_call`          | `agent_id`, `from_number`, `to_number`              | REST çağrı uç noktasıyla aynı doğrulama ve faturalandırma kontrolleriyle giden çağrı başlatır. |
| `get_call`            | `call_id`                                           | Çağrı durumunu, özetini ve notunu getirir.                                                     |
| `list_calls`          | isteğe bağlı `limit` (1–100), isteğe bağlı `status` | Son çağrıları listeler.                                                                        |
| `get_call_transcript` | `call_id`                                           | Bir çağrının tam dökümünü getirir.                                                             |

Tüm araçlar API anahtarına bağlı kuruluşla sınırlıdır. Başka bir kuruluşa ait kimlik, kullanılamazmış gibi davranır.

## Protokol yöntemleri

Uç nokta, Streamable HTTP istemcileri için gerekli MCP JSON-RPC yöntemlerini uygular:

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

Araç kataloğunu doğrudan inceleyebilirsiniz:

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

Bir aracı adı ve bağımsız değişkenleriyle çağırın:

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

Araç sonuçları MCP metin içeriği öğeleridir. Araç hataları sonuç içinde `isError: true` ile döndürülür; bilinmeyen JSON-RPC yöntemleri protokol hatası döndürür.

## Çağrıları güvenli şekilde başlatma

`place_call`, [`POST /v1/call`](/api-reference/outbound-calls) ile aynı kuralları izler: ajan ve numara anahtarın kuruluşuna ait olmalı, numara giden çağrılar için uygun olmalı, kuruluşun yeterli bakiyesi bulunmalı ve geçerli tüm giden çağrı onayları tamamlanmış olmalıdır.

`place_call` erişimi olan bir istemciyi üretim ortamında çağrı başlatan bir istemci olarak değerlendirin. İstemciyi kimlerin kullanabileceğini kısıtlayın, amaçlanan ajanı ve numarayı kendi isteminde açıkça belirtin ve çağrıları Çağrı Geçmişi'nde inceleyin.

## Tam bağlantı referansı

Yanıt örnekleri, JSON-RPC hataları ve uzak sunucu yönetimi API'si için [MCP Servers API](/api-reference/mcp-servers#thunderphone-as-an-mcp-server) sayfasına bakın.