Özel Bağlayıcılar

Bu kılavuz, harici bir MCP server oluşturup Chainabit'e bağlamayı veya daha basit entegrasyonlar için webhook kullanmayı anlatır. Chainabit'i bir MCP server olarak açmayı ya da NEXUS yerel MCP server kurulumunu anlatmaz.

Genel Bakış (Overview)

Dağıtımınız ve hesabınız için kullanılabilir olduğunda özel entegrasyonlar için iki yaklaşım vardır:

1. Bir MCP server oluşturun ve bunu mcp-generic bağlayıcısı üzerinden bağlayın
2. Basit istek/yanıt entegrasyonları için http_webhook araç türünü kullanın

Doğrulanmış uzak ön ayarlar için, sıfırdan özel bir yol oluşturmak yerine özel Zapier veya Context7 bağlayıcı sayfalarını tercih edin.

Seçenek 1: Bir MCP Server Oluşturma

MCP bağlayıcısı kullanılabilir olduğunda standart bir MCP server oluşturup dağıtabilir ve Chainabit'e bağlayabilirsiniz. Başlamadan önce kullanılabilirliği kontrol edin.

Nasıl Çalışır

1. Model Context Protocol kullanarak araçlarınızı açığa çıkaran bir MCP server oluşturun.
2. Genel HTTPS üzerinden Streamable HTTP (streamable-http) veya eski SSE (sse) transport ile dağıtın.
3. mcp-generic bağlayıcısıyla Chainabit'e bağlayın (MCP kılavuzuna bakın).
4. Gereken kimlik bilgilerini sakladıktan sonra araçları eşitleyin. Keşfedilen her araç varsayılan olarak onay gerektirir.

Faydaları (Benefits)

• Büyüyen bir ekosistem tarafından desteklenen standart protokol
• Araç mantığı, kimlik doğrulama ve hata işleme üzerinde tam kontrol
• Araçlar manuel kayıt olmadan keşfedilebilir.
• Bir MCP SDK'sına sahip olan herhangi bir dille çalışır

Uyumlu bir server oluşturma

Server'ınızı oluşturup yayımlamak için MCP belgelerini kullanın; ardından bağlamak için harici MCP server kılavuzunu izleyin. Yerel stdio server, Chainabit'in doğrudan bağlanabileceği bir HTTP uç noktası değildir.

Seçenek 2: HTTP Webhook (Option 2: HTTP Webhook)

Yalnızca tek bir HTTP isteği yapması ve yanıtı döndürmesi gereken basit entegrasyonlar için webhook tabanlı araçları kullanabilirsiniz.

Nasıl Çalışır

1. http_webhook türünde bir özel bağlayıcı aracı tanımlayın.
2. Aracı HTTP uç noktanızı çağıracak şekilde yapılandırın.
3. Her çalıştırma uç noktanıza bir istek gönderir ve yanıtı döndürür.

Ne Zaman Kullanılmalı

• Ajan araçları olarak açığa çıkarmak istediğiniz mevcut bir REST API'niz varsa
• Entegrasyon basitse (araç başına tek istek/yanıt)
• İki yönlü iletişime veya akışa ihtiyacınız yoksa

Örnek (Example)

Kendi API'niz https://service.example.com/api adresinde bulunuyorsa, bir bağlayıcı örneği oluşturabilir ve belirli uç noktalara eşleşen araçları yapılandırabilirsiniz.

Chainabit bir MCP server olarak

Harici bir MCP server'ı Chainabit'e bağlamak ile bir MCP istemcisini Chainabit'e bağlamak farklı akışlardır. İstemci kurulumu ve kimlik doğrulaması için Chainabit MCP server kılavuzunu kullanın.

En İyi Uygulamalar

• Araçları odaklı tutun. Her araç bir şeyi iyi yapmalıdır. Birkaç büyük araç yerine birçok küçük aracı tercih edin.
• Girdileri doğrulayın. Ajanların hangi parametrelerin beklendiğini bilmesi için net girdi şemaları tanımlayın.
• Yapılandırılmış veri döndürün. JSON yanıtları, ajanların yorumlaması ve üzerinde işlem yapması için daha kolaydır.
• Hataları zarifçe yönetin. Ajanların (ve kullanıcıların) neyin yanlış gittiğini anlamalarına yardımcı olan anlamlı hata mesajları döndürün.
• Uç noktalarınızı güvence altına alın. MCP server veya webhook uç noktanıza uygun authentication type kullanın ve araç çıktısını güvenilmeyen girdi olarak değerlendirin.