MCP Server Connector

MCP Server Connector, yapılandırılmış bir MCP Server üzerinde tek bir aracı çağırır ve aracın sonucunu akışa döndürür.

Service Description

MCP Server Connector, bir entegrasyon akışı içinde bir adım olarak yerleştirilir. Akış düğüme ulaştığında, connector hangi aracın çağrılacağını çözümler, araç argümanlarını mesajdan okur, seçili MCP Server'ı yapılandırılmış taşıma katmanı (STDIO veya Streamable HTTP) üzerinden çağırır ve mesaj gövdesini aracın sonucuyla değiştirir. Kimlik doğrulama, izleme ve hata yönetimi platform tarafından sağlanır — düğüm yalnızca hangi sunucu, hangi araç ve nasıl yeniden deneneceği bilgisini bildirir.

Required Connector Properties

• MCP Server: Çağrılacak MCP Server tanımı. Operations → MCP Servers altında tanımlanmış mevcut bir sunucuyu seçin. Sunucu kimliği üzerinden referans alınır, dolayısıyla sunucunun yeniden adlandırılması akışı bozmaz.

• Tool: Seçili sunucuda çalıştırılacak araç. Liste sunucunun araçlarından gelir (önce sunucuda Refresh Tools çalıştırın). Belirli bir araç seçin veya sunucunun Default Tool değerini kullanmak için (Use server default) seçeneğinde bırakın. İkisi de ayarlı değilse adım bir hatayla başarısız olur.

• Max Retries: Araç çağrısı başarısız olursa yapılacak ek deneme sayısı. 0, yeniden deneme yapılmadan tek bir deneme anlamına gelir.

• Retry Delay (ms): Yeniden deneme girişimleri arasındaki gecikme (milisaniye cinsinden).

Configuration Details

Selecting the Tool

• Sunucu birkaç araç sunuyorsa ve bu adım her zaman bunlardan birini çağırıyorsa belirli bir araç seçin. Açılır liste, sunucunun keşfedilen araçlarından doldurulur.
• Sunucunun Default Tool değerine bırakmak için aracı boş bırakın. Bu, araç adı sunucu tanımında merkezi olarak yönetildiğinde akışı kararlı tutar.
• Aracın input schema değeri (MCP Server üzerindeki View Tools üzerinden görülebilir) aracın beklediği argümanları tanımlar.

Providing Tool Arguments

Araç argümanları, düğüme ulaşan mesajdan alınır. Bunları mesaj gövdesi olarak — yapılandırılmış bir map veya bir JSON nesnesi olarak — aracın input schema'sıyla eşleşecek şekilde sağlayın. Gelen mesaj zaten eşleşmiyorsa argüman yükünü oluşturmak için önceki bir Mapping veya Set Context adımı kullanın.

Retry Behaviour

• Max Retries ve Retry Delay (ms), çağrının geçici hatalarına (örneğin geçici olarak erişilemeyen bir sunucu) uygulanır.
• Çağrıyı bir kez denemek için her ikisini de 0 değerinde bırakın. Kısa süreli erişilemez olabilecek sunucular için bunları artırın.

Message Flow

1. Akış MCP Server düğümüne ulaşır.
2. Connector hedef aracı çözümler (düğümün aracı, yoksa sunucunun Default Tool değeri).
3. Araç argümanları mesaj gövdesinden okunur.
4. Connector, yapılandırılmış taşıma katmanı ve kimlik doğrulamayı kullanarak MCP Server'a bağlanır.
5. Seçili araç, argümanlarla çağrılır.
6. Başarılı olduğunda, araç sonucu mesaj gövdesine yerleştirilir ve sonraki adıma aktarılır.
7. Başarısız olduğunda, çağrı Max Retries / Retry Delay değerlerine göre yeniden denenir; yine de başarısız olursa akışın hata yönetimi devreye girer.

Authentication

Connector kendi kimlik bilgilerini tanımlamaz. Kimlik doğrulama, tamamen seçili MCP Server tanımından alınır (None, Bearer, API Key, Basic, OAuth2 veya Client Certificate); burada kimlik bilgisi Credentials sayfasından çözümlenir ve bağlantıya enjekte edilir. Kimlik doğrulama seçenekleri için MCP Servers sayfasına bakın.

Best Practices

1. Önce yenileyin: Aracı bağlamadan önce, araç listesi ve şemaları hazır olsun diye her zaman sunucuda Refresh Tools çalıştırın ve bir Connected durumu olduğunu doğrulayın.
2. Default Tool tercih edin: Tek araçlı sunucular için bir Default Tool ayarlayın ve akışları dayanıklı tutmak için düğümün Tool alanını boş bırakın.
3. Argümanları yukarı akışta şekillendirin: Aracın input schema'sıyla eşleşen bir Mapping veya Set Context adımıyla aracın argüman yükünü oluşturun.
4. Yeniden denemeleri bilinçli kullanın: Yeniden denemeleri yalnızca geçici olarak erişilemez olabilecek sunucular için etkinleştirin; hızlı başarısız olan, idempotency açısından hassas çağrılar için 0 değerinde tutun.
5. Tanımları yeniden kullanın: Sunucu yapılandırmasını çoğaltmak yerine, merkezi olarak yönetilen bir MCP Server'ı akışlar arasında referans alın.

Usage

MCP Server Connector'ı, bir süreç adımlarından biri olarak bir AI değerlendirmesine veya araç destekli bir işleme ihtiyaç duyduğunda kullanın — örneğin gelen bir belgeyi zenginleştirip sınıflandırmak ve ardından sonucu entegrasyonun geri kalanına yönlendirmek için. AI/araç çağrısı, akışın diğer connector'larıyla aynı yetkilendirme, izleme ve hata yönetimi disiplini altında çalışır.

Error Handling

Yaygın hatalar ve çözümleri:

• No tool resolved: Ne bir düğüm Tool değeri ne de bir sunucu Default Tool değeri ayarlı. Düğümde bir araç seçin veya sunucuda bir Default Tool ayarlayın.
• Server not Connected: Sunucuya bağlantı başarısız oldu. MCP Server'ı açın, son bağlantı hatasını kontrol edin, yapılandırmayı veya kimlik bilgisini düzeltin ve Refresh Tools çalıştırın.
• Authentication error: MCP Server tanımındaki Authentication Type değerini ve başvurulan kimlik bilgisini doğrulayın.
• Invalid arguments: Mesaj gövdesi aracın input schema'sıyla eşleşmiyor. Yukarı akıştaki mapping'i düzeltin.
• Server disabled: Devre dışı bırakılmış bir MCP Server çağrılamaz. Operations sayfasından etkinleştirin.

Integration Example

MCP Server Connector kullanan tipik bir akış:

1. Receiver / Start: Gelen mesajı alır (örneğin bir sevkiyat bildirimi).
2. Mapping / Set Context: Aracın input schema'sıyla eşleşen argüman yükünü oluşturur.
3. MCP Server Connector: Aracı çağırır ve sonucunu akışa döndürür.
4. Condition: Akışı araç sonucuna göre yönlendirir.
5. Application / Technology Connector: Sonucu kalıcılaştırır veya iletir (örneğin bir ERP'ye) ve ilgili sistemleri bilgilendirir.