MCP Sunucuları
MCP — Model Context Protocol — AI asistanlarının harici araçları keşfetmesini ve çağırmasını sağlayan açık bir standarttır. Bir MCP uyumlu sunucu çalıştırıyorsanız (kendinizin veya birçok topluluk sunucusundan biri), Hanc.AI'ye bağlayabilirsiniz ve ajanlarınız bir çağrı başladığı anda sunucunun araçlarını alacak.
Bağlandıktan sonra, ajan konuşma sırasında o araçları çağırabilir — canlı veri çekme, hesaplamalar yapma, arka uç iş akışlarını başlatma — tıpkı yerleşik Takvim, HubSpot veya API Aracı entegrasyonları gibi.
MCP sunucuları, Free dahil tüm planlarda mevcuttur. Sunucu başına ücret yoktur — yalnızca ajanın araçları çağırırken kullandığı çağrı dakikaları için ödeme yaparsınız.
MCP Ne Zaman Kullanılır
| Senaryo | MCP'nin Neden Uygun Olduğu |
|---|---|
| Zaten bir dahili araç sunucusu çalıştırıyorsunuz | Bir bağlantı, tüm araçlarınız her ajan için kullanılabilir |
| Ajanlar arasında araçları paylaşmak istiyorsunuz | Bir kez bağlayın, istediğiniz kadar ajana ekleyin |
| Topluluk MCP sunucuları kullanıyorsunuz | Özel kod yazmadan popüler açık kaynak MCP sunucularını takın |
| Araç yüzeyiniz sık değişiyor | Ajan her çağrıda araçları yeniden keşfeder — kontrol paneline dokunmadan sunucu tarafında araç ekleyin/kaldırın |
Tek bir tek seferlik uç noktanız varsa, API Aracı daha basittir. Bir küme ilgili aracınız varsa veya zaten bir MCP sunucusu sürdürüyorsanız, bu doğru entegrasyondur.
Bir MCP Sunucusu Bağlama
1. Entegrasyonlar sayfasını açın
Kontrol paneli kenar çubuğunda Entegrasyon'a gidin. MCP sunucuları bölümüne kaydırın.
2. "MCP sunucusu bağla"ya tıklayın
Bir modal açılır. Şunları doldurun:
| Alan | Açıklama |
|---|---|
| Etiket | Bu bağlantı için kısa bir ad (örn. "Satış Araçları", "Dahili CRM"). Etiket, ajan araç seçicisinde gösterilir ve AI'ya sunulan araç adlarının önünde yer alır, bu nedenle kısa ve anlamlı tutun. |
| URL | MCP sunucunuzun HTTPS URL'si. Genel olarak erişilebilir bir adres olmalıdır — http:// ve özel/dahili adresler reddedilir. |
| Kimlik Doğrulama | Sunucunuz açıksa Yok veya bir Authorization: Bearer … başlığı bekliyorsa Bearer token. |
| Token | (Yalnızca Bearer) Kimlik doğrulama token'ınız. Şifreli olarak saklanır — yalnızca platform hesabınız kullanım için onu çözebilir. |
Kaydet'e tıklayın. Hanc.AI URL formatını doğrular ve bağlantıyı saklar. Bağlantı artık çalışma alanınızdaki her ajan için kullanılabilir.
Her MCP sunucusundan gelen araç adları bağlantı etiketiyle önek alır, bu nedenle "Shop API" olarak bağlı bir lookup_order aracı olan bir MCP sunucusu ajana Shop_API_lookup_order olarak görünecektir. Bu, benzer adlı araçlara sahip olan birden fazla MCP sunucusu bağladığınızda çakışmaları önler.
3. Düzenleme, devre dışı bırakma veya silme
MCP sunucuları listesi, eklediğiniz her bağlantının etiketini, URL'sini, kimlik doğrulama türünü ve durumunu gösterir. Şunları yapmak için satır eylemlerini kullanın:
- Düzenle — etiket, URL, kimlik doğrulama türü veya token'ı değiştirin
- Sil — bağlantıyı tamamen kaldırın
Bir bağlantıyı kaldırmak, onu eklediğiniz her ajan için devre dışı bırakır — bu ajanlar bir sonraki çağrıda araçlarına erişimi kaybeder.
Bir Ajana MCP Araçları Ekleme
Çalışma alanınızdaki bir bağlantı ajanlarınız için kullanılabilir — ancak her ajan, bağlantılarınızdan hangilerinin sunulacağına ayrı ayrı karar verir. Bu, farklı MCP sunucularından çeken ayrı Satış ve Destek ajanlarına sahip olabileceğiniz anlamına gelir.
1. Ajanın Eylemler sekmesini açın
Ajanı seçin. Eylemler sekmesini açın. Eylem Ekle'ye tıklayın.
2. Canlı çağrı grubundan "MCP sunucuları"nı seçin
Açılır menü üç grup gösterir: Önceden çek, Canlı çağrı, Çağrı sonrası. Canlı çağrı grubuna bakın — MCP sunucularının ait olduğu yer burasıdır, çünkü ajan MCP araçlarını konuşma sırasında çağırır, öncesinde veya sonrasında değil.
3. Hangi bağlantıların etkinleştirileceğini değiştirin
Modal, çalışma alanınızdaki her MCP bağlantısını her biri açma/kapatma düğmesiyle listeler. Bu ajanın kullanması gerekenleri açın. Ayrıca "Ne zaman kullanılacak" alanına kısa bir talimat yazabilirsiniz — bu, ajanın bir konuşma sırasında bu araçlara ne zaman başvuracağına karar vermek için okuduğu şeydir.
Kaydet'e tıklayın. Ajan artık etkinleştirilmiş her MCP bağlantısından gelen araçlara erişebilir.
Bir MCP bağlantısını beş ajanda etkinleştirebilir ve diğerini yalnızca birinde etkinleştirebilirsiniz — her ajanın kendi düğme setiyle kendi MCP sunucu aracı vardır.
Çağrı Zamanında Nasıl Çalışır
Bir çağrı başladığında, ajan etkinleştirilmiş MCP sunucularının her birine bağlanır ve "hangi araçları sunuyorsunuz?" diye sorar. Sunucunun döndürdüğü her şey, konuşma sırasında çağırabileceği bir araç olarak AI'ya sunulur.
Bilmeniz gereken birkaç şey:
- Araçlar çağrı başlangıcında keşfedilir. MCP sunucunuzda araç ekler veya kaldırırsanız, değişiklik bir sonraki çağrıda görünür — Hanc.AI'de hiçbir şeyi güncellemenize gerek yoktur.
- Araç adları bağlantı etiketiyle önek alır (
"Shop API"+ araçsearch_products→Shop_API_search_products). Yerleşik ajan araçları ve diğer MCP araçları çakışmaz. - Araç açıklamaları ve parametre şemaları MCP sunucunuzdan gelir. Orada iyi açıklamalar yazın — AI'nın aracı ne zaman ve nasıl çağıracağına karar vermek için kullandığı şey budur.
- Hatalar ajana geri raporlanır. Bir araç çağrısı başarısız olursa, ajan hata mesajını görür ve yeniden denemeye, özür dilemeye veya farklı bir araç denemeye karar verebilir.
MCP Sunucunuz İçin Gereksinimler
Hanc.AI ile çalışmak için sunucunuzun şunları yapması gerekir:
| Gereksinim | Detay |
|---|---|
| HTTPS | Düz http:// kabul edilmez. Gerçek bir TLS sertifikası kullanın. |
| Genel URL | URL genel bir adrese çözülmelidir — Hanc.AI özel bir ağda veya localhost'taki sunuculara ulaşamaz. |
| MCP Streamable HTTP transport | Tek bir uç nokta üzerinden mevcut MCP HTTP transport'u. Yalnızca SSE ve stdio transport'ları bu entegrasyonda desteklenmez. |
| Bearer kimlik doğrulama (isteğe bağlı) | Sunucunuz kimlik doğrulama gerektiriyorsa, standart bir Authorization: Bearer <token> başlığını kabul etmelidir. |
Kendi sunucunuzu bir güvenlik duvarının arkasında barındırıyorsanız, genel bir HTTPS uç noktasıyla bir tünel veya ters proxy üzerinden açın.
Güvenlik ve Gizlilik
Bearer token'larınız bekleme halinde şifreli olarak saklanır. Yalnızca Hanc.AI'nin çağrı altyapısı onları çözebilir ve yalnızca bir çağrı başladığında ve ajanın sunucunuza bağlanması gerektiğinde.
Araç çağrıları ajan → Hanc.AI → MCP sunucunuz → geri akar. Araç çağrısı yüklerini günlüğe kaydetmiyoruz. Sunucunuz, sizin tarafınızdan kaydetmeyi seçtiğiniz her şeyi günlüğe kaydeder.
Token'ınızı değiştirir veya döndürürseniz, kontrol panelindeki bağlantıyı düzenleyin — yeni değer bir sonraki çağrıda yürürlüğe girer.
Plan Uygunluğu
| Plan | MCP Sunucuları |
|---|---|
| Free | Mevcut |
| Starter / Pro / Business / Enterprise | Mevcut |
Bağlantı başına ücret yoktur — yalnızca ajanın araçları çağırdığı çağrı dakikaları için ödeme yaparsınız.
Sorun Giderme
"Bağlantı kaydedilemez"
- URL'nin
http://değil,https://ile başladığından emin olun. - Host'un genel olarak erişilebilir olduğundan emin olun —
localhost,127.0.0.1ve dahili adresler tasarım gereği engellenir. - Bir tane ayarladıysanız bearer token'ı tekrar kontrol edin — fazladan boşluk veya tırnak işareti kaydı bozar.
"Ajan araçları görmüyor"
- Ajanın Eylemler sekmesindeki MCP sunucusu girişinde en az bir bağlantının açık olduğunu ve girişin kaydedildiğini kontrol edin.
- MCP sunucunuzun bir tools/list isteğine yanıt verdiğinden ve etkileşimli bir kimlik doğrulama akışı gerektirmediğinden emin olun.
- Çağrının hemen başında MCP bağlantısından gelen mesajlar için ajanın çağrı kaydına bakın.
"Araç çağrı sırasında başarısız oluyor"
- Ajan, sunucunuzun döndürdüğü her hatayı görecektir. Sunucu günlüklerinizi kontrol edin.
- Uzun süre çalışan araçlar zaman aşımına uğrayabilir — ziyaretçi sessizlikte kalmaması için MCP araç yürütmesini çağrı başına birkaç saniyenin altında tutun.
"Sunucumda araçları değiştirdim ama ajan hala eski olanları kullanıyor"
- Araçlar, çağrılar arasında önbelleğe alınmaz, her çağrının başında yeniden keşfedilir. Bir sonraki yeni çağrı güncellenmiş araç setini görür. Devam eden çağrılar başlangıçta verilen araçları korur.
İlgili
- Eylemler ve Araçlar — Yerleşik araçlar ve Eylemler sekmesinin nasıl düzenlendiği
- Entegrasyonlar — Tüm mevcut entegrasyonlar
- API Tool RAG — Tek uç nokta için daha basit seçenek