MCP bağlantısı - İletişim

İ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ı

Bir API anahtarı hazırlayın

Ayarlar → API ve MCP bölümünden anahtar oluşturun. Anahtarın yetkisi istemcinin göreceği araçları belirler.

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.

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.

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 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:

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-05tir. 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:

{
  "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ı 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

​İstemci ayarları

​HTTP üzerinden protokol

​Sonuçları okuyun

​Bağlantı sorunları

İstemci ayarları

HTTP üzerinden protokol

Sonuçları okuyun

Bağlantı sorunları