Özel Bağlayıcılar

Chainabit ajanlarını herhangi bir hizmet veya dahili araçla entegre etmek için kendi bağlayıcılarınızı oluşturun.

Genel Bakış (Overview)

Bugün özel bağlayıcılar oluşturmanın iki yolu vardır:

1. Bir MCP sunucusu 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.

Daha gelişmiş kullanım durumları için yakında özel bir adaptör SDK'sı geliyor.

Seçenek 1: Bir MCP Sunucusu Oluşturma

Bu, özel entegrasyonlar için önerilen yaklaşımdır. Standart bir MCP sunucusu oluşturur, dağıtır ve Chainabit'e bağlarsınız.

Nasıl Çalışır

1. Model Context Protocol kullanarak araçlarınızı açığa çıkaran bir MCP sunucusu oluşturun
2. HTTP (SSE) aktarımı ile dağıtın
3. Chainabit'e mcp-generic bağlayıcısını kullanarak bağlayın (MCP rehberine bakın)
4. Chainabit, araçlarınızı sync-tools aracılığıyla otomatik olarak keşfeder

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 otomatik olarak keşfedilir — manuel kayda gerek yoktur
• Bir MCP SDK'sına sahip olan herhangi bir dille çalışır

Hızlı Örnek

İşte TypeScript ile yazılmış minimal bir MCP sunucusu:

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new McpServer({ name: "my-tools", version: "1.0.0" });

server.tool(
  "lookup_customer",
  { email: { type: "string", description: "Customer email" } },
  async ({ email }) => {
    const customer = await yourDatabase.findCustomer(email);
    return {
      content: [{ type: "text", text: JSON.stringify(customer) }],
    };
  }
);

const transport = new StdioServerTransport();
await server.connect(transport);

HTTP aktarımı için (Chainabit için gereklidir), bir HTTP/SSE adaptörü ile sarın. Ayrıntılar için MCP belgelerine bakın.

Dağıtıldıktan sonra bağlayın:

chainabit connectors install mcp-generic --name "Customer Tools"
# Sunucu URL'niz ile yapılandırın (Configure with your server URL)
chainabit connectors sync <instance-id>

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 uç noktanıza işaret eden mcp-generic bağlayıcısını yükleyin
2. HTTP uç noktalarıyla eşleşen bireysel araç tanımlarını yapılandırın
3. Her araç yürütmesi, 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.

Yakında: Özel Adaptör SDK'sı (Coming Soon: Custom Adapter SDK)

Aşağıdaki özelliklerle Chainabit içinde özel bağlayıcıları birinci sınıf adaptörler olarak tanımlamanızı sağlayacak bir SDK oluşturuyoruz:

• Bildirimsel (Declarative) araç tanımları
• Yerleşik (Built-in) kimlik bilgisi yönetimi
• OAuth akışı desteği
• Hız sınırlaması ve yeniden deneme ilkeleri
• Bağlayıcıları çalışma alanları arasında paylaşmak için bir yayınlama mekanizması

Güncellemeler için takipte kalın.

Claude (veya diğer yapay zeka istemcilerinden) Bağlanma

Chainabit'in kendisi, https://api.chainabit.com/api/v1/mcp adresinde bir MCP sunucusu barındırır. Bu, Claude Desktop, Cursor, Windsurf veya MCP uyumlu herhangi bir istemciyi, ajanlarınıza, zincirlerinize, bağlayıcılarınıza ve çalışma alanınıza erişim sağlaması için doğrudan Chainabit'e yönlendirebileceğiniz anlamına gelir.

Claude Desktop'a Nasıl Eklenir

1. Claude Desktop yapılandırmanızı açın (macOS'te ~/Library/Application Support/Claude/claude_desktop_config.json)
2. Aşağıdaki girişi ekleyin:

{
  "mcpServers": {
    "chainabit": {
      "url": "https://api.chainabit.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_CHAINABIT_API_KEY"
      }
    }
  }
}

3. Claude Desktop'ı yeniden başlatın — MCP araçlarının yüklendiğini doğrulayan bir çekiç simgesi belirecektir

Chainabit API anahtarınız, Chainabit panosundaki Ayarlar (Settings) → API Anahtarları altında oluşturulabilir.

Mevcut tüm araçlar, örnek istemler ve Cursor ile Windsurf için yapılandırmayı görmek adına kılavuzun tamamına Chainabit MCP Server sayfasından bakı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 sunucularınız veya webhook uç noktalarınız için her zaman kimlik doğrulaması talep edin.