# Özel MCP sunucuları

https://docs.golubvoice.com/tr/araclar/ozel-mcp/

Özel MCP, asistanı yönettiğiniz veya kullanma yetkiniz olan uzak bir hizmetin araçlarına bağlar. Sunucuyu bağlamak, araç seçmek ve asistanı yayınlamak ayrı adımlardır. İşletme kaydını değiştiren bir işlemden önce yalnızca okuma yapan bir sorguyla başlayın.

## Sunucuyu ve erişiminizi kontrol edin

Hesap yöneticisi oturumunu ve bir Live ajanını kullanın. **Ajanlar → ilgili ajan → Yapılandırma → Özel MCP sunucuları** alanını açın.

Desteklenen bağlantı **443 portunda genel HTTPS üzerinden Streamable HTTP** kullanır. Hizmetin normal web sitesi veya REST API adresini değil, MCP uç noktasını girin. Yerel/özel ağ sunucuları, OAuth ile giriş ve diğer taşıma yöntemleri desteklenmez. Adreste sorgu dizisi, parça işareti veya gömülü kimlik bilgisi bulunmamalıdır.

Kimlik doğrulama gerektirmeyen hizmetlerde başlık eklemeyebilirsiniz. Gerekiyorsa **Başlık ekle** ile sabit HTTP başlıkları tanımlayın. Başlık adlarını ve değerlerini hizmet yöneticisinden alın. Kimlik bilgilerini yalnızca **Gizli başlık değeri** alanında tutun; talimatlara, bilgi dosyalarına, adrese veya destek örneğine yazmayın.

## Bağlayın ve araçları keşfedin

1. **Sunucu ekle** işlemini seçin.
2. Tanınabilir bir **Sunucu adı** ve **HTTPS adresi** girin.
3. Kimlik doğrulama gerekiyorsa **Başlık ekle** ile **Başlık adı** ve **Gizli başlık değeri** alanlarını doldurun. Gereken diğer desteklenen başlıklar için tekrarlayın.
4. **Keşfet ve kaydet** işlemini seçin. Bu işlem sunucuya erişip hesap bağlantısını kaydeder; asistanın araçlarını yayınlamaz.
5. Sonucu okuyun. Başarılı olduğunda **Sunucu keşfedildi. Bu temsilci için araçları seçin, ardından Kaydet ve Yayınla işlemlerini yapın.** mesajı görünür. Sunucu kartında araçlar listelenir. Boş katalogda **Bu sunucuda araç yok** mesajı gösterilir.

Kurgusal kurulumda `Atölye siparişleri` adı ve `https://mcp.example.com/orders` gibi bir adres kullanılabilir. Bu, çalışan sunucu değil bir örnektir. Kendi desteklenen adresinizi ve hizmet yöneticisinin sağladığı kimlik doğrulamasını kullanın; örnek bir gizli değere gerek yoktur.

## Araçları seçin ve yayınlayın

**Temsilcinin kullanabileceği araçlar** altında yalnızca görev için gereken araçları işaretleyin. Yeni araçlar otomatik seçilmez. **Desteklenmeyen şema** işaretli araçlar seçilemez. Asistanın bütün sunucularında toplam en fazla **16 araç** seçebilirsiniz.

Örneğin kurgusal bir sunucu `lookup_order`, `set_order_note` ve `clear_order_note` araçlarını sunar. Yalnızca sipariş durumu yanıtlayacak asistanda sadece `lookup_order` seçin. Yazma aracını, kimin talep edebileceğini ve tamamlanmayı neyin doğrulayacağını belirledikten sonra etkinleştirin. Farklı sunuculardaki aynı adlı araçlar ayrı seçimlerdir; araç adıyla birlikte sunucu kartını da kontrol edin.

**Taslağı kaydet** işlemini seçin, kayıtlı seçimi inceleyin ve hazır olduğunuzda **Yayınla** işlemini yapın. Yalnızca keşif yapmak veya kutuları işaretlemek yayınlanan asistanı değiştirmez. Kayıtlı yapılandırmayı incelemek veya geri yüklemek için [Kaydetme, yayınlama ve sürüm geçmişi](https://docs.golubvoice.com/tr/asistanlar/yayinlama/) rehberini kullanın.

```text
Seçili sipariş sorgusunu yalnızca arayanın referansını aldıktan sonra kullan.
Dönen durumu kısaca açıkla. Bulunamayan siparişi uydurma.
Araç başarısızsa sonucun doğrulanamadığını söyle.
İşletme sistemi doğrulamadan notun kaydedildiğini söyleme.
Yazma sonucu belirsizse işlemi tekrarlamadan önce kaydı kontrol et.
```

## Keşif hatalarını çözün

| Konsoldaki sonuç                                | Kontrol edilecek konu                                                                                             |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Sunucu başlıkları reddetti                      | Hizmet yöneticisine kimlik bilgilerini ve gereken başlık adlarını doğrulatın.                                     |
| Sunucu adresi engellendi / geçersiz adres       | 443 portunda, sorgu veya parça içermeyen genel HTTPS MCP adresi kullanın.                                         |
| Sunucu zamanında yanıt vermedi                  | Yeniden keşfetmeden önce adresi ve hizmetin erişilebilirliğini kontrol edin.                                      |
| Desteklenmeyen MCP kataloğu / çok büyük katalog | Hizmet yöneticisinden uyumlu, sınırları uygun bir araç kataloğu isteyin. Normal API yanıtı MCP kataloğu değildir. |
| Değişiklik doğrulanamadı                        | Yeni işlem başlatmadan önce aynı değişikliğin sonucunu **Bu işlemi yeniden dene** ile kontrol edin.               |

Sunucu listesi yüklenmiyorsa **Sunucuları yenile** işlemini kullanın. Başarısız keşfi başarılı bağlantı saymayın; başka sunucudaki benzer adlı aracı yerine seçmeyin.

## Kimlik bilgilerini veya araçları güncelleyin

**Sunucuyu düzenle** ile adı veya adresi değiştirebilirsiniz. Kayıtlı başlık değerleri gizlidir. Korumak için **Kayıtlı başlıkları değiştir** seçeneğini kapalı tutun; sadece bütün yeni başlık kümesini girecekseniz açın.

**Yeniden keşfet** güncel kataloğu kontrol eder. Yeni katalog, asistanın sabitlenmiş seçimini sessizce değiştirmez. Konsol yeni araç sürümü bildirirse **Bu araç sürümünü kullan** işlemini seçin, kalan seçimleri inceleyin, ardından **Taslağı kaydet** ve **Yayınla** işlemlerini yapın. Kaldırılmış veya desteklenmeyen araçlar seçimden çıkabilir.

**Bağlantıyı kes**, başka yayınlanmış asistanları da etkileyebilen hesap düzeyinde bir değişikliktir. Etkilenen asistan ve etkin arama uyarısını okuyun. Yeni işlemler durur; zaten gönderilmiş işler tamamlanabilir. Yeniden bağlanmadan önce etkilenen asistanlardan kesilmiş bağlantı seçimini kaldırıp düzeltilmiş yapılandırmayı yayınlayın.

## Araç sonuçlarını doğru yorumlayın

Sunucu yanıtı o sunucudan gelen bilgidir; randevu, mesaj veya başka bir işletme değişikliğinin gerçekleştiğini bağımsız olarak kanıtlamaz. **Başarısız**, **Sonuç belirsiz**, **İptal edildi** ve **Gönderilmedi** farklı sonuçlardır. Belirsiz yazmayı tekrarlamadan önce asıl kaydı inceleyin; yinelenen işlem başka bir harici etki oluşturabilir. Tamamlanma kuralları için [Araçlar ve bağlantılar](https://docs.golubvoice.com/tr/araclar/baglantilar/) rehberine bakın.