Yapay Zeka Ajanları nasıl bağlanır?
Sabah Claude'a "dün teklif verdiğimiz müşterilerden hangileri siparişe döndü?" diye sormak ya da yeni bir müşteri kartını ona açtırmak istiyorsanız, önce ajanın hesabınıza bağlanması gerekir. Yapay Zeka Ajanları ekranı bunun için bir API anahtarı üretir. Ajan; cari, stok, sipariş, teklif ve diğer ekranlardaki işleri, anahtarın bağlı olduğu kullanıcının yetkileriyle yapar. Ekranı yalnız firma yöneticisi kullanır.
Nereden açılır?
Ayarlar > Büro Tanımları > Yapay Zeka Ajanları menüsünden açılır. Menü yalnız firma yöneticisine görünür.
Başlamadan önce
- Ajan için ayrı bir kullanıcı açın: Ayarlar > Büro Tanımları > Kullanıcı Tanımları ekranında yeni kullanıcı ekleyin ve Api Kullanıcısı Mı? alanını Evet yapın. API kullanıcısı programa ekrandan giriş yapamaz.
- Bu kullanıcıya yalnız ajanın yapacağı işlerin yetkilerini verin. Ajan bu kullanıcının göremediği ekranı göremez, yetkisi olmayan kaydı ekleyemez ya da silemez.
Adım adım: anahtar nasıl üretilir?
- Yeni Anahtar düğmesine tıklayın.
- Anahtar Adı alanına anahtarı tanımanızı sağlayacak bir ad yazın (ör. "Muhasebe Claude ajanı").
- Kullanıcı listesinden ajan için açtığınız API kullanıcısını seçin.
- Geçerlilik Süresi listesinden 30, 90 ya da 365 günü seçin. Dakika Sınırı alanına ajanın bir dakikada gönderebileceği en fazla istek sayısını yazın (1-600; önerilen 60).
- Anahtar Üret'e tıklayın. Açılan pencerede anahtarı Kopyala ile alın ve güvenli bir yere kaydedin.
Aynı pencerede ajanınıza yapıştırabileceğiniz hazır metinler de görünür: Claude Code için komut, Cursor ve benzeri uygulamalar için ayar (mcp.json) ve MCP kullanmadan doğrudan servis çağrısı. Her birinin yanındaki kopyalama düğmesiyle alın.
Adım adım: ajan nasıl bağlanır?
Ekrandaki Ajanınızı nasıl bağlarsınız? kutusunda ajanın bağlanacağı adres görünür. Bu adresi ajanınıza MCP sunucusu (bağlayıcı) olarak ekleyin ve anahtarı istek başlığında gönderin.
Claude (claude.ai ya da masaüstü uygulaması):
- Claude'da Ayarlar (Settings) > Bağlayıcılar (Connectors) > Özel bağlayıcı ekle (Add custom connector)'a gidin.
- Adres alanına ekrandaki adresi yapıştırın.
- İstek başlığı (request header) olarak Authorization adını, değer olarak "Bearer " yazıp ardından anahtarınızı girin.
- Bağlayıcıyı ekleyin. Claude artık programdaki araçları kullanabilir.
Claude Code: anahtar üretildiğinde gösterilen Claude Code için komut metnini terminale yapıştırıp çalıştırın.
Cursor ve benzeri uygulamalar: Cursor ve benzeri uygulamalar için ayar (mcp.json) metnini uygulamanın MCP ayar dosyasına ekleyin.
Alanlar ve düğmeler
| Alan / düğme | Ne işe yarar |
|---|---|
| Kayıtlar | Anahtarla yapılan son istekleri gösterir: zaman, istenen işlem, sonuç, süre ve IP adresi. |
| İptal Et | Anahtarı kalıcı olarak kapatır. Ajan en geç 5 dakika içinde erişimini kaybeder. |
| Durum | Geçerli, İptal edildi ya da Süresi doldu. |
| Son Kullanım | Anahtarın son kullanıldığı zaman ve IP adresi. |
Dikkat edilecekler
Not
Anahtar yalnız üretildiği anda bir kez gösterilir. Kaybederseniz iptal edip yenisini üretin.
- Ajan kimsenin oturumunu kapatmaz; siz ve çalışanlarınız ekrandan çalışmaya devam edersiniz. API kullanıcısıyla ekrandan giriş yapılamaz.
- Ajana; silme, onay, e-belge ya da e-posta gönderme ve para hareketi gibi kritik işlemlerden önce sizden açık onay alması söylenir. Yine de ajanın yapabileceklerini asıl sınırlayan, API kullanıcısına verdiğiniz yetkilerdir.
- Bir kullanıcıya en fazla 5 geçerli anahtar verilebilir.
Sık sorulanlar
ChatGPT'ye bağlayabilir miyim?
Şu an hayır. ChatGPT, anahtarın istek başlığında gönderildiği bağlantıyı henüz desteklemiyor. Claude, Claude Code, Cursor ve VS Code ile bağlanabilirsiniz.
Kullanıcı listesi boş geliyor.
Listede yalnız aktif API kullanıcıları görünür. Kullanıcı Tanımları ekranında ajan için bir kullanıcı açıp Api Kullanıcısı Mı? alanını Evet yapın.