Tüm Ürünler
Search

Bu Ürün

    STAROps:MCP hizmeti yapılandırması

    Belge Merkezi

    STAROps:MCP hizmeti yapılandırması

    Son Güncelleme:Oct 09, 2026

    Bu konu, Digital Employee için MCP (Model Context Protocol) hizmetlerinin nasıl ekleneceğini ve yapılandırılacağını açıklar. Bu sayede Digital Employee harici sistemlere ve veri kaynaklarına erişebilir.

    MCP hizmeti nedir

    MCP (Model Context Protocol), Digital Employee'yi harici sistemler ve veri kaynaklarıyla bağlamak için kullanılan açık standart bir protokoldür. MCP hizmetleri sayesinde Digital Employee; veritabanları, API'ler, cloud hizmetleri ve diğer harici kaynaklara güvenli bir şekilde erişerek sorguları çalıştırabilir, işlemleri yapabilir ve görevleri otomatize edebilir.

    Özellikler


    Özellik


    Açıklama


    Standartlaştırılmış arayüz


    Açık bir protokole dayalıdır ve farklı sistemlerde birleşik bir erişim yöntemi sağlar.


    Araç çağrısı


    Digital Employee, işlemleri yapmak üzere MCP hizmetleri tarafından sunulan araçları doğrudan çağırabilir.


    Güvenlik kontrolü


    Araç düzeyinde izin yönetimi ve yürütme modu yapılandırmasını destekler.


    Gerçek zamanlı etkileşim


    En güncel verileri almak için harici sistemlerle gerçek zamanlı iletişim kurar.

    Kavramlar


    Terim


    Açıklama


    MCP hizmeti


    MCP protokolünü uygulayan ve çağrılabilir bir dizi araç sağlayan sunucu tarafı programdır.


    MCP aracı


    Bir MCP hizmeti tarafından sunulan belirli bir işlevdir; örneğin veri sorgulama veya işlem yürütme.


    AI Gateway


    MCP hizmeti isteklerini yöneten ve yönlendiren, güvenlik ve trafik kontrolü sağlayan ara katmandır.


    Function Compute (FC)


    MCP hizmetlerini dağıtmak için kullanılabilecek Alibaba Cloud sunucusuz bilgi işlem hizmetidir.


    Model Studio


    Yönetilen MCP araç hizmetleri sağlayan Alibaba Cloud büyük dil modeli hizmet platformudur.


    Yürütme modu


    Bir araç çağrıldığında kullanılan onay mekanizmasıdır. Otomatik yürütme ve Her çağrıdan önce sor seçeneklerini içerir.

    MCP hizmetlerinin çalışma şekli

    MCP hizmetleri istemci-sunucu mimarisini kullanır:

    1. Hizmet kaydı: Bir MCP hizmeti dağıtıldıktan sonra kullanılabilir araçlar AI Gateway, Function Compute veya özel bir MCP uç noktası aracılığıyla kaydedilir.

    2. Araç keşfi: Digital Employee, yapılandırılmış hizmet uç noktasından kullanılabilir araçların listesini alır.

    3. Araç çağrısı: Digital Employee, kullanıcı isteğine göre uygun aracı seçer ve çağırır.

    4. Sonucun döndürülmesi: MCP hizmeti işlemi yürütür ve sonucu Digital Employee'ye döndürür.

    Önkoşullar

    • En az bir Digital Employee oluşturulmuş olmalıdır.

    • Bir MCP hizmeti dağıtılmış ve çalışıyor olmalıdır. MCP hizmeti aşağıdaki ortamlara dağıtılabilir:

      • Genel internet üzerinden erişilebilen bir sunucu

      • Alibaba Cloud VPC içindeki bir ECS örneği veya ACK kümesi (VPC modu gerektirir)

      • Function Compute (FC)

      • Model Studio yönetilen MCP araçları

    • VPC modunu kullanıyorsanız aşağıdaki ağ bilgilerini hazırlayın:

      • MCP hizmetinin bulunduğu VPC kimliği

      • MCP hizmetinin özel IP adresi ve dinleme bağlantı noktası

    Not

    Doğrudan mod için MCP hizmeti uç noktasının genel olarak erişilebilir olması gerekir. VPC modu, özel ECS veya ACK ortamları için uygundur. Sistem ters erişim tüneli oluşturur veya yeniden kullanır ancak kullanılabilirlik alanı kaynak kısıtlamalarına tabidir. Ağ ortamınıza göre uygun erişim modunu seçin.

    MCP hizmeti ekleme

    Süreç dört adımdan oluşur: ağ modunu seçin → hizmet adresini girin → araç listesini alın → çağrılabilir araçları seçin.

    STAROps iki ağ modunu destekler:


    Ağ modu


    Kullanım durumu


    Kullanılabilirlik alanı kısıtlaması


    Yapılandırma karmaşıklığı


    Doğrudan mod


    Zaten doğrudan erişilebilen uç noktalar; örneğin genel MCP hizmetleri, Function Compute ve Model Studio MCP


    Yok


    Düşük


    VPC modu


    MCP hizmetinin bir VPC içinde dağıtıldığı özel ECS veya ACK ortamları


    Desteklenen kullanılabilirlik alanlarıyla sınırlıdır


    Orta

    Doğrudan mod

    Doğrudan mod, genel olarak erişilebilir bir uç noktaya sahip kendi barındırdığınız bir MCP sunucunuz olduğu senaryolar için uygundur.

    1. STAROps konsolu oturum açın.

    2. Sol gezinme bölmesinde tıklayın.

    3. Digital Employee listesinde hedef Digital Employee'yi tıklayarak ayrıntılar sayfasına gidin.

    4. MCP Service sekmesini tıklayın ve ardından Add MCP Service seçeneğini tıklayın.

    5. Temel bilgileri girin.


      Parametre


      Gerekli


      Açıklama


      Hizmet adı


      Evet


      Bu MCP hizmetini kaydetmek ve görüntülemek için kullanılır. Oluşturulduktan sonra düzenlenemez.


      Görüntüleme adı


      Hayır


      Görüntüleme amaçlı kullanılır. Hizmet adından farklı olabilir. Boş bırakılırsa hizmet adı kullanılır.


      Hizmet açıklaması


      Hayır


      Bu hizmetin yeteneklerini açıklar. MCP hizmeti ayrıntılarında görüntülenir.

    6. Network mode altında Direct mode seçeneğini seçin.

    7. Hizmet adresini ve protokolü yapılandırın.


      Parametre


      Gerekli


      Açıklama


      Erişim uç noktası


      Evet


      Tam MCP uç noktasını girin; örneğin http://8.136.*.*:8080/mcp. Erişim uç noktası genel olarak erişilebilir bir URL olmalıdır.


      İletişim protokolü


      Evet


      HTTP veya SSE seçin. HTTP genellikle /mcp yolunu, SSE ise genellikle /sse yolunu kullanır. Protokol sunucu tarafı uygulamasıyla eşleşmelidir.


      Kimlik doğrulama


      Hayır


      Varsayılan olarak kimlik doğrulama yoktur. MCP hizmeti kimlik doğrulama gerektiriyorsa Token seçeneğini belirleyin ve parolayı girin.

    8. Get Tool List seçeneğini tıklayın. Araç listesinin doğru olduğunu onayladıktan sonra her araç için yürütme modunu yapılandırın. Ayrıntılar için bkz. Yürütme modu.

    9. Add Now seçeneğini tıklayın.

    VPC modu

    VPC modu, özel ECS veya ACK ortamları için uygundur. Sistem, STAROps'tan VPC içindeki MCP hizmetlerine bağlantı kurmak için ters erişim tüneli oluşturur veya yeniden kullanır.

    1. STAROps konsolu oturum açın.

    2. Sol gezinme bölmesinde tıklayın.

    3. Digital Employee listesinde hedef Digital Employee'yi tıklayarak ayrıntılar sayfasına gidin.

    4. MCP Service sekmesini tıklayın ve ardından Add Service seçeneğini tıklayın.

    5. Temel bilgileri girin.


      Parametre


      Gerekli


      Açıklama


      Hizmet adı


      Evet


      Bu MCP hizmetini kaydetmek ve görüntülemek için kullanılır. Oluşturulduktan sonra düzenlenemez.


      Görüntüleme adı


      Hayır


      Görüntüleme amaçlı kullanılır. Hizmet adından farklı olabilir. Boş bırakılırsa hizmet adı kullanılır.


      Hizmet açıklaması


      Hayır


      Bu hizmetin yeteneklerini açıklar. MCP hizmeti ayrıntılarında görüntülenir.

    6. Network mode altında VPC mode seçeneğini seçin.

    7. Ağ bilgilerini yapılandırın.


      Parametre


      Gerekli


      Açıklama


      VPC


      Evet


      Önce bölgeyi seçin, ardından MCP hizmetinin bulunduğu o bölgedeki VPC'yi seçin. Sistem ters erişim tüneli oluşturur veya yeniden kullanır. Desteklenen bölgeler için aşağıdaki tabloya bakın.


      vSwitch kullanılabilirlik alanı


      Evet


      Hedef bölgedeki vSwitch kullanılabilirlik alanını seçin. Bir VPC seçtikten sonra sistem o bölge için desteklenen kullanılabilirlik alanlarını otomatik olarak listeler. Seçilen kullanılabilirlik alanı, STAROps'tan VPC'deki MCP hizmetine erişim tünelini kurmak için kullanılır. vSwitch'in MCP hizmetiyle aynı kullanılabilirlik alanında olması gerekmez.


      vSwitch


      Evet


      Belirtilen kullanılabilirlik alanındaki bir vSwitch'i seçin. vSwitch, STAROps'tan VPC içindeki MCP hizmetine erişim yolunu oluşturur.

      VPC modu için desteklenen bölgeler ve kullanılabilirlik alanları

      VPC modu şu anda yalnızca seçili bölgelerde kullanılabilir. Aşağıdaki tabloda her bölge için desteklenen kullanılabilirlik alanları listelenmiştir.


      Bölge


      Bölge Kimliği


      Desteklenen kullanılabilirlik alanları


      Çin (Pekin)


      cn-beijing


      cn-beijing-g, cn-beijing-h


      Çin (Hangzhou)


      cn-hangzhou


      cn-hangzhou-j, cn-hangzhou-k


      Çin (Şanghay)


      cn-shanghai


      cn-shanghai-b, cn-shanghai-g


      Çin (Shenzhen)


      cn-shenzhen


      cn-shenzhen-e, cn-shenzhen-f


      Çin (Zhangjiakou)


      cn-zhangjiakou


      cn-zhangjiakou-a, cn-zhangjiakou-b


      Çin (Ulanqab)


      cn-wulanchabu


      cn-wulanchabu-a, cn-wulanchabu-b


      Singapur


      ap-southeast-1


      ap-southeast-1a, ap-southeast-1b


      Çin (Hong Kong)


      cn-hongkong


      cn-hongkong-b, cn-hongkong-c


      Japonya (Tokyo)


      ap-northeast-1


      ap-northeast-1a, ap-northeast-1b


      Şanghay Finansal Bulut


      cn-shanghai-finance-1


      cn-shanghai-finance-1f, cn-shanghai-finance-1k


      Tayland (Bangkok)


      ap-southeast-7


      ap-southeast-7a, ap-southeast-7b


      Çin (Chengdu)


      cn-chengdu


      cn-chengdu-a, cn-chengdu-b


      BAE (Dubai)


      me-east-1


      me-east-1a, me-east-1b


      Şanghay Cloud Box


      cn-shanghai-cloudspe


      cn-shanghai-cloudspe-a, cn-shanghai-cloudspe-b


      Meksika


      na-south-1


      na-south-1a


      Çin (Heyuan)


      cn-heyuan


      cn-heyuan-a, cn-heyuan-b


      Almanya (Frankfurt)


      eu-central-1


      eu-central-1a, eu-central-1b


      Shenzhen Finansal Bulut


      cn-shenzhen-finance-1


      cn-shenzhen-finance-1d, cn-shenzhen-finance-1e


      Filipinler (Manila)


      ap-southeast-6


      ap-southeast-6a


      Çin (Guangzhou)


      cn-guangzhou


      cn-guangzhou-a, cn-guangzhou-b


      Güney Kore (Seul)


      ap-northeast-2


      ap-northeast-2a, ap-northeast-2b


      Çin Kuzey 2 Ali Gov Cloud 1


      cn-north-2-gov-1


      cn-north-2-gov-1c, cn-north-2-gov-1d


      Hangzhou Finansal Bulut


      cn-hangzhou-finance


      cn-hangzhou-finance-i, cn-hangzhou-finance-j


      Çin (Hohhot)


      cn-huhehaote


      cn-huhehaote-a, cn-huhehaote-b


      Endonezya (Cakarta)


      ap-southeast-5


      ap-southeast-5a, ap-southeast-5b


      Pekin Finansal Bulut


      cn-beijing-finance-1


      cn-beijing-finance-1k, cn-beijing-finance-1l


      Çin (Wuhan - Yerel Bölge)


      cn-wuhan-lr


      cn-wuhan-lr-a


      Çin (Zhongwei)


      cn-zhongwei


      cn-zhongwei-a


      Birleşik Krallık (Londra)


      eu-west-1


      eu-west-1a, eu-west-1b


      Çin (Qingdao)


      cn-qingdao


      cn-qingdao-b, cn-qingdao-c


      Malezya (Johor)


      ap-southeast-8


      ap-southeast-8a


      Malezya (Kuala Lumpur)


      ap-southeast-3


      ap-southeast-3a, ap-southeast-3b
      Önemli

      VPC modu, VPC'nizde ters erişim tüneli oluşturmayı gerektirir. Bu işlem kullanılabilirlik alanı kaynak kısıtlamalarına tabidir. Seçilen kullanılabilirlik alanında kaynak yetersizse oluşturma işlemi başarısız olur. Yapılandırmadan önce hedef kullanılabilirlik alanındaki kaynak kullanılabilirliğini onaylamanızı öneririz.

    8. Hizmet adresini ve protokolü yapılandırın.


      Parametre


      Gerekli


      Açıklama


      Erişim adresi


      Evet


      ECS veya ACK ortamı içinde erişilebilen MCP hizmetinin özel IP adresini girin. Genel IP adresi gerekmez.


      Erişim bağlantı noktası


      Evet


      MCP hizmetinin dinleme bağlantı noktasını girin; örneğin 8080.


      Erişim uç noktası


      Evet


      Tam MCP uç noktasını girin; örneğin http://10.0.1.23:8080/mcp. Adres ve bağlantı noktası yukarıda girilen değerlerle eşleşmelidir.


      İletişim protokolü


      Evet


      HTTP veya SSE seçin. Protokol sunucu tarafı uygulamasıyla eşleşmelidir.
      Not

      Buraya girilen adres VPC özel IP adresidir; örneğin özel bir SLB IP adresi veya Pod IP'si. Genel IP adresi girmeyin.

    9. Get Tool List seçeneğini tıklayın. Araç listesinin doğru olduğunu onayladıktan sonra her araç için yürütme modunu yapılandırın. OK seçeneğini tıklayın.

    Yürütme modu

    Bir MCP hizmeti ekledikten sonra sistem hizmet tarafından sağlanan araç listesini otomatik olarak alır. Digital Employee aracı çağırdığında onay mekanizmasını kontrol etmek için her araç için bir yürütme modu yapılandırmanız gerekir. Her MCP aracı aşağıdaki iki yürütme modunu destekler:


    Yürütme modu


    Açıklama


    Uygulanabilir senaryolar


    Otomatik yürütme


    Digital Employee, kullanıcı onayı gerektirmeden aracı otomatik olarak çağırır.


    Düşük riskli okuma işlemleri; örneğin izleme ölçümlerini sorgulama veya günlükleri okuma.


    Her çağrıdan önce sor


    Her araç çağrısından önce kullanıcı onayı gerekir.


    Yüksek riskli yazma işlemleri; örneğin bir örneği yeniden başlatma veya yapılandırmayı değiştirme.

    Digital Employee'nin istenmeyen etkilere neden olabilecek değişiklikleri otomatik olarak yürütmesini önlemek için tüm yazma işlemleri (oluşturma, değiştirme, silme) için Her çağrıdan önce sor modunu yapılandırmanızı öneririz.

    SSS

    MCP hizmeti eklerken bağlantı zaman aşımı

    1. MCP hizmeti adres formatının doğru olduğunu ve tam protokol, IP adresi veya alan adı, bağlantı noktası ile yolu içerdiğini doğrulayın (örneğin, http://xx.xx.xx.xx:8080/mcp).

    2. MCP hizmetinin çalıştığını ve bağlantı noktasının normal şekilde dinlediğini onaylayın.

    3. Doğrudan mod kullanıyorsanız genel uç noktanın erişilebilir olup olmadığını kontrol edin:

      curl -X POST http://<MCP service address>/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}},"id":1}'

Responses: {"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-03-26","capabilities":{"tools":{}},"serverInfo":{"name":"k8s-mcp","version":"0.1.0"}}}

    4. VPC modu kullanıyorsanız VPC, vSwitch ve güvenlik grubu yapılandırmalarının doğru olduğunu ve güvenlik grubu giden kurallarının MCP hizmeti bağlantı noktasındaki trafiğe izin verdiğini doğrulayın.

    Araç listesi boş veya araç senkronizasyonu başarısız

    Araç listesi MCP sunucusundaki araç kayıt bilgilerine bağlıdır. Liste boşsa veya eksikse aşağıdakileri deneyin:

    1. MCP sunucusunun araçları doğru şekilde kaydettiğini ve hizmetin çalıştığını onaylayın.

    2. Manuel yenilemeyi tetiklemek için Get Tool List seçeneğini tıklayın.

    MCP hizmeti durumu kullanılamıyor olarak gösteriliyor

    Kullanılamayan bir MCP hizmeti durumu genellikle aşağıdaki nedenlerden biriyle oluşur:

    • Sunucu işlemi beklenmedik şekilde sonlandı veya başlamadı. MCP hizmetinin çalışma durumunu kontrol edin.

    • Sertifika süresi dolmuş veya kimlik doğrulama hatası var. HTTPS uç noktası kullanıyorsanız TLS sertifikasının geçerli olduğunu doğrulayın.

    • Function Compute soğuk başlatma zaman aşımı. Function Compute üzerinde dağıtılan MCP hizmetleri ilk çağrıda zaman aşımına uğrayabilir. Normal çalışmaya devam etmek için yeniden deneyin.