> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iletisim.app/llms.txt
> Use this file to discover all available pages before exploring further.

# API ve MCP

> İletişim verilerini kendi yazılımınıza ve MCP destekleyen yapay zekâ asistanlarına bağlayın.

İletişim'in MCP sunucusuyla sohbetleri ve mesajları okuyabilir, müşteri arayabilir ve iletişim raporu alabilirsiniz. Yazma yetkili anahtarla müşteriye metin mesajı gönderebilir veya sohbete iç not ekleyebilirsiniz.

MCP, bir yapay zekâ istemcisinin İletişim'deki araçları kullanmasını sağlayan bağlantı biçimidir. Kendi yazılımınız da aynı sunucuya HTTP üzerinden istek gönderebilir.

## Erişim koşulları

* **API ve MCP erişimi Kurumsal pakettedir.** Ekip denemesi API erişimini içermez.
* Anahtar oluşturma ve iptal etme işlemlerini **Sahip** ve **Yönetici** yapar.
* Her anahtar yalnızca oluşturulduğu **İşletme**nin verisine erişir.
* Anahtarın yetkisi **Yalnızca okuma** veya **Okuma ve yazma (mesaj, not)** olarak seçilir.

Paketinizi **Ayarlar → Abonelik** bölümünde kontrol edebilirsiniz. Ayrıntılar için [Abonelik ve paketler](/kilavuz/yonetim/abonelik.md) sayfasını açın.

## Bağlantı bilgileri

| Alan | Değer |
| - | - |
| Sunucu adresi | `https://api.iletisim.app/api/mcp` |
| Taşıma | Streamable HTTP; `POST` |
| Kimlik doğrulama | `Authorization: Bearer <API_ANAHTARI>` |
| İstek gövdesi | JSON-RPC 2.0; istekte bir mesaj |
| İçerik türü | `Content-Type: application/json` |

Bu bölümdeki başlıklar ve örnekler `/api/mcp` uç noktası içindir. API anahtarı, panelin diğer `/api/*` adreslerinde kullanıcı oturumu yerine geçmez. MCP araçları [Araçlar](/api/araclar.md) sayfasında listelenir.

## İlk bağlantı

**1. Anahtar oluşturun**

**Ayarlar → API ve MCP → Yeni anahtar** yolunu izleyin. Yalnızca bilgi okuyacak bir bağlantı için **Yalnızca okuma** seçin. [API anahtarı oluşturma](/api/api-anahtari.md) sayfasında adımların tamamı yer alır.

**2. İstemciyi bağlayın**

İstemcinize sunucu adresini ve `Authorization` başlığını ekleyin. [MCP bağlantısı](/api/mcp.md) sayfasındaki alanları kullanın.

**3. Araçları kontrol edin**

İstemcinin araç listesinde `sohbetleri_listele` gibi İletişim araçlarının göründüğünü kontrol edin. HTTP ile bağlanıyorsanız [örnek istekleri](/api/ornekler.md) kullanın.

## Kullanılabilen işlemler

| İşlem | Araç | Anahtar yetkisi |
| - | - | - |
| Sohbetleri listeleme ve arama | `sohbetleri_listele` | Okuma |
| Sohbetin son mesajlarını okuma | `sohbet_mesajlari` | Okuma |
| Ad veya telefonla müşteri arama | `musteri_ara` | Okuma |
| 7, 30 veya 90 günlük iletişim raporu | `iletisim_raporu` | Okuma |
| Müşteriye metin mesajı gönderme | `mesaj_gonder` | Yazma |
| Sohbete iç not ekleme | `not_ekle` | Yazma |

Yazma yetkisi okuma araçlarını da kapsar. MCP ile gönderilen mesajlarda panelde anahtarın adı **API: anahtar adı** olarak görünür. `not_ekle` ile eklenen metin müşteriye gönderilmez.

Son güncelleme: 23 Ekim 2026


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.