Uygulamalar (MCP)

Uygulamalar, Agentbits’i MCP (Model Context Protocol) sunucularına bağlar. Bunlar Claude Desktop’tan tanıyor olabileceğin türden bağlayıcılardır: e-posta, takvim, tasarım araçları, Notion, veritabanları ve daha fazlası. Ajanlar sunucuyla hiçbir zaman doğrudan konuşmaz. Her çağrı Agentbits’ten geçer: ajanın erişimi ve aracın politikası denetlenir, gerekiyorsa sana sorulur ve çağrı denetim kaydına yazılır.

Uygulama ekle

Organizasyon → Uygulamalar’ı aç ve Uygulama ekle’ye tıkla. Dört seçenek var:

Seçenek	Ne için
Bilgisayarda çalışan (stdio)	Bilgisayarında çalışan, npx ya da uvx gibi bir komutla başlatılan sunucu.
Uzak sunucu (adres)	Bir adreste HTTP üzerinden erişilen sunucu.
JSON yapılandırması yapıştır	Bir README’den ya da başka bir uygulamadan kopyalanmış yapılandırma.
Claude Desktop’tan al	Claude Desktop’ta zaten kurduğun sunucular.

Bilgisayarda çalışan program

Ad, Ne için? (ajanlar bunu görür), Komut (ör. npx), Argümanlar (her satıra bir), isteğe bağlı Çalışma klasörü ve API anahtarları ile token’lar için Ortam değişkenleri alanlarını doldur.

Uyarı: Agentbits bu komutu bilgisayarında senin kullanıcı yetkilerinle çalıştırır ve ne yaptığını kısıtlayamaz. Yalnızca güvendiğin sunucuları ekle: resmî olanlar ya da bildiğin bir kaynaktan gelenler. Çoğu için Node.js (npx) ya da uv (uvx) kurulu olmalı; Agentbits bunları senin yerine kurmaz.

Uzak sunucu

Ad, açıklama, Sunucu adresi (ör. https://ornek.com/mcp) ve gerekiyorsa Authorization: Bearer … gibi Ek HTTP başlıkları alanlarını doldur. Agentbits Streamable HTTP kullanır; sunucu gerektirirse eski SSE yöntemine geçer.

Giriş isteyen sunucularda (barındırılan uygulamaların çoğu) Tarayıcıda OAuth ile giriş yap’ı aç, kaydet, sonra Giriş yap’a tıkla. Tarayıcında uygulamanın giriş sayfası açılır; Agentbits anahtarı bu bilgisayarda şifreli saklar. Yalnızca güvendiğin sunuculara giriş yap ve parolanı yazmadan önce açılan sayfanın beklediğin servise ait olduğunu kontrol et.

Ajanlar hiçbir zaman tarayıcı açmaz. Token yoksa ya da yenilenemiyorsa uygulama giriş gerekli durumuna geçer ve sen yeniden giriş yapana kadar ajan hata alır.

JSON yapıştır ya da Claude Desktop’tan al

JSON yapılandırması yapıştır yaygın biçimleri okur: ör. {"mcpServers": {"ad": {"command": "npx", "args": […]}}}, bir servers bloğu ya da bir README’den kopyalanmış tek bir "ad": {…} girdisi. Oku’ya tıkla, bulunan sunuculara göz at ve ekle.

Claude Desktop’tan al, Claude Desktop’ın claude_desktop_config.json dosyasını okur:

• Windows: %APPDATA%\Claude\
• macOS: ~/Library/Application Support/Claude/
• Linux: ~/.config/Claude/

Aynı adda bir uygulama zaten varsa atlanır (zaten ekli (atlanır)). Yeni uygulamalar arka planda test edilir.

Sırlar

Ortam değişkeni ve başlık değerleri ile OAuth token’ları işletim sisteminin güvenli deposuyla şifreli saklanır. Bir daha gösterilmez; düzenlerken bir değeri boş bırakırsan eski değer korunur.

Araçlar ve politikalar

Sunucuya bağlanıp araçlarını yüklemek için Bağlan ve araçları listele’ye tıkla. Uygulamanın yanındaki durum bağlı, hata, denenmedi, kapalı ya da giriş gerekli olur.

Araçlar sekmesinde her aracın bir Politika’sı vardır:

Politika	Ne yapar
Otomatik çalışır	Erişimi olan ajanlar sormadan çağırır.
Önce bana sor	Her çağrı senin onayını bekler.
Kapalı	Ajanlar aracı hiç görmez.

Varsayılan olarak sunucunun salt-okunur (ve yıkıcı değil) olarak işaretlediği araçlar otomatik çalışır, diğer her şey Önce bana sor’dadır. Bu ipuçlarını Agentbits değil sunucunun kendisi bildirir; onları bir beyan olarak gör. Bir araçtan emin değilsen Önce bana sor’da tut.

Uygulamayı kimler kullanabilir

Varsayılan olarak kimsenin erişimi yoktur. Erişimi uygulamanın Erişim sekmesinden ver (Hepsine izin ver ve Hiçbirine kısayoldur) ya da Organizasyon → Ajanlar altında ajanın sayfasındaki Uygulamalar bölümünden. Erişimi olan ajan, uygulamanın Kapalı olmayan tüm araçlarını her birinin politikasıyla kullanabilir.

Kullanımda anahtarı uygulamanın tamamını kapatır: kapalıyken hiçbir ajan onu kullanamaz.

Onaylar

Bir ajan Önce bana sor politikalı bir aracı çağırdığında istek, aracın argümanlarıyla birlikte sol alttaki onay paneline (Onay gerekiyor başlığıyla) düşer; ayrıca bir bildirim (toast) gelir. Onayla ya da reddet. 10 dakika içinde yanıt vermezsen reddedilir. İstek beklerken ajan erişimini kaybederse ya da uygulama veya ajan değiştirilir ya da silinirse istek reddedilir. Onay verdikten sonra da çağrı çalışmadan önce Agentbits ajanın hâlâ erişimi olduğunu ve aracın Kapalı olmadığını yeniden denetler.

Denetim kaydı

Uygulamanın Denetim kaydı sekmesi her ajan çağrısını (araç, sonuç ve süre) ve senin değişikliklerini kaydeder: uygulama eklendi, değişti ya da silindi, araç politikası ve erişim değişiklikleri. Bir uygulamayı silmek denetim kaydındaki satırlarını silmez.

Sağlayıcılar

Sağlayıcı	Uygulama desteği
Anthropic API, OpenAI API	Var, yerel araç çağrısı olarak.
Claude Code CLI	Var, Agentbits’in kendi MCP köprüsü üzerinden.
Codex CLI	Var, aynı köprü üzerinden, uygulaması olan ajanlarda.
Demo	Görevde adı geçen bir uygulamanın aracını dener; görev bir değişiklik istiyorsa onay ister.

Agentbits, Claude Code’u çalıştırırken projenin kendi .mcp.json dosyasını yok sayar; böylece bir depo ajana kendi sunucularını veremez. Claude Code ve Codex CLI’da uygulama desteği şimdiye kadar yalnızca benzetilmiş CLI’larla test edildi, gerçekleriyle değil. Bkz. Sağlayıcılar.

Sınırlar

• Yalnızca MCP araçları desteklenir. Kaynaklar (resources), istemler (prompts), sampling ve elicitation planlı.
• OAuth girişi yalnızca bir başvuru test sunucusuyla denendi; Notion ya da Linear gibi gerçek servislerle henüz denenmedi. Önceden kayıtlı bir istemci kimliği (client ID) isteyen servisler desteklenmez.
• Uygulama sonuçları modele güvenilmeyen veri olarak işaretlenmiş şekilde gider, ama bu prompt enjeksiyonuna karşı bir garanti değildir: ör. bir e-posta gövdesi talimat içerebilir. Bir şeyi değiştiren araçları Önce bana sor’da tut.

Ayrıca bkz. İzinler ve Güvenlik.