Dokümantasyon
Sistemlerinizi bağlama (MCP)
Bu sayfada
Yalnızca konuşabilen bir asistan yararlıdır; iş yapabilen bir asistan ise bir üründür. Busymate AI, bro’nun kendi MCP sunucunuz üzerinden sizin araçlarınızı çağırmasını sağlar; böylece kullanıcılarınız adına ve belirlediğiniz kurallarla sistemlerinizde bilgi arayabilir ve değişiklik yapabilir.
MCP (Model Context Protocol), araçları bir yapay zekâya sunmak için açık bir standarttır. Sistemleriniz zaten MCP konuşuyorsa bro onlara da diğer herkese bağlandığı şekilde bağlanır; platforma özel bağlantı koduna gerek yoktur.
bro kullanıcı verilerinizde nasıl işlem yapar
Asistanın bir şey yapması gerektiğinde MCP sunucunuzdaki bir aracı çağırır. İki unsur bunu güvenli kılar:
- bro, sunucunuza kullanıcının kim olduğunu bildirir — sunucunuzun doğruladığı, kısa ömürlü ve kriptografik olarak imzalanmış bir token ile. Token sahtecilik veya yeniden oynatma için kullanılamaz; sunucunuz isteğin tam olarak hangi kullanıcıya ait olduğunu her zaman bilir.
- Sunucunuz kapsamı uygular. MCP kullanıcının kim olduğunu bildiği için yalnızca o kişinin verilerini döndürür ve değiştirir. bro, sunucunuzun verdiğinden fazlasını asla görmez.
İzin katmanları
Sunduğunuz her araca bir katman atanır; böylece asistan yalnızca istekte bulunan kişiye uygun kapsama ulaşır:
| Katman | Kimler için | Neye izin verir |
|---|---|---|
| Herkese açık | Misafirler dâhil herkes | Güvenli, kişisel olmayan okumalar — ürün bilgileri ve genel yardım. |
| Kimliği belirlenmiş | Oturum açmış kullanıcı | Yalnızca kendi verileri üzerinde okuma ve işlemler. |
| Yetki devredilmiş | Yetkilendirmesini gerektiren işlemler için oturum açmış kullanıcı | Kullanıcının açıkça yetkilendirmesini istediğiniz işlemlerde aynı kapsam. |
| Onay | İşaretlediğiniz her yazma işlemi | Çalışmadan önce kullanıcı onaylamalıdır; önce işlemin tamamı gösterilir. |
Yıkıcı veya hassas işlemler onay arkasında tutulur: bro ne yapmak üzere olduğunu tam olarak gösterir ve bir insanın “evet” demesini bekler. Hiçbir şey sessizce yazılmaz.
Kurulum
Busymate AI Konsolunuzdaki Entegrasyon bölümü bu kurulumun doğruluk kaynağıdır. Seçilen tenantın canlı yapılandırmasından üretildiği için URL’ler, kimlik değerleri, kod parçaları ve yayın listesi güncel kalır; farklılaşabilecek ayrı bir devir belgesi yoktur.
- Konsol → Entegrasyon bölümünü açın ve yapılandıracağınız tenantı seçin.
- MCP adımından Bağlantılar bölümüne gidin, sunucu URL’nizi ve kimlik bilgisi bağını ekleyip taramayı çalıştırın.
- Bulunan her aracı inceleyip Herkese açık, Kimliği belirlenmiş, Yetki devredilmiş ve Onay politikalarını bilinçli olarak atayın.
- Ön kontrolü çalıştırıp tenant revizyonunu yayınlayın. Başarısız tarama veya eksik kimlik sözleşmesi, kısmen bağlı bir asistan üretmek yerine yayını engeller.
Entegrasyon bölümü ayrıca, bir ajanın tenant kapsamındaki aynı akışı yapmasını isteyen ekipler için kopyalanabilir otomasyon talimatları ve Busymate AI yönetim MCP uç noktasını sunar. Bkz. Başlarken.
Claude Code’u yönetim MCP’sine bağlama
Tek komut; tarayıcı normal hesabınla oturum açmayı hallediyor (OAuth 2.1 — hiçbir şey yapıştırılmaz):
claude mcp add --transport http busymate-ai https://busymate.ai/mcpArdından Claude Code içinde /mcp çalıştır ve busymate-ai → Kimlik doğrula öğesini seç. Başka herhangi bir HTTP-MCP istemcisi (Claude Desktop, Cursor, …) yalnızca https://busymate.ai/mcp URL’siyle bağlanır — OAuth keşfi hem uç noktada hem de kaynakta sunulur, dolayısıyla URL dışında istemci tarafında yapılandırma gerekmez.
Kullanıcıların kendi hesaplarını bağlaması
Kullanıcı başına OAuth yetki devri beyaz etiket bağlayıcılar için kullanılabilir. Her kullanıcı sizin işletmediğiniz bir hizmetteki kendi hesabını yetkilendirmeliyse bunu kullanın. Bağlayıcının OAuth yetkilendirme, token ve iptal meta verilerini Bağlantılar bölümünde yapılandırın, ardından yetki devredilen araçlarını yayınlayın.
Yetki devredilen hesap araçları iki açık kipi destekler:
- İmzalı müşteri aktör tokenı — ürününüz ziyaretçiyi zaten doğruladıysa önerilir. Busymate AI, MCP sunucunuz için tenanta ve bağlayıcıya bağlı kısa ömürlü bir aktör tokenı üretir; hesap erişimi otomatik olur ve müşteri ikinci bir oturum açma ya da izin istemi görmez.
- Oturum açmış müşteri başına OAuth — ayrı bir yetkilendirme bilinçli olarak isteniyorsa kullanın. Asistan bir kez Hesap araçlarına yetki ver seçeneğini gösterir, PKCE ile OAuth 2.1 yetkilendirme kodu akışını kullanır ve sunucu tarafındaki yetkiyi tenanta, bağlayıcıya ve doğrulanmış son kullanıcıya bağlar.
Her iki kip de güvenli biçimde reddeder. MCP sunucunuz müşteriyi yalnızca doğrulanmış bearer’dan çıkarır ve araç bağımsız değişkenlerinde gönderilen hesap kimliğine asla güvenmez. OAuth yetkileri hesap menüsünden iptal edilebilir; imzalı aktör tokenları en fazla beş dakikada sona erer ve tek bir bağlayıcıya sabitlenir.
Sırada
- Başlarken — MCP’nizin bağlandığı yer.
- Yönetişim ve model politikası — araçları açın ve onay kurallarını belirleyin.
- Asistan deneyimi — işlemlerin kullanıcıya nasıl göründüğünü öğrenin.