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

# MCP bağlantısı

> Uzak MCP istemcisini İletişim'e bağlayın; bağlantı biçimini, protokolü ve hataları kontrol edin.

İletişim, başlıkla kimlik doğrulamayı destekleyen uzak MCP istemcileriyle çalışır. Sunucu durumsuz Streamable HTTP kullanır: her istekte tek bir JSON-RPC mesajı alır ve JSON yanıtı verir.

## İstemci ayarları

**1. Bir API anahtarı hazırlayın**

**Ayarlar → API ve MCP** bölümünden [anahtar oluşturun](/api/api-anahtari.md). Anahtarın yetkisi istemcinin göreceği araçları belirler.

**2. Uzak MCP sunucusu ekleyin**

İstemcinizin MCP bağlantıları bölümünde HTTP bağlantısını seçin ve sunucu adresini `https://api.iletisim.app/api/mcp` olarak girin.

**3. Kimlik başlığını ekleyin**

Başlık adını `Authorization`, değerini `Bearer <API_ANAHTARI>` olarak ayarlayın. Yer tutucunun yerine kendi anahtarınızı istemcinin güvenli alanında kullanın.

**4. Bağlantıyı kontrol edin**

Araç listesini yenileyin. Okuma yetkili anahtar dört araç, yazma yetkili anahtar altı araç görür. Araç adlarını [Araçlar](/api/araclar.md) sayfasıyla karşılaştırabilirsiniz.

İstemcinin özel `Authorization` başlığı gönderebilmesi gerekir. OAuth ile giriş isteyen bağlantılar için OAuth akışı henüz yoktur.

## HTTP üzerinden protokol

Her istekte aşağıdaki başlıkları gönderin:

```http theme={"system"}
Content-Type: application/json
Authorization: Bearer <API_ANAHTARI>
```

| Yöntem | İşlev |
| - | - |
| `initialize` | Protokol sürümünü, sunucu bilgisini ve araç yeteneğini alır. |
| `notifications/initialized` | Başlatma bildirimidir; `id` olmadan gönderilir, HTTP `202` döner. |
| `ping` | Bağlantıyı kontrol eder; boş sonuç döner. |
| `tools/list` | Anahtarın erişebildiği araçları ve JSON girdi şemalarını listeler. |
| `tools/call` | Bir aracı `name` ve `arguments` ile çalıştırır. |

Desteklenen protokol sürümleri `2025-06-18`, `2025-03-26` ve `2024-11-05`tir. Sunucu SSE akışı veya oturum kimliği oluşturmaz. JSON-RPC toplu istek dizileri desteklenmez. `GET` ve `DELETE` istekleri `405` döner; istekleri `POST` ile gönderin.

Başlatma örneği:

```json theme={"system"}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": { "name": "isletme-asistani", "version": "1.0.0" }
  }
}
```

## Sonuçları okuyun

Başarılı araç sonucu, `result.content` içinde metin olarak bulunur. Nesne biçimindeki başarılı sonuç `result.structuredContent` alanında da verilir.

Araç çalışmış ancak işlem tamamlanamamışsa `result.isError: true` dönebilir. Örneğin, yalnızca okuma yetkili anahtarla mesaj gönderme denemesi bu biçimde sonuçlanır. Uygulamanız HTTP durumuyla birlikte JSON-RPC `error` ve `result.isError` alanlarını da kontrol etmelidir.

## Bağlantı sorunları

| Yanıt | Kontrol edin |
| - | - |
| HTTP `401`, `unauthorized` | `Authorization` başlığını, `Bearer` önekini ve anahtarın iptal edilmediğini kontrol edin. |
| HTTP `403`, `plan_feature` | İşletmenin paketinde **API ve MCP erişimi** bulunduğunu kontrol edin. |
| HTTP `423`, `workspace_suspended` | İşletmenin askı durumunu **Ayarlar → Abonelik** bölümünden kontrol edin. |
| JSON-RPC `-32700` | İstek gövdesinin geçerli JSON olduğunu kontrol edin. |
| JSON-RPC `-32600` | `jsonrpc`, `method` ve `id` alanlarını kontrol edin; tek bir nesne gönderin. |
| JSON-RPC `-32601` | Yöntemi `initialize`, `ping`, `tools/list` veya `tools/call` olarak kontrol edin. |
| JSON-RPC `-32602` | Araç adını ve [parametre sınırlarını](/api/araclar.md) kontrol edin. Hata `data` alanı sorunlu alanı gösterebilir. |
| `result.isError: true` | `content` içindeki açıklamayı okuyun; anahtar yetkisini, kanal bağlantısını ve mesajlaşma penceresini kontrol edin. |

Müşteriye mesaj gönderecek bir asistan kurarken gönderilecek metni kullanıcıya onaylatın. WhatsApp serbest metin gönderiminde müşterinin son mesajından itibaren 24 saat kuralı uygulanır.

Son güncelleme: 23 Ekim 2026


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