Araçlar ve entegrasyonlar

Agent'lar dış dünyaya dört katman üzerinden erişir. Agent'a hepsi tek tip "araç çağırma" olarak görünür, fark nerede çalıştıkları ve ne kurulum gerektirdikleridir.

#1. Yerleşik araçlar (54 araç)

Orbi'nin kendi içinde çalışan araçlardır ve hiçbir kurulum gerektirmezler.

Grup	Araçlar
Görev yaşam döngüsü	create_task update_task delete_task list_tasks read_task
Atama ve durum	assign_task change_task_state move_task_to_project
Checklist ve yorum	add_checklist_item add_comment
Koleksiyon ve şema	create_collection read_collection list_collections add_collection_field
Kayıt işlemleri	write_record read_record update_record delete_record search_records
Dosya ve artifact	read_file write_file update_file delete_file list_files save_file_from_url attach_file move_to_folder
Zihin modeli	read_mind_model write_mind_model edit_mind_model
Akış	create_flow update_flow delete_flow list_flows
Takvim	create_calendar_event update_calendar_event delete_calendar_event list_calendar_events
Arama ve yardım	search_workspace read_help
Hafıza	save_memory recall_memory open_memory update_memory delete_memory
Kanal	post_to_channel
Nabız	get_workspace_pulse, yani "son bakışımdan beri ne oldu, şu an ne tıkalı" raporu
İzleme	watch_topic: yönetici Orbi'ye "şunu takip et" deyince dışarıda izlenen konuyu açar ya da durdurur; list_watch_topics listeyi gösterir
Bağlam	list_projects list_agents read_agent_config resolve_mention get_current_time

Bu listenin anlamı şudur. Bir agent Orbi'nin içinde sizin yapabildiğiniz hemen her şeyi yapabilir, yani görev açar, atar, koleksiyon tasarlar, kayıt yazar, dosya üretir ve takvime etkinlik koyar.

En-az-yetki geçerlidir. Orchestrator tüm araçları görür. Doğrudan atanmış agent'lar ve alt-agent'lar daraltılmış bir set alır. Bir içerik yazarı agent'ının akış silmeye erişimi yoktur.

#Workspace'te arama

Agent, geçmişte yapılmış işleri search_workspace ile bulur ve siz de aynı aramayı / tuşuna basarak açtığınız kutudan yaparsınız (bir yazı kutusuna odaklanmışken çalışmaz, orada / yalnızca bir karakterdir). İkisi aynı sonucu döndürür.

Aranan yerler şunlardır.

Kaynak	Ne bulunur
Görevler	Başlık ve açıklama
Teslimatlar	Agent'ın "Çıktılar" bölümüne yazdığı her şey
Yorumlar	Görev üzerindeki tartışma
Dosyalar	Dosya adı, etiketler ve içinden çıkarılmış metin (PDF, Word, Excel)

Sohbetler aranmaz, çünkü kişisel yazışma sayıldıkları için indekslenmezler.

Kelimeyi tam yazmanız gerekmez. Arama üç şekilde birden çalışır.

• Kelimenin başı yeter. "Mimar" yazınca "mimari" geçenler, "rapor" yazınca "raporları" geçenler de çıkar, çünkü Türkçede ekler sona geldiği için kökü yazmanız yetiyor.
• Anlam benzerliği çalışır. "Geçen ay hangi müşterilerle konuştuk" gibi bir cümle de sonuç verir ve kelimelerin birebir geçmesi gerekmez.
• Birebir eşleşme de çalışır. Bir kod, isim veya tam ifade ararken bu devreye girer.

Sonuç satırında "anlamca" etiketi varsa o sonuç kelime eşleşmesiyle değil, konu benzerliğiyle bulunmuştur.

Sıralamada başlık eşleşmesi gövdeden ağır basar ve aynı görevden en fazla iki sonuç gösterilir, böylece tek bir görev listeyi kaplamaz.

Agent tarafında asıl faydası şudur. Bir işe başlamadan önce "bu daha önce yapılmış mı, ne karar verilmişti" diye bakabilir. Bu olmadan her görev sıfırdan başlar.

Yeni kurulumda arama indeksi, özellik açıldıktan sonra oluşan içerikle beslenir. Daha eski görevler ilk aramalarda çıkmayabilir ve her yeni yorum, kayıt ve dosya indekse girdikçe liste dolar. Kendi kurulumunuzu yönetiyorsanız geçmiş içeriği tek seferde indekslemenin bir yolu vardır ve kurulum dokümanında anlatılıyor.

#Agent Orbi'yi tanır

Agent'ın elinde bu Yardım Merkezi'nin kendisi de vardır: read_help aracı sayfaları dizin, sayfa, bölüm ya da arama olarak okur. "Orbi şunu yapabilir mi", "bunu nereden yaparım" gibi bir soruda ve "yapamam" demeden önce agent buraya bakar, cevabı sayfadan verir ve sayfanın adresini söyler ("Ayarlar › Paylaşım, bkz. /docs/sharing"). Bir özelliğin agent'ın araç listesinde olmaması üründe olmadığı anlamına gelmez; kaynak bu sayfalardır. Dışarıdan bağlanan agent'lar aynı aracı Orbi MCP üzerinden görür.

#2. Kurulumsuz web erişimi

Her workspace'e otomatik bağlıdır ve hiçbir anahtar veya kurulum gerekmez. İki araç vardır.

Araç	Ne yapar
web_search	Web araması yapar. En fazla 8 sonuç döner ve gün, hafta, ay ya da yıl zaman filtresi vardır.
fetch_web_page	Bir sayfayı (JavaScript ile oluşan içerik dahil) temiz metne çevirir.

fetch_web_page çıktısı dilimlenir. Varsayılan 12.000 karakter, en fazla 30.000 karakterdir, böylece uzun bir sayfa bağlamı doldurmaz ve agent gerektiği kadar ilerler.

#3. Konektör kataloğu

Ekiplerin en sık kullandığı servisler tek tıkla bağlanır ve MCP sunucusu aramanız gerekmez. Hiçbir konektör zorunlu değildir.

Ayarlar → Entegrasyonlar ekranında bağladığınız hesaplar alt alta listelenir. Her satır bir hesaptır: o hesabın açtığı servisler satırda küçük etiketler halinde, kaç aracı olduğu ise sağında yazar. Bir Google hesabı Gmail'i, Takvim'i ve Meet'i birlikte açtığı için üç ayrı yerde değil, tek satırda durur. Satıra tıklayınca hesabın paneli açılır; orada hesabı yeniden bağlar, aynı servisten ikinci bir hesap ekler, bağlantıyı kaldırır ve Orbi'nin o hesapla neler yapabildiğini madde madde okursunuz.

Yeni bir servis eklemek için "Konektör ekle" düğmesiyle katalog panelini açın. Servis adına ya da yapmak istediğiniz işe göre arayabilirsiniz, örneğin "takvim" yazınca Google Calendar çıkar, çünkü arama araç adlarını da tarar.

Konektör	Agent ne yapabilir
Gmail	Gelen kutusunda arama, e-posta okuma ve gönderme
Google Calendar	Etkinlik listeleme ve yeni etkinlik oluşturma
Google Meet	Biten toplantıları listeleme ve toplantının transkriptini okuma
Outlook	Posta kutusunda arama, e-posta okuma ve gönderme, takvimde etkinlik listeleme ve oluşturma
Microsoft Teams	Takım ve kanal listeleme, kanal mesajlarını okuma ve kanala mesaj gönderme
Slack	Kanal listeleme, mesaj okuma ve Orbi adına mesaj gönderme
Telegram	Botunuzun bulunduğu sohbetlere mesaj gönderme ve bir sohbetin bilgisini okuma
Jira	JQL ile issue arama, okuma, oluşturma ve yorum ekleme
Confluence	Sayfa arama, okuma ve yeni sayfa oluşturma
HubSpot	Kişi arama ve ekleme, satış fırsatlarını görme, bir kişiye veya fırsata not düşme
Zoom	Yaklaşan ve geçmiş toplantıları görme, toplantı planlama, biten toplantının kaydına ulaşma
GitHub	Pull request listeleme, bir PR'ı ve değişen dosyalarını okuma, diff'ini okuma, incelemelerini ve satır içi yorumlarını listeleme. Yalnızca okur
Zapier	Bir olayı, kurduğunuz "Catch Hook" Zap'ına gönderme (tek yön, Orbi → Zapier)

Bilmeniz gerekenler şunlardır.

• Bağlamak Admin yetkisi ister, kullanmak istemez. Bir konektör bağlandıktan sonra herkes görevlerde ve sohbette kullanabilir. Bağlı değilse katalogda "Admin'den iste" görürsünüz.
• Bağlantı hesap bazlıdır. "Google'a bağlan" bir kez yapılır ve Gmail, Calendar ile Meet aynı bağlantıyı paylaşır. Microsoft'ta da öyledir, tek bağlantı Outlook ve Teams'i birlikte açar (iş ve okul hesapları da kişisel Microsoft hesapları da bağlanabilir). Aynı servisten birden çok hesap da bağlanabilir; her hesap listede kendi satırında, adresiyle ya da site adıyla durur.
• Bir hesabı kaldırmak o hesaptan beslenen bütün servisleri kapatır. Google hesabını kaldırdığınızda Gmail de Takvim de Meet de kapanır. Orbi kaldırmadan önce neyin etkileneceğini söyler.
• Slack mesajları "Orbi" uygulaması adına gider ve bot yalnızca davet edildiği kanalları okuyup oraya yazabilir (/invite @Orbi).
• Servisin ücretini siz ödersiniz. Bağladığınız hesap sizin hesabınızdır ve Orbi araya girip bir kullanım payı almaz. Bu, kataloğun tamamı için geçerlidir.
• Telegram'da bot sizindir. Diğer servislerin aksine bir hesap yetkilendirmesi yoktur. Telegram'da @BotFather'a yazıp /newbot ile kendi botunuzu oluşturur, size verdiği jetonu Orbi'deki pencereye yapıştırırsınız. Sonra botu mesajlarını okumasını istediğiniz gruba ya da kanala eklersiniz. Gruplarda bot varsayılan olarak yalnızca kendisine yazılan komutları görür; bütün mesajları görmesini istiyorsanız BotFather'da o bot için gizlilik kipini kapatın. Telegram'a giden mesajlar düz metindir, yani kalın yazı ve liste işaretleri görünmez.
• Zapier'da bir hesap yetkilendirmesi yoktur. Zapier'da "Webhooks by Zapier → Catch Hook" ile başlayan bir Zap kurar, o adımın verdiği webhook adresini Orbi'deki pencereye yapıştırırsınız. Bu adres bir sırdır (bilen herkes Zap'ı tetikleyebilir), o yüzden şifreli saklanır. Bağlantı tek yönlüdür: agent zapier_send_event ile bir olay ve isterse birkaç değer gönderir, Zapier geriye bir şey döndürmez. Zapier'ın kişisel jetonuyla kurulan zengin MCP tarifi ayrıdır ve katalogda kalır — biri Orbi'nin Zapier'ı tetiklediği, diğeri agent'ın Zapier'ın aksiyonlarını çağırdığı yerdir.
• Google Meet transkripti ancak toplantıda açıksa oluşur. Transkript Google Workspace özelliğidir ve toplantı sırasında açılmış olması gerekir; kapalıysa Orbi okuyacak bir şey bulamaz ve bunu açıkça söyler. Transkript toplantı biter bitmez değil, birkaç dakika sonra hazır olur. Meet kartı Google bağlantısına yeni bir yetki ekledi: Google'ı bu özellikten önce bağladıysanız bir kez yeniden bağlanmanız gerekir.
• Zoom kaydı bulmak için toplantının bulut kaydı açık olmalıdır. Kapalıysa Orbi kaydı bulamaz ve bunu açıkça söyler. Verilen bağlantılar Zoom'da oynatma sayfasını açar ve doğrudan indirme bağlantısı değildir.
• GitHub bir hesap yetkilendirmesi değil, bir kurulumdur. "GitHub'a bağlan" dediğinizde GitHub'ın kurulum sayfası açılır, Orbi uygulamasını hangi depolar için kuracağınızı seçersiniz ve geri dönersiniz. Uygulama yalnızca okur: Orbi kod göndermez, dal açmaz, PR açmaz. Kurulu depolarda başlığı ya da dal adı bir karta referans veren (@task.12 ya da orbi/task-12) her pull request o karta bağlanır ve kartta durumu görünür; PR açıklaması taranmaz. Ayrıntı Görevler sayfasında. PR olayları akış da başlatabilir; bkz. Akışlar. Hesabın panelinde hangi depoların dinlendiği yazar; "düzenle" ile kurulumdaki depolardan istediklerinizi işaretlersiniz. Hiçbirini işaretlemezseniz kurulumdaki bütün depolar dinlenir. Aynı GitHub organizasyonunu iki ayrı workspace'te bağladıysanız depo seçmeniz gerekir: kurulum organizasyon başına tektir ve depo seçilmezse aynı pull request iki panoya birden düşer. Orbi bu durumu aynı panelde uyarır.
• Erişim tokenleri şifreli saklanır ve kendiliğinden yenilenir. Yetki iptal edilirse hesabın satırı "yeniden bağlan" uyarısına düşer ve düğmesi orada durur; o sırada agent'lar bağlantıyı görmez, yani sessizce yanlış davranmaz.
• Hangi agent'ın hangi konektörü kullanabileceği, MCP'lerle aynı erişim listesinden yönetilir. Orchestrator hepsini otomatik görür, diğer agent'lara açıkça verirsiniz.
• Koşu adımlarında servisin logosu görünür. Bir agent Gmail'e ya da Jira'ya dokunduğunda, koşu zaman çizelgesindeki o adımın yanında ilgili servisin işareti durur, yani satırı okumadan hangi sisteme temas edildiğini görürsünüz.
• Gönderilen e-postalar biçimli gider. Agent'lar metni Markdown yazar ve Orbi bunu göndermeden önce HTML'e çevirir, böylece alıcı başlıkları, listeleri ve tabloları düzgün görür. Düz metin okuyan istemciler için özgün metin de aynı e-postada taşınır.

#Zoom: uygulamayı ekleme, kullanma ve kaldırma

Bu bölüm, Zoom App Marketplace'teki Orbi uygulamasının rehberidir.

Ekleme. Bir Admin Ayarlar → Entegrasyonlar ekranında "Konektör ekle" düğmesine basar ve Zoom'u seçer. Zoom'un izin sayfası açılır; Zoom hesabınızla girip uygulamaya izin verirsiniz. Ardından Orbi'ye dönersiniz ve Zoom satırında Zoom e-posta adresiniz görünür. Orbi yalnız dört izin ister: kendi profilinizi okumak (satırı adlandırmak için), toplantılarınızı listelemek, sizin adınıza toplantı kurmak ve toplantılarınızın kayıtlarını okumak. Başka birinin hesabında işlem yapmaz.

Kullanma. Agent'lar Zoom'a görevlerden ve sohbetten ulaşır. Orchestrator bağlantıyı otomatik görür; diğer agent'lara MCP'lerle aynı erişim listesinden izin verirsiniz. Sonra "bu haftaki toplantılarımı listele", "yarın 10:00'a 30 dakikalık bir görüşme kur" ya da "dünkü değerlendirmenin kaydını gönder" gibi isteklerde bulunabilirsiniz. Toplantı listesi her toplantının katılım bağlantısını da verir. Toplantılar UTC olarak ve saat dilimi belirtilerek kurulur, bu yüzden kaymaz. Kayıt yalnız toplantı sırasında bulut kaydı açıksa bulunur ve bağlantı Zoom'daki oynatma sayfasını açar.

Orbi neyi saklar. Şifreli saklanan erişim tokenlerini ve satırı adlandıran e-posta adresini. Toplantı listeleri ve kayıtlar Orbi'ye kopyalanmaz. Bir agent'ın okuduğu, diğer adımlar gibi yalnız o görevin geçmişinde kalır.

Kaldırma. İki yolu var, biri yeterlidir.

• Orbi'de Ayarlar → Entegrasyonlar ekranında Zoom satırını açıp bağlantıyı kaldırırsınız. Agent'lara verilmiş Zoom erişimi de silinir; yalnız Zoom hesabını değiştirecekseniz Yeniden bağlan'ı kullanın, erişimler korunur. Tokenler silinir.
• Zoom'da App Marketplace'i açıp Manage → Added Apps altından Orbi'yi kaldırırsınız. Zoom Orbi'ye haber verir, Orbi de o Zoom kullanıcısının yetki verdiği her bağlantıdan tokenleri ve hesap bilgisini siler. Satır, onu kullanan akışlar ve agent izinleri kopmasın diye "yeniden bağlan" uyarısıyla kalır; artık gerekmiyorsa Orbi'den de kaldırın.

#4. Kendi MCP sunucularınız

MCP (Model Context Protocol), agent'ların dış servislere bağlandığı standarttır. Notion, bir CRM, kendi iç API'niz veya bir görsel ya da video üretim servisi bağlayabilirsiniz.

#Hazır tarifler

MCP ekle düğmesi önce bir liste açar ve sık kullanılan servislerin adresi ile bağlanma biçimi orada hazır durur. Liste kartlar halinde, her kartta servisin logosu ve tek cümlelik açıklaması görünür; liste en yaygın kullanılan servislerden başlar. GitHub, Notion, Linear, Stripe, Zapier, GitLab, Cloudflare, Supabase, PayPal, Airtable, monday.com, ClickUp, Todoist, Calendly, Mailchimp, Sentry, Netlify, Webflow, Wix, Miro, Lucid, Postman, Datadog, Grafana Cloud, Neon, Prisma Postgres, PostHog, Mixpanel, Amplitude, Klaviyo, Algolia, Sanity, Cloudinary, Upstash, Railway, Replicate, Higgsfield, OpenRouter, Hugging Face, Tavily, Exa, Context7, DeepWiki, Resend, WorkOS, Honeycomb, incident.io, Attio, Close, Pipedrive, Apollo.io, Clay, Vibe Prospecting, Paddle, Brex, Mercury, Razorpay, Buildkite, Fireflies, Granola, Otter.ai, Superhuman, Readwise, Ramp, Vanta, Mercado Pago, ThoughtSpot, Hex, Morningstar, CoinDesk, Similarweb, Apify, SearchAPI, Stytch, InstantDB, Dodo Payments, Jam, Globalping, Egnyte, Workable, Bitly, Jotform, Mintlify, Turkish Airlines, AWS Knowledge, Microsoft Learn, MDN Web Docs, Twilio Docs, Cloudflare Docs, Astro Docs, Mermaid Chart, Wolfram, CoinGecko ve Short.io bu listededir. Aradığınız servisi yazıp seçtiğinizde ad, adres ve bağlanma biçimi kendiliğinden dolar ve size yalnızca hesabınızı bağlamak kalır. Bazı servisler yalnızca kendi onayladıkları uygulamalardan bağlantı kabul eder. Böyle bir servis listede yer almaz ve adresini elle girseniz de yetkilendirme adımında sizi geri çevirir.

Her satırda servisin nasıl bağlandığı da yazar. Servis hesapla bağlanır (bir kez izin verirsiniz), anahtar ister (servisin panelinden bir anahtar üretip yapıştırırsınız) ya da kimlik istemez. Anahtar isteyen servislerde anahtarın üretileceği sayfanın bağlantısı da formun içindedir.

Bazı servislerde bağlanmadan önce servisin kendi tarafında bir ayar açmanız gerekir. Böyle bir ön koşul varsa ekleme ekranında tarifin altında yazar. GitLab bunun örneğidir: hesabınızda GitLab Duo, beta özellikler ve MCP sunucusuna erişim açık değilse yetkilendirme sorunsuz geçer ama araç listesi "sunucu bu adreste MCP sunmuyor" hatası verir. Bu hata Orbi'de değil, servisin ayarlarında çözülür.

Listede olmayan bir sunucuyu her zaman elle ekleyebilirsiniz. Listenin altındaki "Listede yok — adresi elle gireceğim" seçeneği eski akışı açar. Liste bir kısayoldur ve bağlanabileceğiniz servislerin tamamı değildir.

#Bağlanma biçimi

Sunucunun istediğine göre üç seçenek vardır ve ekleme ekranında seçersiniz.

Biçim	Ne zaman	Nasıl
Kimliksiz	Sunucu sır istemiyor	Sadece adres
Başlık	Sunucu sabit bir anahtar istiyor	Başlık adı (Authorization) + değer (Bearer …)
OAuth	Sunucu "Sign in with…" akışı istiyor (Notion, Linear…)	"OAuth ile bağlan" işaretlenir, sonra bir kez yetkilendirilir

OAuth'ta bağlantı önce "yetki bekliyor" olarak eklenir. Yetkilendir düğmesiyle sağlayıcıya gider, izin verir ve geri dönersiniz. Token'lar sonrasında kendiliğinden yenilenir ve tekrar giriş yapmanız gerekmez. Yetki iptal edilirse veya süresi dolarsa bağlantı yine "yetki bekliyor"a düşer ve agent'lar o araçları görmez.

Girdiğiniz anahtarlar şifreli saklanır, hiçbir ekranda geri gösterilmez ve agent'ın gördüğü metne hiç girmez.

#Kapsam: workspace mi, kişisel mi?

Kapsam	Kim ekler	Kimin koşularında çalışır
Workspace-geneli	Admin	Workspace'teki herkesin koşularında
Kişisel	Her üye kendisi	Yalnızca o üyenin başlattığı koşularda

Kişisel kapsam, kendi Gmail'ini veya parayla aldığı bir servisi bağlayan kişinin hesabını ekibe açmamasını sağlar. Garanti gerçektir. Kişisel bir bağlantı bir agent'a atanamaz (sistem reddeder) ve Orbi'nin "tüm workspace bağlantılarını görür" istisnası kişisel kapsama uygulanmaz. Başka bir üye aynı agent'ı çalıştırdığında sizin bağlantınız yüklenmez, Orbi çalıştırıyor olsa bile.

#Hangi alanlarda kullanılır?

Workspace bağlantısı varsayılan olarak Genel'de ve bütün açık alanlarda kullanılır. Bağlantının Kullanılabileceği alanlar bölümünde Yalnız seçilen alanlar'ı seçerseniz yalnız işaretlediğiniz alanların koşuları, kanalları ve akış tetikleri onu kullanır. Bu bölüm konektörlerde hesabın panelinde, kendi MCP sunucularınızda bağlantının düzenleme penceresinde durur ve Alanları kaydet ile ayrı kaydedilir.

Kapalı bir alan bağlantıyı iki seçenekte de ancak işaretlenirse kullanır ve onu yalnız o alanın yöneticisi işaretleyebilir. Alanın yöneticisi aynı seçimi Alan ayarları → Bağlantılar'dan da yapar. Üyesi olmadığınız kapalı alanlar listede çıkmaz; onların seçimi siz kaydettiğinizde de yerinde kalır. Kapalı bir alanı bir bağlantıya açmak Denetim sekmesine yazılır.

#Kişisel bağlantı nerede çalışır, nerede çalışmaz?

Kural tek cümledir. Koşuyu kimin başlattığı kayıtlıysa çalışır, değilse çalışmaz.

Koşuyu başlatan	Kişisel bağlantı
Sohbette siz yazdınız	✅ çalışır
Bir göreve @agent yorumu yazdınız	✅ çalışır
Görevi siz Kuyruğa aldınız	✅ çalışır
Başka bir üye aynı görevi kuyruğa aldı	❌ onun bağlantıları geçerli, sizinkiler değil
Bir agent görev açıp kuyruğa aldı	❌ kimlik yok
Zamanlanmış görev (cron)	⚠️ yalnızca aşağıdaki iki koşul sağlanırsa

Alt-agent çağrıları kimliği miras alır, genişletmez, yani bir agent başka bir agent'ı çağırdığında yetki büyümez.

Zamanlanmış görevlerde iki koşul birden gerekir.

1. Bağlantıyı eklerken "Zamanlanmış görevlerde de kullanılsın" işaretlenmiş olmalıdır (varsayılan kapalıdır, çünkü sohbette olan biteni görürsünüz, gece 3'te görmezsiniz).
2. Zamanlamayı en son düzenleyen onu oluşturan kişi olmalıdır. Başka bir üye prompt'u değiştirdiyse kişisel bağlantılar düşer ve koşu yalnızca workspace araçlarıyla devam eder. Bu, "başkasının yazdığı talimatın sizin hesabınızla çalışması"nı engeller.

"Şimdi çalıştır" ayrıdır. O an düğmeye basan sizsiniz, dolayısıyla gözetimli sayılır ve kişisel bağlantılarınız çalışır.

#Bağlantıyı eklemek yetmez: agent'a erişim vermelisiniz

Bu, en sık karşılaşılan takılma noktasıdır.

• Orbi (Orchestrator) workspace'e bağlı tüm MCP'leri otomatik kullanır.
• Diğer agent'lar en-az-yetki ilkesiyle çalışır, yani bir agent yalnızca kendisine açıkça verilen bağlantıları görür.

Erişimi Agent'lar sayfasında agent'ın detayındaki "Bağlantı erişimi" bölümünden işaretlersiniz. Hiçbiri işaretli değilse o agent hiçbir external MCP aracını göremez ve form bunu açıkça söyler.

Çalışma alanına bir bağlantı eklediğinizde Orbi hemen "Bu bağlantıyı hangi agent'lar kullansın?" diye sorar. Listede hiçbir agent işaretli gelmez. İşaretlediğiniz agent'lar erişimi alır, "Şimdi değil" derseniz erişimi sonra agent sayfasından verirsiniz.

Bağlantıyı kaldırmak ona verilmiş bütün agent erişimlerini de siler ve aynı servisi yeniden eklemek bu erişimleri geri getirmez; yeni bağlantı için aynı soru yeniden gelir. Yalnız hesabı değiştirmek ya da süresi dolan yetkiyi yenilemek istiyorsanız kaldırmak yerine konektörde Yeniden bağlan'ı, kendi MCP sunucunuzda Yetkiyi yenile'yi ya da Bağlantı ayarları'nı kullanın. Bu yollarda agent erişimleri korunur.

Erişimi olmayan bir agent'tan bu servisle bir iş isterseniz agent servisin çalışma alanında bağlı olduğunu ama kendisine açık olmadığını söyler ve erişimin agent sayfasının Çalışma sekmesinden açıldığını hatırlatır.

Neden otomatik olmadığına gelince, bir CRM'e yazabilen ya da e-posta gönderebilen bir araç yalnızca o işi yapan agent'ın elinde daha isabetli çalışır. Hangi agent'ın neye dokunabileceğini siz belirlersiniz.

#Hangi araçların açılacağını siz seçersiniz

Bazı sunucular 80'den fazla araç yayar. Hepsini açmak iki sorun yaratır. Her koşunun maliyeti artar ve model doğru aracı seçmekte zorlanır. Dahası bir sunucu, o agent'ın işiyle ilgisi olmayan araçlar da yayabilir ve listeyi daraltmak agent'ı kendi işine odaklar.

Bağlı sunucular Ayarlar → Entegrasyonlar ekranında alt alta listelenir; satırda sunucunun adı, adresi ve kaç aracının seçili olduğu yazar. Satıra tıklayınca sunucunun paneli açılır: sunucunun yaydığı araçlar orada tek tek durur (adına tıklayınca açıklaması açılır), yetkilendirme, ayarlar ve silme de aynı yerdedir. Panelden açılan Bağlantı ayarları → Açılacak araçlar bölümünden hangilerinin agent'lara görüneceğini işaretlersiniz. Hiçbiri seçili değilse hepsi açıktır; sunucu kaç araç yayarsa yaysın hiçbiri listeden düşmez.

Araçları çok olan bir bağlantı agent'ın listesine baştan girmez. Agent bağlantının adını ve kullanabileceği bütün araçların adını kısa açıklamasıyla görür, işin gerektirdiği araçları adıyla seçip tek seferde yükler ve onlar o çalışma boyunca açık kalır. Bir seferde en fazla 40 araç yüklenir; gerekirse agent ikinci kez yükler. Agent bir aracı yükleyemezse sebebini söyler: araç ona verilmemiştir, bağlantıda kapatılmıştır ya da sunucuda öyle bir araç yoktur. Küçük bağlantılar (birkaç araçlı bir takvim ya da posta bağlantısı) ve Orbi'nin kendi web araçları her zaman doğrudan açıktır. Kullanılmayan bağlantıların bedeli ödenmez.

#Bağlantıyı ve aracını anmak

Sohbette, kartta, yorumda, akış adımında ya da agent prompt'unda bir bağlantıyı adıyla anabilirsiniz. "@tool." yazınca öneri listesinde önce bağlantılar logosu ve araç sayısıyla çıkar; birini seçince @tool.design gibi bir işaret eklenir. Agent o işte bu bağlantıyı kullanacağını anlar ve gereken araçları kendisi seçer. "@tool.design." yazınca yalnız o bağlantının araçları listelenir; birini seçerseniz @tool.design.post_create eklenir ve araç, agent'ın listesine çalışmanın başından girer.

Anmak zorunlu değildir. Anmadığınız işte agent uygun bağlantıyı ve aracı kendisi bulur. Sohbette iki bağlantı aynı işi yapabiliyorsa size hangisini kullanacağını sorar; kart ve akış çalışmalarında soru sormaz, uygun araç yoksa gerçek sebebi yazar.

Konektörlerin ve kendi sunucularınızın araçları yerleşik araçlarla aynı listede görünür. Araç seçimi yaptıysanız yalnızca seçtikleriniz önerilir. Liste kısadır ve her kaynağa pay ayırır. Araç adının yanında ürünün ya da bağlantının adı yazar; arama ikisine birden bakar, yani "google" yazarak Google Takvim araçlarını (adları gcal_ ile başlar) bulabilirsiniz. Yeni eklenmiş ve henüz hiç kullanılmamış bir sunucunun araçları listede görünmeyebilir, bağlantının araç listesini bir kez açmanız yeter. Adını biliyorsanız elle de yazabilirsiniz, referans yine çalışır.

#Uzun süren işler (görsel/video üretimi)

Görsel ve video üreten servisler genelde işi kuyruğa alır. Araç size anında bir iş kimliği döner ve içerik birkaç saniye ya da dakika sonra hazır olur. Agent bunu bilir, yani iş kimliği aldığında ilgili durum aracıyla sonucu sorar ve hazır olunca dosya olarak kaydeder.

Servis ilerleme bildirmiyorsa ve iş uzunsa (video 1-3 dakika sürebilir), Ayarlar → Araç çağrısı zaman aşımı değerini yükseltin. Varsayılan 60 saniyedir ve en fazla 600 saniye olabilir.

Bağlantı kurarken tek seferlik bir güven bilgisi gösterilir. Bir MCP sunucusu agent'a araç verir ve o araçların ne yaptığı sunucunun sorumluluğundadır. Yalnızca güvendiğiniz sunucuları bağlayın.

#MCP ile dosya/medya üretimi

Bir MCP aracı dosya döndürebilir, örneğin üretilmiş bir görsel, bir video ya da bir belge gelebilir. Bu içerik otomatik olarak bir artifact'a dönüşür ve Dosya Yöneticisi'nde belirir.

Önemli olan kısım şudur. Dönen içerik agent'ın bağlamına ham olarak girmez. Doğrudan depoya yazılır ve agent'a "şu dosya oluştu" bilgisi verilir. Aksi halde tek bir video, bir bağlamın tamamını tüketirdi.

Sonuç olarak agent'ların videoyu anlaması gerekmez, üretmesi ve doğru yere koyması yeterlidir.

Uzun süren üretim işleri için (video üretimi dakikalar alabilir) araç çağrısı ilerleme bildirdiği sürece beklenir ve zaman aşımı ilerlemeyle birlikte tazelenir.

#Güvenlik korumaları

Dört katmanın hepsi aynı korumaların altındadır.

• İç ağ koruması (SSRF). Web araçları iç ağ, localhost veya bulut metadata adreslerine yönlendirilemez. Kontrol, adres çözümlendikten sonra yapılır, bu yüzden dışarıdan masum görünen ama içeriyi işaret eden bir adres de engellenir. Aynı koruma save_file_from_url için de geçerlidir.
• Dış içerik ayrımı. Web sayfası, okunan dosya veya gelen tetikleyici gövdesi gibi dışarıdan gelen her içerik agent'a veri olarak etiketlenip sunulur. Böylece agent'ın davranışını her zaman sizin verdiğiniz görev tanımı belirler.
• Otonomi sınırı. Yürütme sırasında onay istenmez, ama her görevde bütçe tavanı vardır ve agent'ın araç erişimi baştan daraltılmıştır. Ayrıntı: Orchestrator.

#Otonomi notu

Task ve akış yürütmesinde runtime onay mekanizması yoktur, tıpkı bir insan çalışanın her adımda onay istememesi gibi. Denge şu üç şeyle kurulur.

1. Agent'ın araç erişiminin baştan kısıtlanması (en-az-yetki)
2. External MCP bağlarken güven bilgisi ve bilinçli tercih
3. Review aşamasındaki insan denetimi