MCP
Calleague'i Model Context Protocol istemcilerine bağlayın — bir asistanın görüşme sırasında araçlarınızı keşfedip çağırmasına ya da Calleague yeteneklerini MCP uyumlu istemcilere açmaya izin verin.
Model Context Protocol (MCP), yapay zeka asistanlarının dış araçları tek bir ortak arayüz üzerinden keşfedip çağırmasının paylaşılan bir yoludur. Her sistem için ayrı bir bağlayıcı kurmak yerine, bir araç sağlayıcısı yeteneklerini bir kez yayımlar ve MCP uyumlu herhangi bir istemci bunları kullanabilir. Bu sayfa, MCP'nin Calleague'e nasıl uyduğunun, nasıl bağlanacağınızın ve neyi açtığının uygulama düzeyinde bir özetidir.
Bir bakışta
| Konu | Özet |
|---|---|
| Nedir | Araç çağırmak için paylaşılan, keşfedilebilir bir sözleşme. |
| İki rol | Bir sağlayıcı araçları yayımlar; bir istemci onları keşfedip çağırır. |
| Calleague tüketici olarak | Bir asistan, MCP üzerinden yayımlanan araçları görüşme sırasında çağırabilir. |
| Calleague yayıncı olarak | Calleague yetenekleri MCP uyumlu istemcilere sunulabilir. |
| Kimlik doğrulama | Bağlantılar, herhangi bir ayrıcalıklı entegrasyon gibi kapsamlandırılır ve kimliklendirilir. |
MCP nasıl uyar
MCP iki rolü ayırır:
- Sağlayıcı — bir asistanın çağırabileceği bir araç kümesi yayımlar.
- İstemci — bir sağlayıcının sunduğunu keşfeder ve bu araçları asistan adına çağırır.
Arayüz standart olduğundan, aynı araçlar farklı asistanlarda yeniden kullanılabilir ve bir asistan aynı anda birçok sağlayıcıya erişebilir. Her entegrasyon için özel bir tutkal yoktur — keşif ve çağırma her yerde aynı protokolü izler.
Calleague ve MCP
Calleague, MCP ile birbirini tamamlayan iki yönde çalışır:
| Yön | Ne anlama gelir | Şunun için kullanın… |
|---|---|---|
| Tüketme | Bir Calleague asistanı, MCP üzerinden yayımlanan araçları, görüşme sırasında başka herhangi bir aracı kullandığı gibi kullanır. | Bir asistanın çağrı sırasında sipariş arayıp bulması, stok kontrol etmesi veya talep açması için. |
| Yayma | Calleague yetenekleri, keşfedilip çağrılabilmeleri için MCP uyumlu istemcilere sunulur. | Dış bir asistanın paylaşılan bir sözleşmeyle Calleague işlemlerine erişmesi için. |
Her iki durumda da MCP, bir asistanın dış bir yeteneğe erişmesi için başka bir yoldur — araç başına özel bir entegrasyon yerine paylaşılan, keşfedilebilir bir sözleşmenin avantajıyla.
Bağlanma
Yönü belirleyin
Calleague'in bir MCP sağlayıcısını tüketeceğini mi (böylece bir asistan araçlarını çağırabilsin) yoksa Calleague'i bir MCP istemcisine yayacağını mı seçin. İkisi bağımsızdır ve aynı anda açık olabilir.
Her yönü ayrı ayrı kuracaksınız, o yüzden başlamak için birini seçin.
Bağlantıyı yapılandırın
Uygulamanın entegrasyonlar alanından MCP bağlantısını ve kullanacağı kimlik bilgisini ekleyin. Kimlik bilgisini yalnızca entegrasyonun ihtiyaç duyduğu araçlarla sınırlayın.
Kaydedildikten sonra bağlantının listelendiğini göreceksiniz.
Keşfi doğrulayın
Bağlandıktan sonra mevcut araçlar standart MCP arayüzü üzerinden keşfedilebilir olur. Canlı bir görüşmede güvenmeden önce beklediğiniz araçların gerçekten göründüğünü kontrol edin.
Sağlayıcının araç listesini göreceksiniz — ihtiyacınız olan adların orada olduğunu doğrulayın.
Bir görüşmede kullanın
Tüketirken, araçları çağırabilmesi gereken asistana iliştirin. Asistan, bir aracı ne zaman çağıracağına başka herhangi bir araçta olduğu gibi görüşmeden karar verir.
Asistanın bir aracı yalnızca görüşme gerektirdiğinde çağırdığını göreceksiniz.
MCP keşfi dinamiktir: bir sağlayıcı bir araç eklediğinde veya değiştirdiğinde, bağlı bir istemci bunu siz bağlayıcı yeniden kurmadan alabilir. Sağlayıcı kataloğunu değiştirdikten sonra araç listesini yeniden doğrulayın.
Örnek: bir asistanın çağırabileceği bir araç
MCP üzerinden açılan bir araç; adını, ne yaptığını ve beklediği girdileri tanımlar. Bir asistan, ne zaman ve nasıl çağıracağına karar vermek için bu tanımı kullanır. Örnek olarak bir çağrı şöyle görünebilir:
{
"tool": "lookup_order",
"description": "Look up an order's status by its ID",
"input": {
"orderId": "A-1042"
}
}Sağlayıcı, asistanın arayana geri okuyabileceği yapılandırılmış bir sonuç döndürür:
{
"tool": "lookup_order",
"output": {
"orderId": "A-1042",
"status": "shipped",
"eta": "2026-01-03"
}
}Bir MCP bağlantısına başka herhangi bir ayrıcalıklı entegrasyon gibi davranın: erişimini dar tutun, kimlik bilgisini kendi güvenli saklama alanınızda tutun ve müşteri verisine dokunmadan önce saklama ve onam ayarlarınızca kapsandığını doğrulayın.
MCP neyi açar
| Kavram | Açıklama |
|---|---|
| Araçlar | Bir asistanın çağırabileceği, her biri türlü bir girdiye sahip adlandırılmış, tanımlı işlemler. |
| Keşif | Bir istemci, önceden sabitlemeden bir sağlayıcının araçlarını listeleyebilir. |
| Çağırma | Asistan bir aracı adıyla ve girdilerle çağırır; sağlayıcı bir sonuç döndürür. |
| Sonuçlar | Asistanın görüşmeye geri okuyabileceği yapılandırılmış çıktı. |
İyi araçlar tasarlamak
Bir asistanın çağıracağı araçları açtığınızda, ad ve açıklama asistanın okuduğu şeyin bir parçasıdır — bir aracı çağırıp çağırmamaya yalnızca bunlardan karar verir. Birkaç ilke çağrıları isabetli tutar:
| İlke | Neden önemli |
|---|---|
| Araçları amaca göre adlandırın | Bir asistana lookup_order, dbQuery2'den daha iyi okunur. |
| Tek satırlık, belirgin bir açıklama yazın | Asistan aracı açıklamasından seçer; belirsiz metin yanlış veya kaçırılmış çağrılara yol açar. |
| Girdileri az ve türlü tutun | Daha az, iyi adlandırılmış girdi, hatalı çağrı olasılığını azaltır. |
| Derli toplu, yapılandırılmış sonuç döndürün | Asistan sonuçları arayana okur; ihtiyacı olmayanı ayıklayın. |
| Net bir mesajla başarısız olun | Açıklayıcı bir hata, asistanın takılmak yerine toparlamasını veya açıklamasını sağlar. |
Araç açıklamalarını bir asistanın okuduğu metin gibi düşünün: kısa, net ve aracı ne zaman kullanacağına odaklı. Bir asistan yanlış aracı çağırıyorsa, her şeyden önce açıklamayı keskinleştirin.
Bir şey farklı görünüyorsa
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Araçlar görünmüyor | Bağlantı kurulmadı veya kimlik bilgisi reddedildi | Bağlantıyı ve kimlik bilgisinin geçerli olduğunu yeniden kontrol edin |
| Bir araç eksik | Sağlayıcı kataloğu değişti | Sağlayıcı güncelledikten sonra keşfi yeniden doğrulayın |
| Asistan bir aracı hiç çağırmıyor | Araç iliştirilmemiş veya açıklama belirsiz | Aracı iliştirin ve açıklamasını belirgin yapın |
| Bir araç çağrısı hata döndürüyor | Kötü girdi veya çok dar kapsam | Girdileri doğrulayın; kimlik bilgisinin kapsamını gerekene genişletin |
| Hassas veri beklenmedik şekilde bir araca ulaşıyor | Kapsam çok geniş | Kimlik bilgisini daraltın ve saklama/onam ayarlarını doğrulayın |
MCP, REST ve webhook karşılaştırması
| Şunu istiyorsanız… | Kullanın |
|---|---|
| Bir asistanın görüşme sırasında dış araçları çağırmasına izin vermek | MCP (tüketme) |
| Calleague işlemlerini paylaşılan bir sözleşmeyle dış bir asistana sunmak | MCP (yayma) |
| Çağrıları ve asistanları kendi kodunuzdan tetiklemek veya aramak | REST API |
| Bir çağrı olayı olduğu anda tepki vermek | Webhook |
Sık sorulan sorular
Sırada ne var
Son güncelleme