Özel Araçlar ve MCP

Asistanlarınızı kendi sistemlerinize bağlayın. Özel Araç, asistanın konuşmanın ortasında çağırabildiği bir webhook’tur (sipariş sorgulama, destek talebi oluşturma); MCP Sunucusu ise harici araçlardan oluşan bütün bir kataloğu tek seferde kullanıma açar.

Nerede: sol menü → Araçlar (/tools) ve MCP Sunucuları (/mcp-servers).

Özel Araçlar

Araç oluşturma

Araçlar → Yeni Araç’ı açın (ya da bir OpenAPI tanımından veya cURL komutundan toplu aktarım için İçe Aktar’ı kullanın). Şunları yapılandırın:

• Araç adı — asistanın çağırdığı, küçük harfli bir fonksiyon adı (ör. create_ticket).
• Açıklama — asistana bu aracı ne zaman kullanacağını anlatır (en az 10 karakter).
• Uç Nokta — yöntem (GET/POST/…) ve bir HTTPS adresi. :id biçiminde yol parametreleri kullanabilir; {{secrets.X}}, {{call.X}}, {{metadata.X}} şablon değişkenlerini ekleyebilirsiniz.
• Parametreler — asistanın doldurduğu değerler (ad, tür, zorunluluk, açıklama, kısıtlar). Her birini yola, query dizesine ya da gövdeye eşleyin. En fazla 30 parametre.
• Başlıklar — sabit başlıklar (değerleri sırlara referans verebilir; şifrelenir, bir daha gösterilmez).
• Sabit değerler — platformun her zaman gönderdiği ama asistanın hiç görmediği değerler (sabitler ya da şablonlu veriler).
• Kimlik Doğrulama — Yok, Bearer, API anahtarı, Basic, OAuth2 istemci kimlik bilgileri veya JWT bearer.
• Yanıt Eşleme — yanıttaki alanları değişkenlere çıkarın (nokta yolu, ör. response.order.status) ya da boş bırakıp yanıtın tamamını asistana geçirin.
• Gelişmiş — zaman aşımı (1–120 sn), yeniden denemeler (0–3, üstel bekleme), Sessiz mod (yanıtı asistandan gizler) ve Çalışırken konuş (istek sürerken kısa bir dolgu cümlesi seslendirir).

URL izin listesi

Kiracınızda bir webhook izin listesi tanımlıysa, aracın host’u bu listede olmalıdır; aksi hâlde kayıt reddedilir. Hata bildirimi sizi doğrudan Allowlist’i yönet’e götürür.

Bağlamadan önce test edin

Kaydedilmemiş değişikliği olmayan mevcut bir araçta Test’i açın: örnek değerlerle gerçek bir istek gönderin ve İstek / Yanıt / Çıkarılan sekmelerini inceleyin — bir asistanda ya da akışta etkinleştirmeden önce çalıştığını doğrulayın. Yöneticiler ayrıca son gerçek çağrıları listeleyen bir Çalıştırma geçmişi sekmesi görür.

Kullanıma alın

Aracı bir asistanda etkinleştirin (Araçlar sekmesi → Özel Araçlar) ya da bir akışa Araç düğümü ekleyin.

MCP Sunucuları

Araçları tek tek tanımlamak yerine bir MCP (Model Context Protocol) sunucusu bağlarsınız; asistan o sunucunun bütün araç kataloğunu kazanır.

1. MCP Sunucuları → Yeni MCP Sunucusu.
2. Bir ad, Sunucu URL’si (HTTPS) girin ve Taşıma türünü seçin — Streamable HTTP (/mcp ile biten adresler) ya da SSE (/sse).
3. Gerekiyorsa kimlik doğrulama başlıkları ekleyin.
4. İsteğe bağlı olarak yalnızca bir alt kümeyi açmak için İzin verilen araçlar listesini doldurun (boş = tümü).
5. Kaydedin, ardından sunucuyu bir asistanda veya akışta etkinleştirin.

İpuçları

• Sırlar Sırlar bölümünde durur; araç adreslerinde, başlıklarda, sabit değerlerde ve kimlik doğrulamada {{secrets.KEY}} biçiminde referans verin.
• Bir aracı çoğaltmak sır değerlerini asla kopyalamaz — kimlik bilgilerini kopyada yeniden girin.
• Bir MCP sunucusunu silmek yerine devre dışı bırakırsanız, yapılandırmasını kaybetmeden geçici olarak asistanlardan çekmiş olursunuz.