Yapay zekâ uygulamalarını bağlayın (MCP)

MonoChat MCP Server, Model Context Protocol (MCP) destekleyen bir yapay zekâ uygulamasının (örneğin Claude Code veya Cursor) MonoChat hesabınızla çalışmasını sağlar. Yapay zekâ uygulaması, MonoChat'ten sabit bir araç kümesi aracılığıyla veri ister; yalnızca sizin görebildiklerinizi görebilir.

MonoChat MCP Server her planda kullanılabilir, plana göre bir sınırı yoktur.

Bağlantı sizin adınıza çalışır

Erişim anahtarınızla bağlanan bir yapay zekâ uygulaması kullanıcınız olarak çalışır. Yalnızca erişebildiğiniz tenant'lara ulaşır, başka hiçbir yere ulaşmaz. Artık kullanmadığınız bağlantıları iptal edin.

Yapay zekâ uygulaması neler yapabilir

Bu araçlar her bağlantı için kullanılabilir:

Araç	Ne yapar
list_tenants	Bağlantının erişebildiği tenant'ları listeler.
list_sessions	Bir tenant'ın görüşme oturumlarını en yeniden başlayarak listeler; isteğe bağlı olarak yalnızca opened, assigned veya closed olanları gösterir.
get_session	Tek bir görüşme oturumunu döndürür.
list_messages	Bir oturumun mesajlarını en yeniden başlayarak listeler.
search_customers	Bir tenant'ın müşterilerini anahtar sözcükle arar.
list_message_templates	Bir tenant'ın tek bir kanalındaki mesaj şablonlarını listeler.

Mesaj metni müşterilerden ve temsilcilerden gelir. Yapay zekâ uygulamasının okuyacağı veridir, talimat değildir.

Bir bağlantının kapsamı Salt okunur veya Okuma ve yazma olabilir. Salt okunur bir bağlantı, veriyi değiştiren araçları hiçbir zaman görmez. Yukarıda listelenen tüm araçlar yalnızca okur.

Bağlantı oluşturun

Bağlantı bir tenant'a değil, hesabınıza aittir. Önce iki adımlı doğrulamayı (e-posta veya kimlik doğrulama uygulaması ile) kurmanız gerekir.

1. Profil ayarlarınızı açın, MCP bağlantıları sekmesini seçin ve Oluştur düğmesine tıklayın.
2. Bir ad girin, kapsamı seçin (varsayılan Salt okunur) ve gün olarak geçerlilik süresini girin (varsayılan 90, en fazla 365).
3. İki adımlı doğrulama yönteminizden gelen 6 haneli onay kodunu girin. E-posta doğrulaması kullanıyorsanız önce Onay kodu gönder düğmesine tıklayın.
4. Erişim anahtarını kopyalayın. Yalnızca bir kez gösterilir; mcp_sk_ ile başlar.

En fazla 10 etkin bağlantınız olabilir.

Yapay zekâ uygulamasını bağlayın

Sunucu https://app.monochat.ai/api/mcp-server adresindedir (MonoChat'i kendi sunucularınızda çalıştırıyorsanız kendi MonoChat adresinizi kullanın) ve erişim anahtarını Authorization başlığında bearer token olarak bekler.

Claude Code

claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
  --header "Authorization: Bearer <access key>"

Cursor

Sunucuyu ~/.cursor/mcp.json dosyasına ekleyin:

{
  "mcpServers": {
    "monochat": {
      "url": "https://app.monochat.ai/api/mcp-server",
      "headers": { "Authorization": "Bearer <access key>" }
    }
  }
}

Akışlı (streamable) HTTP aktarımını ve özel başlıkları destekleyen diğer tüm MCP istemcileri de aynı şekilde bağlanır.

Sınırlar

Çağrılar dakika başına sayılır: bağlantı başına 60, hesap başına 300 ve tenant başına 600; ayrıca bağlantı başına aynı anda en fazla 4 çağrı yapılabilir. Bazı araçlar birden fazla çağrı olarak sayılır. Bir sınıra ulaşıldığında sunucu 429 durumu ve Retry-After başlığıyla yanıt verir; yapay zekâ uygulaması o kadar saniye beklemelidir.

Bağlantıyı iptal edin

MCP bağlantıları sekmesindeki her bağlantı durumunu, kapsamını, son kullanma tarihini ve son kullanımını gösterir. Yapay zekâ uygulamasının erişimini hemen kesmek için İptal et düğmesine tıklayın. İptal edilmiş veya süresi dolmuş bir bağlantı yeniden kullanılamaz; bunun yerine yeni bir tane oluşturun.

Organizasyonun MCP erişimini yönetin

Bir organizasyonun ayarlarını değiştirebilen kullanıcılar, MCP erişimini Ayarlar › Organizasyon › MCP Sunucusu bölümünden yönetir.

• Bu organizasyon için MCP erişimini kapat: açıp Kaydet düğmesine tıklayınca bu organizasyona gelen her MCP çağrısı, her kullanıcının her bağlantısı için reddedilir. Organizasyon artık list_tenants sonucunda görünmez. MCP erişimine yeniden izin vermek için kapatıp kaydedin.
• MCP çağrıları: bu organizasyonu belirten araçlara yapılan her çağrı, en yeniden eskiye, reddedilenler dahil. Her satırda kullanıcı, bağlantı, araç, durum (Başarılı veya Başarısız), IP adresi ve zaman görünür. Bu organizasyonun üyesi olmayan kullanıcıların çağrıları gösterilmez.