MCP Eylemleri

MCP (Model Context Protocol), AI’ın başka hizmetin araçlarını doğrudan kullanmasını sağlayan açık standarttır. Uç noktayı ve parametrelerini elle açıklamanız yerine MCP sunucusu kendi araçlarını yayınlar; AI Temsilciniz bunları keşfedip kullanır.

Çoğu hizmeti bağlamak tek tıklama sürer. Eylemler ve MCP’ler bölümüne gidin, + Eylem ekle düğmesine tıklayın ve MCP seçin.

Cloudflare belgeleri veya Microsoft Learn uç noktasına örnek MCP bağlantısını kontrol edin. Kontrol yalnızca başlatma ve araç listesi istekleri yapar; giriş yapılmaz veya araç çalıştırılmaz.

İsteğe bağlı kurulum araçları

• MCP bellek eşlemelerini önizleyin. Araç çağırmadan veya konuşma belleğini değiştirmeden sağlanan bellek kurallarını örnek MCP araç sonucuna uygulayın.

• MCP araç listelerini karşılaştırın. Tanım değişikliklerini ve inceleme noktalarını görmek için sağlanan iki araç listesini ve belirtilen etkinleştirme ayarlarını karşılaştırın. Bu araç sunucuya bağlanmaz veya uyumluluğu kanıtlamaz.

• MCP bağlantı yönünü kontrol edin. Herkese açık uç nokta ve seçilen amaçtan kurulum ayrıntıları hazırlayın. Bu araç kimlik bilgisi kabul etmez, sunucuya bağlanmaz veya hesabınızı değiştirmez.

Katalogdan bağlanma

MCP ekranı, tanınmış hizmetlerin kategorilere ayrıldığı aranabilir katalogla açılır (Popüler, Müşteri desteği, CRM ve satış, Planlama, E-ticaret, Ödemeler ve faturalandırma, Pazarlama ve e-posta, İletişim, Üretkenlik, Veri ve analiz, Arama ve web, Seyahat ve rezervasyon, Tasarım, Geliştirici ve altyapı).

1. Göz atarak veya arama kutusuyla istediğiniz hizmeti bulun.
2. Kutucuğuna tıklayın. Quickchat sunucuyu kontrol eder ve sunduğu araçları keşfeder.
3. Hizmet giriş gerektiriyorsa Yetkilendirme gerekli paneli görünür. <hizmet> ile bağlan düğmesine tıklayın, açılan pencerede erişimi onaylayın; panel bağlı durumuna geçer.
4. Eylem oluşturulur, etkinleştirilir ve araçları listelenir. AI Temsilciniz sonraki mesajdan itibaren bunları kullanabilir.

Not

Yetkilendirmeyi başlattıktan sonra Eylemler panelini veya yetkilendirme penceresini kapatırsanız Quickchat eylemi ve bekleyen yetkilendirmeyi korur. Devam etmek için eylemi yeniden açıp Yetkilendirmeyi tekrar aç düğmesine, durdurmak için İptal düğmesine tıklayın. Panel kapandıktan sonra sağlayıcı yetkilendirmeyi tamamlarsa Quickchat bağlantıyı arka planda tamamlar ve planınızda kapasite varsa eylemi etkinleştirir.

İpucu

Tarayıcınız Quickchat kontrol paneli için açılır pencerelere izin vermelidir; aksi hâlde yetkilendirme penceresi açılamaz. Engellenirse açılır pencerelere izin verip tekrar denemenizi isteyen mesaj görürsünüz.

Katalogda olmayan sunucuya bağlanma

Kataloğun altındaki URL’yi manuel gir seçeneğine tıklayın, ardından:

1. MCP sunucu URL’sini yapıştırın (https:// ile başlamalıdır).
2. Sunucu giriş akışı yerine sabit belirteçle kimlik doğruluyorsa Bağlantı üstbilgileri (isteğe bağlı) bölümünü açın ve beklediği üstbilgiyi ekleyin; örneğin Authorization: Bearer <your-token>.
3. Bağlan düğmesine tıklayın.

Kutucuk görünümüne dönmek için Kataloğa göz at seçeneğini kullanın. İhtiyacınız olan hizmet yoksa Entegrasyon eksik mi? Önerin seçeneği ekibimize önceden doldurulmuş e-posta açar.

AI’ın kullanabileceği araçları seçme

Bağlandıktan sonra eylem, sunucunun sunduğu her aracı kendi anahtarıyla listeler. AI’ın çağırmasını istemediklerinizi kapatın. Örneğin rezervasyon sunucusunun salt okunur sorguları açık kalırken iptal aracı kapalı kalabilir.

Varsayılan araç etkinleştirmesi, sunucu daha sonra yeni araç eklediğinde ne olacağını belirler: açıksa yeni araçlar hemen kullanılabilir; kapalıysa her birini bilerek etkinleştirirsiniz.

Bazı katalog girdilerinde Quickchat tarafından ayarlandı işareti vardır. Quickchat bu sunucuları uçtan uca test etmiş; odaklı araç seçimi, gereken bellek kuralları ve her biri için Düşünme mesajı sağlamıştır. Test edilen kurulumun neleri değiştireceğini görmek için Önerileni kullan seçin. Önerilen kurulum uygulansın mı? iletişim kutusu açıp kapattığı araçları ve ayarladığı bellek kurallarını listeler; düzenlediğiniz kuralların üzerine yazacaksa uyarır. Eylemi kaydedene kadar hiçbir şey kaydedilmez ve sonradan her aracı değiştirebilirsiniz.

İpucu

MCP eylem adı ve MCP eylem açıklaması, sizin ve ekibinizin kullandığı etiketlerdir. Eylemler listesinde eylemi tanımlarlar ve AI bunları asla okumaz. AI’ı yönlendiren şey MCP sunucusunun yayınladığı araç açıklamaları ve temsilcinizin Ana istemidir. Yönlendirmek için sunucunun araçlarını hangi durumlarda kullanması gerektiğini belirtin (“her proje sorusunu Linear araçlarıyla yanıtla”) ve modelin aksi hâlde tahmin edeceği değerleri sabitleyin (“her zaman acme-eng çalışma alanında ara”). Aynı sunucuyu iki kez bağlarsanız bağlantıları sağlayıcıya göre değil işlerine göre adlandırın (“Notion yardım merkezi”, “Notion destek talepleri”).

Calendly ile randevu saatleri

Bir Eylem Calendly’nin https://mcp.calendly.com sunucusuna bağlanıp aşağıdaki iki aracı da etkinleştirdiğinde Quickchat onlara yerel saat girdileri verir. Adları aynı kalır ve ek dönüştürme aracı eklenmez. Yalnızca biri etkinse Calendly’nin özgün girdilerini korur.

• Müsaitlik: event_types-list_event_type_available_times, local_start_time, local_end_time ve Europe/London gibi IANA timezone alır. Yerel tarih ve saatleri YYYY-MM-DDTHH:MM:SS biçiminde verin. Quickchat aralığı o tarihlerdeki saat dilimi kurallarıyla UTC’ye dönüştürür; saat değişimindeki 23 ve 25 saatlik günler dahildir.
• Rezervasyon: meetings-create_invitee, seçilen seçeneğin local_start_time ve booking_timezone değerlerini post_invitee_request içinde alır. Mevcut invitee.timezone, randevu saat diliminden farklı olabilen müşterinin saat dilimi olarak kalır. Örneğin America/New_York içindeki davetli, Europe/London cinsinden ifade edilen saat dilimini rezerve edebilir.

Müsaitlik seçeneğiyle dönen yerel saati ve saat dilimini kopyalayın. Dönen saat UTC farkı içeriyorsa koruyun; saatler geri alındığında yinelenen yerel saatleri bu fark ayırt eder. Geçersiz veya mevcut olmayan yerel saatler, fark belirtilmemiş belirsiz saatler ve belirtilen saat dilimiyle uyuşmayan farklar reddedilir.

Saat seçeneği sunmak rezervasyon yapmaz. Randevu oluşturmadan önce Quickchat güncel müsaitliği yeniden kontrol eder ve eşleşen sağlayıcı zaman damgasını değiştirmeden Calendly’ye gönderir. Saat artık uygun değilse rezervasyon denenmez. Rezervasyon sonucu, temsilcinin onayı için yerel gösterim saati içerir; $.resource.event gibi Belleğe kaydet tarafından kullanılan sağlayıcı alanları kullanılabilir kalır.

Müşteri onayı gereksinimini Ana isteminizde koruyun ve yalnızca başarılı sağlayıcı sonucu sonrasında rezervasyonu onaylayın. Tarayıcı veya mesajlaşma kanalından bağımsız olarak konuşmada randevu saat dilimini açıkça belirleyin. Belirsizse müsaitlik kontrolünden veya rezervasyondan önce müşteriye sorun.

MCP araç sonucunu belleğe kaydetme

Sonuçtaki değere konuşmanın ilerleyen aşamasında ihtiyaç duyulacaksa aracı genişletip Belleğe kaydet kullanın. Değer için JSONPath ifadesi ve onu tanımlayan Bellek anahtarı ekleyin. Tek araçtan en fazla 10 değer kaydedebilirsiniz.

Bellek anahtarları temsilcinin API Eylemleriyle ortaktır. API Eylemi zaten aynı anahtara kaydediyorsa Bellek anahtarı alanı kaydettiğinizde çakışmayı bildirir; farklı anahtar seçin.

Kaydedilen değer, AI’ın sonraki turlarda okuyabileceği konuşma verisinin parçası olur. Örneğin rezervasyon aracı etkinlik URI’sini kaydedebilir; böylece iptal aracı hangi toplantıyı iptal edeceğini bilir. AI argümanları doğrudan sağladığından MCP araçları, API Eylemleri için gösterilen {{metadata_<key>}} yer tutucusunu kullanmaz.

Toplu Tümünü etkinleştir ve Tümünü devre dışı bırak değişiklikleri bellek kurallarını korur. Yeniden bağlan da sunucunun araç listesini yenilerken araç seçimlerinizi ve bellek kurallarınızı korur.

Ziyaretçiler ne görür?

Araç çalışırken sohbet widget’ı AI’ın ne yaptığını açıklayan kısa durum satırı gösterir. Araçlar panelinde her aracın Düşünme mesajı alanı vardır: boş bırakırsanız satır araç adından türetilir (search_flights adlı araç “Uçuşlar aranıyor…” gösterir) veya kendiniz yazabilirsiniz (“Yardım merkezinde aranıyor”). Ayarlanmış sunucularda önerilen araçlar için bu alanlar doldurulmuş gelir. Satır, bekleme sırasında ziyaretçiye yalnızca yazma göstergesi yerine anlamlı bilgi verir.

Yeniden bağlanma ve bağlantıyı kesme

• Yeniden bağlan: yetkilendirmeyi yeniden çalıştırır. Bağlantının süresi dolduysa, farklı hesabı yetkilendirmek istiyorsanız veya sunucunun araç listesi değiştiyse ve yenilerini almak istiyorsanız kullanın.
• Bağlantıyı kes: saklanan yetkilendirmeyi iptal eder ve eylemi çevrimdışına alır. Eylem listede kalır; daha sonra yeniden kurmadan bağlanabilirsiniz.

Bağlı eylemde MCP sunucu URL’sini değiştirmek yetkilendirmeyi temizler ve eylemi kapatır; çünkü bir sunucunun verdiği kimlik bilgileri başka sunucuda kullanılmaz. Yeniden çevrimiçi yapmak için tekrar yetkilendirin.

Sorun giderme

Gördüğünüz durum	Anlamı
Yetkilendirme tamamlanmadı	Tekrar dene düğmesine tıklayın. Erişimi reddettiyseniz sonraki denemede onaylayın. Başka hata olursa destekle iletişime geçip mesajdaki hata kodunu ekleyin.
Bağlandı, ancak araçlar yüklenemedi	Yetkilendirme başarılı ancak araç listesi yüklenmedi. Yeniden bağlan düğmesine tıklayın.
Bu sunucuda araç bulunamadı. Yeniden bağlanmayı deneyin.	Sunucu yetkilendirdi ancak araç yayınlamadı. Onayladığınız hesabın beklediğiniz verilere erişimi olduğunu doğrulayın.
https:// ile başlayan geçerli bir URL girin	URL okunamadı. Sunucunun tam https:// adresini kullanın. Quickchat her zaman https üzerinden bağlanır; kimlik bilgileri şifrelenmeden gönderilmez.
Eylem kendiliğinden kapandı	Yetkilendirmesi sona erdi veya sağlayıcı tarafından iptal edildi. Eylemi açıp Yeniden bağlan düğmesine tıklayın.

Not

MCP eylemleri, API Eylemleri gibi planınızın Özel Eylemler kotasına dahil edilir.