# MCP Sunucularını Botunuza Bağlayın MCP sunucuları, yapay zeka botunuzun canlı görüşmeler sırasında başka bir sistemdeki araçları kullanmasını sağlar; üstelik her bir aracı elle oluşturmanıza gerek kalmaz. Botu bir kez bir MCP sunucusuna yönlendirmeniz yeterlidir; sunucunun sunduğu tüm araçlar otomatik olarak botun kullanımına açılır. Özel İşlevleri (Custom Functions) kullandıysanız, bu aynı mantığın bir adım ötesidir: özel bir işlev kendinizin bağladığı tek bir araçken, MCP sunucusu botun kendi kendine keşfedip çağırabileceği hazır bir araç paketidir. --- ## MCP Sunucusu Nedir? MCP (Model Context Protocol), yapay zeka asistanlarına harici araçlara erişim sağlamak için kullanılan açık bir standarttır. Günümüzde birçok modern uygulama ve hizmet, yapay zekanın çağırabileceği bir araç setini (bir şeye bakma, kayıt getirme, sorgu çalıştırma, öğe oluşturma gibi) sunan tek bir web adresi olan bir "MCP sunucusu" yayınlamaktadır. Her bir aracı bota tanımlamak yerine, Your AI Connector sunucunun adresini ve bir erişim anahtarını verirsiniz. Your AI Connector sunucuya "neler yapabilirsin?" diye sorar, araç listesini alır ve bunları botunuzun kullanımına sunar. Sunucu yeni bir araç eklediğinde, botunuz sizin tarafınızdan herhangi bir ek kurulum yapılmasına gerek kalmadan bu aracı kullanabilir. **Özel İşlevler ve MCP Sunucuları — hangisini kullanmalı:** | | Özel Fonksiyonlar | MCP Sunucuları | | ------------------ | --------------------------------------------------- | -------------------------------------------------------------- | | **Kurulum** | Her seferinde bir araç, tamamen manuel (URL, girdiler, yanıt eşleme). | Bir sunucu adresi — bot tüm araçlarını sizin için keşfeder. | | **En uygun olduğu durum** | Kendi sisteminize yönelik tek ve özel bir çağrı. | MCP dilini konuşan ve birçok araç sunan bir hizmete bağlanmak. | | **Bakım** | Araç değiştiğinde fonksiyonu siz güncellersiniz. | Sunucudan gelen yeni araçlar otomatik olarak görünür. | Aynı Ajan üzerinde her ikisini de aynı anda kullanabilirsiniz. --- ## Nasıl Çalışır (Basitleştirilmiş Versiyon) 1. **MCP Sunucuları** sayfasında bir **MCP sunucusu kaydedersiniz** — web adresi ve bir yetkilendirme başlığı (genellikle bir API anahtarı). 2. Your AI Connector, sunucunun araçlarına **bağlanır ve bunları keşfeder**, ardından listeyi hatırlar. 3. Sunucuyu bir **Ajan üzerinde etkinleştirirsiniz**. 4. Bir görüşme sırasında, müşteri bir aracın yanıtlayabileceği bir şey sorduğunda, **bot aracı çağırır**, sonucu okur ve doğal bir şekilde yanıt verir. Müşteri arka plandaki işleyişi asla görmez; sadece gerçek ve güncel bilgilerle desteklenen bir yanıt alır. ### Bir MCP araç çağrısının maliyeti Bir MCP sunucusundan gelen araç çağrısı, tıpkı özel bir işlev çağrısı gibi, Ajanınızın Yapay Zeka Kalite katmanı üzerinden ücretlendirilir: | Yapay Zeka Kalite katmanı | MCP araç çağrısı başına kredi | Kendi Anthropic anahtarınız (BYOK) bağlıyken | |---|---|---| | Pro | 1 kredi | 0 kredi — kendi anahtarınız üzerinden çalışır | | Economy (kullanımdan kaldırıldı) | 0.5 kredi | 0 kredi — kendi anahtarınız üzerinden çalışır | | Max | 0.25 kredi | yine 0.25 kredi, kendi anahtarınız bağlı olsa bile ücretlendirilir, çünkü Max kendi modelimiz üzerinde çalışır | | Mini | 0.15 kredi | yine 0.15 kredi, kendi anahtarınız bağlı olsa bile ücretlendirilir, çünkü Mini kendi modelimiz üzerinde çalışır | --- ## MCP Sunucusu Ekleme (Adım Adım) Ana kenar çubuğunda, **AI Studio** altında **MCP Sunucuları**'na tıklayın. Ardından **+ Sunucu Ekle**'ye tıklayın. Formu doldurun: | Alan | Ne Girilmeli | Örnek | | -------------------- | ----------------------------------------------------------------------------- | --------------------------------- | | **Ad** | Sunucu için kısa bir etiket (bot için araçlarını adlandırmada da kullanılır). | `Order System` | | **Sunucu URL'si** | Sunucunun MCP adresi (bazen "uç nokta" olarak adlandırılır), `https://` ile başlar. | `https://tools.mystore.com/mcp` | | **Yetkilendirme Başlığı Adı** | Sunucunun kimlik doğrulama için beklediği başlık. Sunucu belgelerinde aksi belirtilmedikçe `Authorization` olarak bırakın. | `Authorization` | | **Yetkilendirme Başlığı Değeri**| Sunucunun beklediği formatta kimlik bilgisi. | `Bearer sk_live_abc123` | ### Nasıl Giriş Yapılacağını Seçme: API Anahtarı veya OAuth Your AI Connector bir sunucuyla kimlik doğrulaması yapmak için iki yöntemi destekler. Formun üst kısmındaki **Kimlik Doğrulama** seçeneğini kullanarak, sunucunun belgelerinde belirtilen yöntemi seçin: - **API anahtarı / başlık:** yukarıda açıklanan orijinal yöntem. Sabit bir kimlik bilgisini (bir API anahtarı veya belirteç) **Kimlik Doğrulama Başlığı Değeri** alanına yapıştırırsınız ve Your AI Connector bunu her istekte gönderir. Size uzun ömürlü bir anahtar veren sunucular için en uygun yöntemdir. - **OAuth (oturum açma):** anahtar yapıştırmak yerine oturum açmanızı isteyen sunucular için. OAuth ile kopyalanacak bir anahtar yoktur; diğer sitelerdeki "Google ile oturum aç" işlevinde olduğu gibi, oturum açarak erişimi onaylarsınız. **OAuth ile bağlanmak için:** 1. Kimlik doğrulama yöntemi olarak **OAuth** seçeneğini belirleyin. Auth Header alanları kaybolacak ve yerini bir **Connect** kartı alacaktır; bir anahtara ihtiyacınız olmayacak. 2. **Ad** ve **Sunucu URL** bilgilerini doldurun, ardından **Kaydet**'e tıklayın. Sunucu listenize eklenir ancak şimdilik **bağlı değil** olarak görünür. 3. Sunucu üzerinde **Bağlan**'a tıklayın. Erişimi onaylayacağınız güvenli bir oturum açma penceresi açılır. 4. Onaylayın; pencere kendiliğinden kapanacaktır. Sunucu artık bağlı olarak görünür ve Your AI Connector araçlarını yükler. İşte bu kadar. Your AI Connector, bağlantıyı arka planda otomatik olarak güncel tutar, bu nedenle normalde bir daha asla dokunmanız gerekmez. Bir sunucunun bağlantısı kesilirse (örneğin oturum açma süresi dolarsa veya sunucu tarafında birisi erişimi iptal ederse), bağlantı kesildi olarak görünür; sadece **Reconnect** (Yeniden Bağlan) düğmesine tıklayın ve tekrar oturum açın. Sunucu, Bağlan'a tıkladığınızda otomatik olarak kurulamıyorsa, sunucunun kendi belgelerinin sağladığı birkaç ayrıntıyı (bir giriş adresi ve bir istemci kimliği) yapıştırmanız istenir, ardından Bağlan işlemi girişi tamamlar. ### Bağlantıyı Test Edin Kaydetmeden önce **Test Connection** (Bağlantıyı Test Et) düğmesine tıklayın. Your AI Connector sunucuyla iletişime geçer ve size sunduğu araçların listesini gösterir. Bu, URL'nizin ve anahtarınızın doğru olduğunu doğrulamanın en hızlı yoludur; bağlantı başarısız olursa, konuşmanın ortasında fark etmek yerine hata mesajını doğrudan orada görürsünüz. Test başarılı olduğunda **Kaydet** düğmesine tıklayın. Sunucunuz, yeşil bir durum noktası ve sunduğu araç sayısı ile listede görünür. ### Sunucu Listesini Okuma Listedeki her sunucu şunları gösterir: - Bir **durum noktası** — son bağlantı başarılı olduğunda yeşil, son deneme başarısız olduğunda kırmızı (hata için üzerine gelin), ilk başarılı bağlantıdan önce gri. - **Sunucunun adresi** ve şu anda sunduğu araç sayısı. - Sunucuyu silmeden hızlıca etkinleştirmek veya devre dışı bırakmak için bir **açma/kapama düğmesi**. Your AI Connector, her sunucunun araç listesini arka planda günde yaklaşık bir kez yeniler, böylece yeni araçlar kendiliğinden görünür hale gelir. Yavaş veya geçici olarak ulaşılamayan bir sunucu asla bir konuşmayı aksatmaz; bot basitçe bilinen son araç listesini kullanır ve bir çağrı gerçekleşemezse sorunsuz bir şekilde geri dönüş yapar. ### Botun Hangi Araçları Kullanabileceğini Seçme Bir sunucu genellikle botun erişmesini istemediğinizden daha fazla araç sunar. Tüm sunucunun bağlantısını kesmeden tek tek araçları açıp kapatabilirsiniz. 1. Listedeki sunucunun yanındaki **kalem (düzenle)** simgesine tıklayın. 2. **Araçlar** bölümüne gidin; sunucunun sunduğu her araç, kendi açma/kapama düğmesiyle birlikte listelenir. 3. Botun çağırmasını istemediğiniz araçları kapatın veya hepsini tek seferde ayarlamak için **Tümünü etkinleştir** / **Tümünü devre dışı bırak** seçeneklerini kullanın. 4. **Değişiklikleri kaydet** düğmesine tıklayın. Botun kullanımına yalnızca açık bıraktığınız araçlar sunulur. Kapalı olan bir araç bot için tamamen görünmezdir; bot bu aracı çağıramaz ve 40 araçlık sınıra dahil edilmez. Bilinmesi gereken iki önemli nokta: - **Yeni araçlar siz açana kadar kapalı kalır.** Bir sunucunun araçlarını düzenledikten sonra, sunucunun daha sonra eklediği herhangi bir araç kapalı olarak gelir, bu nedenle siz etkinleştirmeye karar verene kadar bota yeni bir şey sunulmaz. (Daha önce hiç düzenlemediğiniz sunucular, tıpkı eskisi gibi tüm araçlarını açık tutar.) - **Bu, aşağıdaki Ajan seçiminden ayrıdır.** Burada, hesap genelinde bir sunucunun hangi araçlarının var olacağına karar verirsiniz; Ajan üzerinde ise o Ajanın hangi sunuculara erişebileceğine karar verir ve isterseniz araçlarını sadece o Ajan için daha da daraltabilirsiniz. ### Araç Başına Yürütme Sınırlarını Ayarlama Her aracın açma/kapama düğmesinin yanında bir **Sınırlar** denetimi bulacaksınız. Bu denetim, [özel bir işlevde](custom-functions.md#execution-limits) ayarlayabileceğiniz yürütme sınırlarının aynısını açar ve yalnızca o araca uygulanır; bir sunucunun aracı ücretli bir üçüncü taraf hizmetini çağırdığında veya bir aracın konuşma başına yalnızca bir kez çalışması gerektiğinde kullanışlıdır. Buradaki her şey isteğe bağlıdır; boş bırakırsanız araç tam olarak daha önceki gibi davranır. - **Salt okunur.** Bazı sunucular her araç için yalnızca veri okuyup okumadığını bildirir. **Otomatik (sunucu ayarı)** bu bildirime güvenir; bunu her iki yönde de geçersiz kılabilirsiniz: Hiçbir şey oluşturmadığını veya değiştirmediğini bildiğiniz bir aracı **Salt okunur** olarak işaretleyin (bu, yapay zekanın kesintiye uğrayan bir yanıtı müşteriyi cevapsız bırakmadan güvenli bir şekilde yeniden denemesini sağlar) veya sunucunun iddiasına güvenmediğinizde **Salt okunur değil** olarak işaretleyin. - **Tekrarlanan çağrılarda önbelleğe alınmış sonucu sun.** Yapay zeka aynı girdilerle aracı tekrar çağırdığında, sunucuyu tekrar çağırmak yerine önceki sonuç (24 saate kadar) yeniden kullanılır. - **Konuşma başına maksimum çalıştırma** ve **zaman aralığı başına maksimum çalıştırma**, özel işlevlerdekiyle tamamen aynı şekilde çalışır: yalnızca başarılı çalıştırmalar sayılır ve bir sınır devreye girdiğinde yapay zekaya nedeni bildirilir ve elindeki bilgilerle yanıt verir; müşteri asla cevapsız bırakılmaz. Test konuşmaları bu sınırlardan muaftır. Güven konusunda dürüst bir not: sınırlar, sunucuyu *çağırıp çağırmayacağımızı* ve ne sıklıkla çağıracağımızı kontrol eder; sunucu çağrıldıktan sonra dahili olarak ne yaptığını değiştiremezler. Üçüncü taraf bir aracı Salt okunur olarak geçersiz kılmak, kendi özel işlevinizdekinden daha güçlü bir iddiadır çünkü bu başkasının kodudur; bunu yalnızca anladığınız araçlar için yapın. --- ## Bir Ajan Üzerinde Sunucu Etkinleştirme Bir sunucuyu kaydetmek onu kullanılabilir hale getirir; ancak hangi Ajanların onu kullanabileceğini yine de siz seçersiniz. 1. [Agent](../ai-agents/ai-agents.md) öğesini açın ve **AI Abilities** sekmesine gidin. (Ayarlarını ayrı bir Agent yerine doğrudan kendi içinde tutan bir kampanya için aynı liste, o kampanyanın kendi **AI Abilities** adımında görünür.) 2. **MCP servers** bölümünü bulun. 3. Bu Agent'ın botunun kullanabilmesini istediğiniz her sunucuyu açın. 4. **Save changes** düğmesine tıklayın; seçimler yalnızca kaydedildikten sonra geçerli olur. Ajan başına en fazla **5 sunucu** etkinleştirebilirsiniz. Yalnızca etkinleştirdiğiniz sunucular o Ajanın botu tarafından kullanılabilir, bu da botun ilgili araçlara odaklanmasını sağlar. ### Bir Ajanın Hangi Araçları Kullanabileceğini Seçme Bir sunucu bir Ajan üzerinde etkinleştirildiğinde, o Ajanın **hangi araçlarını** çağırabileceğini de daraltabilirsiniz — bu, bir Ajanın sadece verileri okuması, diğerinin ise kayıt oluşturabilmesi gerektiği durumlar için kullanışlıdır. 1. **AI Yetenekleri** sekmesinde, etkinleştirilen sunucunun altında, araç listesini genişletmek için **"… bu ajan için etkinleştirilen araçlar"** satırına tıklayın. 2. Bu Ajanın kullanmaması gereken herhangi bir aracı kapatın ve ardından **Değişiklikleri kaydet**'e tıklayın. İki kural bunu öngörülebilir kılar: - **Bir Ajan sadece daraltabilir, asla genişletemez.** Hesap genelinde (MCP Sunucuları sayfasında) kapattığınız araçlar burada görünmez ve tek bir Ajan için yeniden etkinleştirilemez. - **Ajanlar varsayılan olarak devralır.** Araç listesine dokunmadığınız bir Ajan, hesap genelindeki seçimi basitçe takip eder — daha sonra orada etkinleştirdiğiniz araçlar dahil. Bir Ajanın listesini daralttığınızda, yeni araçlar siz etkinleştirene kadar o Ajan için kapalı kalır. --- ## Hazır Örnek: Bir Shopify Mağazası Bağlayın Her Shopify mağazası yerleşik bir MCP sunucusuyla gelir; yüklenecek bir uygulama veya oluşturulacak bir anahtar gerekmez. Shopify bunu mağazanın kendi web adresinin sonuna `/api/mcp` ekleyerek barındırır. Botun buradan elde ettikleri: - **Ürün arama** — müşterinin ne istediğini tanımlayarak ("100 doların altında sıcak tutan bir koşu ceketi") canlı fiyatlar, varyantlar ve stok durumuyla ürünleri bulun. - **Ürün detayları** — seçenekler ve stok durumu dahil olmak üzere belirli bir ürün hakkında tam bilgi. - **Mağaza politikaları ve SSS** — gönderim, iadeler, geri ödemeler ve gizlilik soruları, mağazanın kendi sayfalarından yanıtlanır. - **Sepet** — müşteri için bir sepet oluşturun ve onlara bir ödeme bağlantısı iletin. Bir tane bağlamak için şu bilgilerle bir sunucu ekleyin: | Alan | Ne girilmeli | |---|---| | **Ad** | `Shopify Store` (veya mağazanın adı) | | **Sunucu URL'si** | Mağazanın web adresi artı `/api/mcp` — örneğin `https://mystore.com/api/mcp`. Mağazanın teknik adresi de çalışır: `https://mystore.myshopify.com/api/mcp`. | | **Kimlik Doğrulama** | **API anahtarı / başlığı** seçili kalsın ve **Kimlik Doğrulama Başlığı Değeri** kısmını boş bırakın — bu sunucu herhangi bir anahtara ihtiyaç duymaz. | Kaydedin, **Bağlantıyı Test Et**'e tıklayın ve sunucuyu temsilciniz üzerinde etkinleştirin; kurulumun tamamı bu kadar. Bilmeniz gereken iki şey: - **Siparişler bu sunucuda yer almaz.** Shopify, sipariş verilerini bu genel uç noktadan kasıtlı olarak uzak tutar. "Siparişim nerede?" soruları için bu sunucuyu özel bir işlevle eşleştirin — [Shopify sipariş durumu örneğine](custom-functions.md#complete-example-shopify-order-status) bakın. - **Herhangi bir Shopify mağazası için çalışır** — başkalarının hesaplarını yönetiyorsanız bir müşterinin mağazası dahil. Tek ihtiyacınız olan mağazanın web adresidir. --- ## Güvenlik — Yalnızca Güvendiğiniz Sunucuları Bağlayın Bağladığınız bir MCP sunucusu botunuz tarafından çağrılabilir ve botun okuyup işlem yapabileceği metinler döndürebilir. Buna, sistemlerinizin anahtarını tutan diğer tüm entegrasyonlar gibi davranın: - **Yalnızca kontrol ettiğiniz veya tamamen güvendiğiniz sunucuları kaydedin.** Bir aracın açıklaması, sunucuyu çalıştıran kişi tarafından yazılır ve bot, bir aracı ne zaman kullanacağına karar vermek için bu açıklamaları okur. - **Yönetici kimlik bilgisi yerine özel, sınırlı bir API anahtarı kullanın.** Anahtarınız güvenli bir şekilde saklanır ve veri dışa aktarımlarında asla gösterilmez. Aynı durum OAuth oturum açma işlemleri için de geçerlidir; erişim belirteçleri güvenli bir şekilde saklanır ve tüm dışa aktarımlardan gizlenir. - **URL, herkese açık bir `https://` adresi olmalıdır.** Dahili, localhost ve özel ağ adresleri güvenlik nedeniyle reddedilir. - **Güvenmediğiniz anda bir sunucuyu devre dışı bırakın**; kapatın veya silin; böylece sunucu tüm Temsilcilerden anında kaldırılır. --- ## Sorun Giderme - **Kırmızı durum noktası / bağlantı başarısız:** Sunucuyu yeniden açın ve tam hatayı görmek için **Bağlantıyı Test Et**'e tıklayın. En yaygın nedenler yanlış veya süresi dolmuş bir anahtar, URL'deki bir yazım hatası veya sunucunun `Authorization` dışında bir başlık adı gerektirmesidir. - **Bir OAuth sunucusu çalışmayı durdurdu / yeniden bağlanmanızı istiyor:** OAuth oturum açma işlemleri sunucu tarafında iptal edilebilir veya süresi dolabilir. Sunucuyu açın ve tekrar oturum açmak için **Bağlan**'a tıklayın. OAuth oturum açma işlemlerinin hesaplar arasında asla kopyalanmadığını unutmayın; bu nedenle kopyalanan bir Temsilci veya kampanyanın sunucularının, kopyaladığınız hesapta yeniden bağlanması gerekir. - **Bot bir araç kullanmıyor:** Öncelikle aracın sunucunun **Araçlar** bölümünde açık olduğundan emin olun (listeyi görmek için sunucuyu düzenleyin) — kapalı bir araç bot için görünmezdir. Ardından sunucunun o belirli Temsilcide etkinleştirildiğinden ve müşterinin isteğinin aracın yaptığı işle net bir şekilde eşleştiğinden emin olun. Özel işlevlerde olduğu gibi, sunucu tarafındaki net araç adları ve açıklamaları, botun doğru seçimi yapmasına yardımcı olur. - **Sunucunun sunduğu bir araç bot için görünmüyor:** Bu sunucunun araçlarını düzenlediyseniz, düzenledikten sonra eklenen herhangi bir aracın kapalı olarak geldiğini unutmayın. Sunucuyu düzenleyin, **Araçlar** bölümünü açın ve aracı açın. - **Bağlayıcı MCP HTTP oturumlarını yönetiyor mu?** Evet. Sunucunuz bağlantı kurulduğunda bir `mcp-session-id` başlığı verirse, bunu saklarız ve `MCP-Protocol-Version` başlığıyla birlikte sonraki her istekte geri göndeririz. Durum bilgisi olan sunucular, tarafınızda herhangi bir ek yapılandırma olmadan çalışır. - **Bir araç atlandı:** Bir Temsilci aynı anda en fazla 5 sunucu ve 40 MCP aracı kullanabilir. Bir sunucu çok sayıda araç sunuyorsa, bazıları yüklenmeyebilir; sunucunun **Araçlar** bölümünde ihtiyacınız olmayan araçları kapatın veya her sunucuyu yalnızca gerçekten kullandığınız araçlara odaklayın. --- ## Plan Gereksinimleri MCP sunucuları, özel işlevlerle birlikte geliştirici araç setinin bir parçasıdır. Kenar çubuğunun AI Studio bölümünde **MCP Sunucuları**'nı görmüyorsanız, mevcut planınız bunu içermiyordur; etkinleştirmek için geliştirici araçlarını içeren bir plana yükseltin. --- ## Sonraki Adımlar - [Özel İşlevler](custom-functions.md) — tüm bir sunucuyu bağlamak yerine tek bir aracı manuel olarak yapılandırın. - [Yapay Zeka Temsilcileri](../ai-agents/ai-agents.md) — MCP sunucularının bir bot için etkinleştirildiği yer. - [Yapay Zeka Temsilcileri](../ai-agents/ai-agents.md) — MCP Sunucuları grubunun bulunduğu Yapay Zeka Stüdyosu'nun ana sayfası.