Model Context Protocol (MCP) ile Asistan Entegrasyonu
Botonom agent’larına asistanınızdan erişin; seçtiğiniz çalışmaların durumunu MCP Events ile takip edin.
Bu rehberde sırasıyla MCP entegrasyonu ne sağlar?, Bağlantı Kurulumu, Onayladığınız İzinler, Asistanın Gördüğü Araçlar (Tools) ve İş bitince haber alın konularını ele alıyoruz.
MCP entegrasyonu ne sağlar?
Botonom, yapay zekâ asistanlarının dış araçlarla konuşmasını sağlayan açık Model Context Protocol (MCP) standardını destekler. Çalışma alanınızı bağladığınızda asistanınız şirket agent'larınızla doğrudan doğal dilde çalışabilir:
- "Operasyon agent'ıma stok bekleyen siparişlerin listesini sor."
- "Destek agent'ı bu sabah gelen şikâyet için bir taslak yanıt hazırlasın."
- "Dünkü finans ve mutabakat raporunda öne çıkan riskler neler?"
Agent kendi karakteri, şirket kuralları ve atanmış yetenekleriyle yanıt verir. Davranışında hiçbir şey değişmez; sadece agent'ınıza çalıştığınız asistan üzerinden ulaşırsınız.
Uzak HTTP sunucularını ve Botonom OAuth akışını destekleyen bir MCP istemcisi kullanın. Araçların kullanılabilirliği istemciye bağlıdır; otomatik bildirimler ayrıca MCP Events desteği gerektirir. Abonelikten otomatik bildirime uzanan akış ChatGPT Work üzerinde doğrulanmıştır.
POST /v1/agents/command motoruna doğrudan asistanınızdan kod yazmadan erişmenizi sağlar. Bir asistanı yönlendirmek yerine kendi yazılımınızı entegre ediyorsanız REST API daha uygundur.Bağlantı Kurulumu
MCP sunucu URL'i tüm istemciler için standarttır:
https://mcp.botonom.com/mcp
Claude Code:
claude mcp add --transport http botonom https://mcp.botonom.com/mcp
Claude Desktop, Web, ChatGPT, Copilot, Gemini, Windsurf: Asistanınızın entegrasyon veya MCP ayarlarını açın, özel bir MCP sunucusu eklemeyi seçin ve yukarıdaki URL'i girin.
Cursor: Settings → MCP → Add new server bölümüne gidin ve HTTP protokolüyle bu URL'i tanımlayın.
Ardından tarayıcınızda bir Botonom onay penceresi açılır; oturum açıp hangi çalışma alanına erişileceğini seçersiniz ve izinleri onaylarsınız. Bağlan butonuna basana kadar hiçbir veri paylaşılmaz.
Onayladığınız İzinler
Onay ekranında dört izin ayrı ayrı listelenir; böylece asistanın ne kadar yetkiye sahip olacağına siz karar verirsiniz:
| Yetki | Asistanın Yapabileceği İşlem |
|---|---|
| Agent'ları Gör | Çalışma alanındaki agent'ları listeler ve geçmiş görev sonuçlarını okur |
| Soru Sor | Bir talimat iletir ve cevabı alır. Agent düşünür, araştırır ve yazar; hiçbir şeyi değiştirmez |
| Aksiyon Al | Agent yeteneklerini kullanarak gerçek aksiyon alır: e-posta gönderir, kayıt açar, iş zamanlar |
| Çalışma Güncellemelerini Takip Et | Seçilen agent veya çalışmaların olaylarını, izleme durdurulana ya da abonelik süresi dolana kadar alır |
Aksiyon Al ve Çalışma Güncellemelerini Takip Et izinleri varsayılan olarak seçili gelmez. Yalnızca güvendiğiniz uygulamalara onay verin; bu izin verildiğinde agent sizin adınıza konuşmanın ötesine geçerek gerçek operasyon yürütür.
Olay abonelikleri agents:read ve agents:events izinlerini birlikte gerektirir. Soru göndermek için agents:ask; işlem yapmak için ayrıca agents:act ve açık bir aksiyon talebi gerekir. Her bağlantı yalnız seçtiğiniz çalışma alanına erişir.
Asistanın Gördüğü Araçlar (Tools)
Bağlantı kurulduğunda asistanınızın kullanımına beş araç sunulur:
| Tool | Görevi |
|---|---|
list_agents | Bağlı çalışma alanındaki agent'ları listeler |
ask_agent | Bir agent'a doğal dilde talimat verip yanıtını alır |
reply_to_run | Aynı sohbete devam eder: agent'ın sorusunu cevaplar ya da konuyu sürdürür |
get_run | Uzun süren asenkron bir görevin sonucunu getirir |
list_runs | Bir agent'ın son çalışmaları ve sonuçlarını listeler |
Yalnızca onayladığınız izinlerin kapsadığı araçlar sunulur. Eğer Soru Sor iznini vermediyseniz ask_agent asistanınıza hiç gösterilmez.
Asistanınız üzerinden bir agent'la konuşmak, Botonom'da onunla sohbet etmekle aynıdır: aynı yetenekler, aynı kurallar ve Görevler listenize hiçbir şey düşmez. Her soru bir sohbet başlatır, reply_to_run o sohbete devam eder; agent konuşulanı hatırlar. Agent devam etmek için sizden bir bilgiye ihtiyaç duyarsa (hangi rapor, hangi ay gibi), çalışma waiting_input durumunda asistanınız cevabınızı iletene kadar bekler.
İş bitince haber alın
MCP Events destekleyen bir asistan, seçtiğiniz agent veya çalışmaya abone olabilir ve durum değiştiğinde yanıt verebilir. İşin bitip bitmediğini tekrar tekrar sormanız gerekmez.
| Olay | Anlamı |
|---|---|
agent.command.completed | Çalışma tamamlandı |
agent.command.failed | Çalışma başarısız oldu |
agent.command.updated | Çalışmanın durumunda başka bir değişiklik oldu |
Abonelikte agent_id, run_id veya her ikisi bulunmalıdır. Olay, çalışma referansını ve durumunu taşır; asistan sonucu get_run ile okur. Bu olaylar agent çalışmalarına aittir; çalışma alanındaki her mesajı veya iş kaydını kapsamaz.
Örnek: “Raporlama agent’ımın işi bitince burada haber ver. Sonucu oku ve ilk tamamlanan çalışmadan sonra izlemeyi durdur.”
İzlemeyi durdurmak aboneliği sonlandırır; agent’ın devam eden işini iptal etmez.
ChatGPT’de olay bildirimlerini kurun
- ChatGPT’de Plugins → Add → Create MCP App yolunu açın.
https://mcp.botonom.com/mcpadresini girin ve OAuth seçin. - Botonom çalışma alanınızı seçin. Agent’ları Gör ve Çalışma Güncellemelerini Takip Et izinlerini onaylayın. ChatGPT iş başlatacaksa Soru Sor iznini de ekleyin. Aksiyon Al iznini yalnız ihtiyacınız olduğunda verin.
- Eklenti sayfasında araçların yanında üç olayın listelendiğini doğrulayın. Mevcut bağlantılarda yeni olay iznini verdikten sonra Manage → Refresh tools ile yeniden taratın.
- Yeni bir Work sohbeti açıp bir agent’ın tamamlanan çalışmalarını izlemesini isteyin. Kısa bir test işi başlatmadan önce aboneliğin kurulduğunu doğrulayın.
- Olay geldiğinde ChatGPT sonucu okuyup aynı sohbette yanıt verebilir. İşiniz bitince izlemeyi durdurmasını isteyin.
Bu akışı gerçek bir komutla doğruladık: abonelik, tamamlanma olayının alınması, sonucun okunması, otomatik yanıt ve aboneliğin iptali. İstemci menüleri ve özelliklerin erişilebilirliği değişebilir. Olaylar listeleniyor ama sohbet abone olamıyorsa eklentiyi yenileyip yeni bir Work sohbetinde deneyin; olay listesinin görünmesi tek başına aktif abonelik anlamına gelmez.
Olay teslimatı ve geliştirici referansı
MCP Events, 2026-07-28 protokol sürümünü kullanır. Kimlik doğrulaması gerektiren MCP uç noktası server/discover, events/list, events/subscribe ve events/unsubscribe yöntemlerini sunar. Abonelikler, dört agent aracından ayrı bir protokol özelliğidir.
Botonom veri göndermeden önce HTTPS callback adresini doğrular; teslimatları Standard Webhooks ile imzalar. Abonelikler ve bekleyen teslimatlar yeniden başlatmalarda korunur. Geçici hatalar aynı olay kimliğiyle yeniden denenir; alıcılar yinelenen teslimatları işleyebilmelidir. Olaylar teslimattan önce filtrelenir ve abonelik boyunca erişim yeniden kontrol edilir.
Abonelikler sürelidir: varsayılan 24 saat, verilen süre beş dakika ile yedi gün arasındadır. İstemci refreshBefore zamanından önce yenilemelidir. Replay cursor’ları saklanan geçmişten devam etmeyi sağlar; truncated, istenen geçmişin artık bulunmadığını belirtir. Teslimatın kabul edilmesi, alıcı asistanın olayı anında işleyeceği garantisi değildir.
İstemci protokolü için OpenAI MCP Events rehberine bakın. Botonom REST webhook’ları ve yeteneklere gelen olaylar ayrı entegrasyonlardır.
İnceleme ve Bağlantıyı Kesme
Bağlı tüm uygulamalar Panel → Geliştiriciler → Kimlik Bilgileri → Bağlı Uygulamalar altında listelenir. Her uygulamanın sahip olduğu yetkiler, bağlantı tarihi ve son kullanım zamanı şeffaf biçimde izlenir.
Bağlantıyı Kes butonuna bastığınız anda işlem derhal yürürlüğe girer; verilen izinler geri alınır ve açık tüm canlı oturumlar derhal sonlandırılır.
Uygulama kartından olay aboneliklerini, durumlarını ve son teslimatlarını görebilirsiniz. Durdur ile tek bir aboneliği sonlandırabilirsiniz; uygulama bağlantısı açık kalır. Bağlantıyı kesmek olay teslimatlarını da durdurur.