developers · May 20, 2026

Quire MCP ve Claude Managed Agents ile Haftalık Changelog Ajanını Nasıl Kurduk

Yapay zeka ile çevrildi
· İngilizce görüntüle

Bir Quire projesi içinde haftalık changelog özeti oluşturan bir Claude ajanı

Son güncelleme: 25 Mayıs 2026

Kısaca: Pazartesi özet toplantımızı, Dev_Changelog Quire projemizi Quire MCP üzerinden okuyan, son yedi günde tamamlanan işleri etikete göre gruplayan ve müşterilerin okuyabileceği haftalık bir özeti yeni bir Quire belgesi olarak yazan bir Claude Managed Agent ile değiştirdik. Çalışma süresi Haiku 4.5 üzerinde 30 saniyenin altında. En az bariz kazanım, agresif araç filtrelemesi oldu: çalışma başına giriş tokenlarını yaklaşık 82.000'den 12.000'e indirdi ve API yükseltmesi yapmadan işi Tier 1 hız limitlerinin içinde tuttu.

Pazartesi, sabah 09.04. Ekip kanalınızdaki biri soruyor: "Hey, geçen hafta neler çıktı, kısa bir özet?" Üç kişi sekmelerini açıyor, Kanban panosunu kaydırıyor, kapatılan kırk görevden hangilerinin gerçekten anlamlı olduğunu hatırlamaya çalışıyor ve yirmi dakika sonra iki maddeyle ve bir omuz silkmeyle geri dönüyor. On dakika sürmesi gereken özet toplantısı kırk dakikaya uzuyor. Salı gününe kalmadan herkes içeriğini unutuyor.

Biz bu döngüyü ortadan kaldırdık. Quire MCP ve Claude Managed Agents üzerine, her Pazartesi sabahı Dev_Changelog projemizi okuyan, son yedi günde tamamlanan her şeyi bulan, ekibe göre gruplayan, dev kısaltmalarını müşterinin okuyabileceği bir dile çeviren ve tüm özeti yeni bir Quire belgesine yazan bir ajan kurduk. Toplam çalışma süresi: otuz saniyenin altında. Toplam sürekli bakım: sıfır.

Bu yazı, yol boyunca bozulan üç şey ve bunları nasıl düzelttiğimiz dahil olmak üzere kurulumun tamamı. Eğer proje verileriniz üzerinde sadece sohbet etmek yerine gerçek iş yapan bir yapay zekâ ajanı istediyseniz, işte çalışan bir tarif.

Ajan aslında ne üretiyor?

Her Pazartesi Pasifik Saati'yle 09.00'da bir Claude oturumu uyanır, Quire'ı sorgular ve Dev_Changelog projemizde Weekly Brief: May 15 to May 21, 2026 başlıklı yeni bir belge oluşturur. Belge şu sırayla beş bölüme sahiptir:

  • Highlights: kullanıcı etkisine göre ilk üç madde
  • Features Shipped: her yeni yetenek, kullanıcıya yönelik bir faydaya çevrilmiş şekilde
  • Bugs Fixed: kullanıcının düzeltmeden önce neyi yaşadığını anlatan açıklamalar
  • Design Updates: gözle görülür şekilde neyin değiştiğine odaklanan
  • Social and Marketing: görev açıklamasında etkileşim sayıları varsa onları da içeren

Boş bölümler sessizce atlanır. Sayfanın altında tek satırlık bir sayı özeti yer alır. Tamamı yaklaşık 400 kelime sürer ve bir pazarlama changelog'undan çok dahili bir özet gibi okunur, çünkü sistem komutu tam olarak bunu istiyor.

Canlı örnekleri görün: ajan, filtrelenmiş Dev_Changelog kaynak projesinden okuma yapar ve Weekly Brief: May 15 to May 21, 2026 ürettiği gerçek belgedir.

Dev_Changelog filtrelenmiş kaynak projesi ile üretilen Weekly Brief belgesinin yan yana görünümü

Ekip bunu standup sırasında iki dakikada okur. Kimsenin yazması gerekmez. Kimsenin hatırlaması gerekmez.

Quire MCP ve Claude Managed Agents size ne sağlar?

Quire MCP, https://mcp.quire.app/mcp adresinde barındırılan bir Model Context Protocol sunucusudur. Quire'ın API'sini, MCP uyumlu herhangi bir istemcinin çağırabileceği standartlaştırılmış araçlar kümesi olarak dışa açar. search_tasks'tan create_document'a, bulk_create_tasks'a kadar her şeyi kapsayan yaklaşık doksan beş araç vardır. Ajanın, Quire'ın REST API'sinin nasıl şekillendirildiğini bilmesi gerekmez. Sadece bir araç kataloğu görür ve ihtiyacı olanı çağırır.

Claude Managed Agents, Anthropic'in otonom ajanlar için sunduğu yönetilen çalışma ortamıdır. Bir ajan (model + sistem komutu + araç yapılandırması), bir ortam (ağ politikalarıyla izole edilmiş kapsayıcı) tanımlar ve gerçek işi yapan oturumlar oluşturursunuz. Anthropic; izolasyonu, kimlik bilgisi proxy'sini, yürütme döngüsünü ve denetim günlüğünü üstlenir. Bunların hiçbiri sizin yazmanız gereken kod değildir.

Kombinasyon önemli, çünkü her parça tek başına yalnızca borulardan ibaret. Ajansız Quire MCP, kimsenin çağırmadığı bir araç kataloğudur. Alan adına özel bir MCP'si olmayan Claude Managed Agents, yapacak bir şeyi olmayan bir sandbox'tır. Bunları birbirine bağladığınızda, gerçek üretim verilerine karşı gerçek eylemler gerçekleştiren, uygun kimlik doğrulama ve izolasyonun yerleşik olduğu bir ajan elde edersiniz.

Claude Managed Agents kullanmıyor musunuz? Quire MCP, açık kaynaklı MCP istemcisi Open Claw ile de çalışır. Aynı araç kataloğu, aynı OAuth akışı, üzerine kurabileceğiniz aynı iş akışları. Yığınınıza hangisi uygunsa onu seçin.

Bu neden önemli: Çoğu proje yönetim aracı henüz herkese açık bir MCP sunucusu sunmuyor. Asana, Monday ve ClickUp REST API'leri sunar ancak MCP sunmaz; bu yüzden kendiniz sarmalamanız ve kimlik doğrulamayı yönetmeniz gerekir. Notion'un MCP'si var, ancak araç yüzeyi belgeler ve sayfalar için kurgulanmış; proje otomasyonunun gerçekten ihtiyaç duyduğu görev-ve-alt-görev yapısı için değil. Quire MCP, bir ajanın üzerinde işlediği iş birimleri (görevler, alt görevler, durumlar, etiketler, alt listeler) etrafında kurulmuş; bu yüzden bu kurulum bir öğleden sonra, bir çeyrek dönem değil.

Kurulum, adım adım

Tüm kurulum yaklaşık bir saat sürdü; bunun çoğu birazdan değineceğim bir yapılandırma tuzağıyla mücadele ederek geçti. İşte gerçek tarif.

1. Ajan tanımı

Ajan tek bir YAML dosyasından ibaret. Sistem komutu en önemli kısım, çünkü genel bir Claude oturumunu bir changelog yazıcısına dönüştüren şey o:

name: Dev Changelog Writer
model:
  id: claude-haiku-4-5
  speed: standard
system: |-
  You are the weekly changelog writer for the Quire project
  "Dev_Changelog" (https://quire.io/w/Dev_Changelog).
  When invoked:
  1. Use the Quire MCP to search Dev_Changelog for tasks where status
     is completed and the `toggled` timestamp falls within the last 7
     days. Pull name, description, priority, tags, and subtasks.
  2. Group results by tag: feature, bugfix, design, social. Within
     each group, sort by priority (urgent, high, medium, low).
  3. Translate each task from internal dev shorthand into plain
     language a customer would understand. Features: lead with the
     user-facing benefit. Bugfixes: lead with what the user was
     experiencing. Design: describe what visibly changed. Social:
     include engagement numbers if mentioned.
  4. Create a new document in Dev_Changelog using `create_document`.
     Title: "Weekly Brief: [start date] to [end date]". Sections:
     Highlights, Features Shipped, Bugs Fixed, Design Updates,
     Social and Marketing, plus a footer with item counts.
  5. If zero completed tasks are found, do not create a document.
mcp_servers:
  - name: quire
    type: url
    url: https://mcp.quire.app/mcp

Claude Managed Agents konsolunda açık olan ajan tanımı

Haiku 4.5'i seçtik çünkü iş akıl yürütme ağırlıklı değil. Ajan grupluyor, filtreliyor ve biçimlendiriyor; Haiku bunu Sonnet'in token başına maliyetinin yaklaşık onda biriyle ve belirgin biçimde daha yüksek hız limitleriyle rahatlıkla halledebiliyor. Gözetimsiz haftalık bir çalışma için bu hız limiti rahatlığı, marjinal akıl yürütme kazancından çok daha önemli.

2. Araç filtreleme — asıl kazanç burada

Varsayılan olarak, Quire MCP sunucusunu bir ajana bağladığınızda, ajan her model çağrısı yaptığında doksan beş araç tanımının tamamı bağlama yüklenir. Bu çok fazla token demek ve ajanınızın yalnızca görevleri okuyup bir belge oluşturması gerekiyorsa bunların büyük çoğunluğu anlamsız.

Acımasızca filtreleyin:

tools:
  - mcp_server_name: quire
    type: mcp_toolset
    default_config:
      enabled: false
      permission_policy:
        type: always_allow
    configs:
      - name: search_tasks
        enabled: true
      - name: create_document
        enabled: true
      - name: list_tags
        enabled: true
      - name: resolve_quire_url
        enabled: true

default_config.enabled: false "varsayılan olarak hiçbir şey açık değil" anlamına gelir; configs bloğu ise ajanın gerçekten kullandığı dört araç için açık katılım sağlar. Bu tek değişiklik, çalışma başına giriş token sayımızı yaklaşık 82.000'den 12.000'in altına indirdi; bu da bizi rahatça Tier 1 hız limitinin altına taşıdı. (Aşağıdaki savaş hikâyelerinde bu konuya tekrar değineceğiz.)

Güvenlik avantajı da var. Yalnızca search_tasks, create_document, list_tags ve resolve_quire_url etkin olduğunda, ajan bir prompt enjeksiyonu denenmiş olsa bile mevcut hiçbir veriyi silemez, arşivleyemez veya değiştiremez. Quire bulk_delete_tasks aracı araç setinde olmadığı için model onu çağıramaz.

3. Ortam

Managed Agents her oturumu, sizin kontrol ettiğiniz bir ağ politikasına sahip bir gVisor sandbox'ı içinde çalıştırır. Varsayılan, dış ağ erişimi olmayan "Limited" politikasıdır; bu da ajanınızın Quire MCP'ye ulaşmasını engeller. En temiz çözüm en az yetki ilkesi: türü Limited olarak bırakın, ancak ihtiyaç duyduğunuz tek bir ana bilgisayar adına açıkça izin verin.

mcp.quire.app'in izin verilen ana bilgisayarlar listesine eklendiği Limited türünde ortam ağ yapılandırması

Claude konsolunda: Manage Environments → ortamınız → NetworkingAllow MCP server network access seçeneğini etkinleştirin → Allowed hosts alanına mcp.quire.app ekleyin. Paket yöneticisi ağ erişimini devre dışı bırakın, çünkü bu ajan hiçbir şey kurmuyor.

4. Kimlik bilgisi kasası

Quire, OAuth ile kimlik doğrulaması yapar. Managed Agents'te OAuth jetonları, sandbox'ın dışında duran bir kimlik bilgisi kasasında bulunur. Ajan Quire MCP'yi çağırdığında, bir kimlik bilgisi proxy'si jetonu sunucu tarafında enjekte eder. Modelin kendisi jetonu hiçbir zaman görmez; bu da başarılı bir prompt enjeksiyonunun onu sızdıramayacağı anlamına gelir.

Quire MCP OAuth kimlik bilgisinin etkin olduğu kimlik bilgisi kasası yapılandırması

Bir kasa oluşturun, Add credential'a tıklayın, https://mcp.quire.app/mcp adresine işaret ettirin, tür olarak OAuth seçin ve yetkilendirme akışını çalıştırın. Kimlik bilgisi Active olarak göründüğünde, kasa hazırdır.

5. Zamanlama

Managed Agents oturumları tek seferliktir. Otomatik olarak tekrar etmezler. Ajanın her Pazartesi çalışmasını sağlamak için, herhangi bir zamanlayıcıyı sessions.create API uç noktasına 0 9 * * 1 cron ifadesiyle yönlendirin. Biz haftada bir kez Anthropic API'sini çağıran basit bir Cloudflare Workers Cron Trigger kullanıyoruz, ancak zamanlamaya bağlı GitHub Actions da aynı şekilde işe yarar; herhangi bir bulut işlev platformu da öyle.

Neler bozuldu ve bunu nasıl anladık?

Temiz bir haftalık çalışmaya giden yolda üç şey ters gitti. Bunları belirtmeye değer, çünkü benzer bir şey kurarsanız en az biriyle karşılaşacaksınız.

Yanlış MCP URL'si. Quire ürünü quire.io adresinde barındırılır, ancak MCP sunucusu quire.app adresindedir. Her şeyi (ajan, ortam izin verilen ana bilgisayarlar, kimlik bilgisi kasası) mcp.quire.io/mcp adresine yönlendirdik ve önce kafa karıştırıcı bir OAuth hatası, sonra bunu aştığımızda yukarı akıştan HTTP 502 aldık. Çözüm sıkıcı ama belirtmeye değer: MCP'ye yapılan her referans mcp.quire.app kullanmalı, quire.io değil. Üç yerden birinde yanlış ana bilgisayar varsa, çalışma başarısız olur.

Ajan araç seti şişkinliği. Anthropic'in varsayılan agent_toolset_20260401'i her genel amaçlı aracı (bash, dosya işlemleri, web araması, kod yürütme) bağlama yükler. Ajanımızın bunların hiçbirine ihtiyacı yok. Quire MCP sunucusunun üzerine varsayılan araç setini etkin bırakmak, çalışma başına giriş token sayımızı 80.000'in üzerine itti ve Tier 1 hız limitine anında çarptık. Varsayılan araç setini kaldırmak ve Quire'ın araçlarını filtrelemek (yukarıda gösterildiği gibi) bunu yaklaşık 12.000'e düşürdü. Ders: ajanınızın bağlamındaki her araç, ajan onu hiç çağırmasa bile bir vergidir.

Hız limiti paniği. Şişkinlik sorununu fark etmeden önce doğal tepki "API katmanını yükseltmeliyiz" oldu. Katman yükseltmeleri paraya mal olur. Asıl sorun, ajanın asla kullanmayacağı 70.000 token'lık araç tanımları yüklemesiydi. Daha büyük bir limite ihtiyacınız olduğunu varsaymadan önce bağlam pencerenizde ne olduğunu daima kontrol edin.

Haftalık changelog dışında Quire MCP neleri açar?

Haftalık changelog yararlı bir ilk ajan, ancak büyük ölçüde bir kavram kanıtı. Desen (bir Managed Agent + Quire MCP + zamanlanmış bir tetikleyici) çok daha fazlasına uzanır.

Prototipini geliştirdiğimiz birkaç örnek:

  • Gece "In Progress" durumuna alınan görevleri okuyup Slack'e özet gönderen bir günlük sprint başlangıç özeti
  • Bir Quire projesini tamamlanmış incident görevleri için izleyen ve alt görevlerden çekilen zaman çizelgesi, katkıda bulunan etkenler ve takip eylemleriyle birlikte bir taslak retro belgesi derleyen bir olay sonrası değerlendirme taslakçısı
  • Cuma öğleden sonraları her müşteri projesi için çalışan ve haftanın teslimatlarını doğrudan müşteriye iletmeye uygun bir dille özetleyen bir müşteri durum özeti

Şekil her seferinde aynı. Zamanlanmış bir tetikleyici, odaklanmış bir ajan, küçük bir Quire MCP araç seti ve çıktı olarak bir belge ya da mesaj. Zor iş (izolasyon, kimlik bilgileri, ajan döngüsü) Managed Agents'te. Alan adına özgü iş (hangi Quire verisinin sorgulanacağı, onunla ne yapılacağı) sistem komutunda.

Bu yaklaşımın doğru olmadığı durumlar

Tek seferlik sorular için bir Managed Agent gereğinden fazladır. "Bu çeyrekte neler çıktı?" gibi tek seferlik bir özet istiyorsanız, Claude'a doğrudan bir sohbet penceresinde sorup Quire verisini yapıştırmak, dağıtılmış bir ajan kurmaktan daha hızlıdır. Ajan şekli yalnızca aynı iş tekrar tekrar gözetimsiz çalıştığında karşılığını verir.

İş gerçekten akıl yürütme ağırlıklı olduğunda, örneğin aynı veriden düşünceli bir ürün stratejisi yazmak söz konusu olduğunda, bu yine yanlış şekildir. Haiku "özetle ve biçimlendir" için iyidir. "Bu konuda ne yapmamız gerektiğine karar ver" için Sonnet veya Opus istersiniz; o noktada muhtemelen döngüde bir insan da istersiniz.

Ve proje verileriniz seyrek ise (örneğin haftada birkaç tamamlanmış görev ve açıklama yok), ajanın özetleyecek faydalı bir şeyi yoktur. Çıktı, ekibinizin gerçek görev açıklamaları yazma konusundaki disiplini kadar iyidir. Erken bir test çalıştırmasında teknik olarak doğru ama tamamen bilgi vermeyen bir özet üretildiğinde bunu zor yoldan öğrendik; çünkü görev adlarının yarısı yalnızca biletin kimliğinden ibaretti.

Quire proje yönetimi yazılımını kullanan 100.000'den fazla ekibe katılın — ücretsiz kaydolun

Önemli Çıkarımlar

Haftalık changelog ajanı kapsam olarak küçük ama getirisi büyük; çünkü kimsenin hatırlaması gerekmeden tekrarlayan bir vergiyi (Pazartesi özet toplantısını) ortadan kaldırıyor. İşi yürüten parçalar belliydi: maliyet ve hız limiti rahatlığı için Haiku 4.5, bağlam penceresini sıkı tutmak için agresif araç filtrelemesi, yalnızca mcp.quire.app adresine trafiğe izin veren en az yetki ilkesine dayanan bir ortam politikası ve ajanın gerçek OAuth jetonuna asla dokunmaması için bir kimlik bilgisi kasası.

Genel ders şu: Quire MCP artı Claude Managed Agents, herhangi bir altyapı kurmadan proje verilerinizin önüne otonom bir ajan koymanın hızlı bir yoludur. Zor kısımlar (izolasyon, kimlik doğrulama, zamanlama, denetim günlükleri) zaten çözülmüş. Sizin getirmeniz gereken şey komut, araç seçimi ve ilk etapta özetlenmeye değer proje verileri yazma disiplini.

Sıkça Sorulan Sorular

Quire MCP nedir?

Quire MCP, yapay zekâ ajanlarının standartlaştırılmış bir araç arayüzü üzerinden Quire çalışma alanınızı okumasına ve yazmasına olanak tanıyan bir Model Context Protocol sunucusudur. https://mcp.quire.app/mcp adresinde bulunur ve arama, görev ve belge oluşturma, toplu işlemler ve daha fazlasını kapsayan yaklaşık doksan beş aracı dışa açar. MCP uyumlu herhangi bir istemci (Claude, Cursor, Anthropic SDK üzerine kurulmuş özel ajanlar) ona bağlanabilir.

Claude Managed Agents nedir?

Claude Managed Agents, Anthropic'in bulutta uzun ömürlü otonom ajanları çalıştırmak için sunduğu yönetilen çalışma ortamıdır. Bir ajan (model, sistem komutu, araçlar), bir ortam (ağ politikalarıyla izole edilmiş kapsayıcı) tanımlar ve işi yürüten oturumlar oluşturursunuz. Anthropic izolasyonu, kimlik bilgisi yönetimini ve yürütme döngüsünü üstlenir, böylece bu altyapıyı sıfırdan kurmak zorunda kalmazsınız.

Bu tür bir otomasyon için neden Sonnet veya Opus yerine Haiku 4.5 kullanmalı?

Yapılandırılmış görev verilerini bir belgeye özetlemek, akıl yürütme ağırlıklı bir görev değildir. Gruplama, filtreleme ve biçimlendirmeden ibarettir. Haiku 4.5 bu kalite çıtasını rahatlıkla karşılar, token başına yaklaşık olarak Sonnet'in onda birine mal olur ve her API katmanında belirgin biçimde daha yüksek hız limitlerine sahiptir. Gözetimsiz çalışan haftalık bir iş için, maliyet ve hız limiti rahatlığı, marjinal akıl yürütme kazancından çok daha önemlidir.

Ajan, haftalık özeti oluşturmak için ne kadar sürer?

Söz konusu zaman penceresinde yaklaşık yirmi tamamlanmış göreve sahip bir proje için tam çalışma uçtan uca otuz saniyenin altında sürer. Bu süre Quire'ı aramayı, sonuçları işlemeyi, belge gövdesini yazmayı ve belgeyi projeye geri oluşturmayı kapsar. Bu zamanın çoğu, araç gidiş-dönüşleri değil, model çağrısıdır.

Ajan, projemdeki mevcut görevleri düzenleyebilir veya silebilir mi?

Yalnızca bu araç izinlerini açıkça verirseniz. Quire MCP sunucusu yaklaşık doksan beş aracı dışa açar, ancak Claude Managed Agents her ajan için bir alt kümeyi etkinleştirmenize izin verir. Changelog kullanım senaryosunda yalnızca dört okuma ve oluşturma aracını etkinleştirdik; bu sayede bir prompt enjeksiyonu denenmiş olsa bile ajan mevcut hiçbir veriyi değiştiremez veya silemez.

Ajanın çalıştığı hafta hiçbir görev tamamlanmadıysa ne olur?

Ajan komutu bir yedek talimat içerir: arama sonucunda sıfır tamamlanmış görev dönerse, belge oluşturma ve bunun yerine haftanın boş olduğunu belirten tek satırlık bir kayıt düş. Bu, ekibin söz konusu pencerede hiçbir şey teslim etmediği durumlarda boş ya da yanıltıcı bir haftalık özetin yayımlanmasını engeller.

Quire MCP'yi kullanmak için ücretli bir Quire planında olmam gerekiyor mu?

Quire MCP, API erişimi olan herhangi bir planla çalışır. Güncel API kotalarını quire.io/pricing adresinden kontrol edin. Çalışma başına birkaç araç çağrısı yapan haftada bir kez çalışan bir ajan için, ücretsiz katman veya başlangıç limitleri genellikle yeterlidir.

Aynı ajanı birden fazla Quire projesinde çalıştırabilir miyim?

Evet. En temiz desen, iş akışı başına bir ajan tanımı ve proje başına bir oturumdur. Proje URL'si, oturum oluşturulurken iletilen bir parametre olur. Birden fazla projeyi kapsayan tek bir haftalık özet istiyorsanız, komutu her projeyi sırayla sorgulayacak ve sonuçları tek bir belgede birleştirecek şekilde yeniden yapılandırın.

Quire MCP üzerine kendi ajanınızı kurmaya hazır mısınız?

quire.io/signup adresinden 30 günlük ücretsiz denemenizi başlatın ve tam MCP araç kataloğunu görmek için Quire geliştirici dokümanlarını inceleyin. Kredi kartı gerekmez, tam erişim.

Vicky Pham
Marketer by day, Bibliophile by night.