İçeriğe geç

Kodlama ajanın raporu okuyabilsin diye bir bug raporu MCP sunucusu

Güncelleme

Midge'in bir bug raporu MCP sunucusu var. Claude Code ve Cursor gibi kodlama ajanlarının bir Midge raporunu doğrudan okumasını sağlar: konsol hatalarını, ağ isteklerini ve yanıtlarını, kullanıcının tıklamalarını ve sayfa geçişlerini, tarayıcı bilgilerini. Bir stack trace'i sohbete kopyalamak yerine rapor bağlantısını yapıştırırsın, ajan da ihtiyaç duyduğu kısımları kendisi çeker.

Kurulum

Claude Code'da tek bir komut yeterli:

claude mcp add --transport http midge https://midge.dev/mcp

Claude Code onu ilk kez kullandığında tarayıcında midge.dev açılır: giriş yap, Allow'a (İzin ver) tıkla ve terminale geri dön. Cursor ve uzak MCP sunucularını destekleyen diğer istemciler de https://midge.dev/mcp adresiyle aynı şekilde çalışır.

Tarayıcıdan giriş yapamayan bir ajan bunun yerine bir token kullanır: midge.dev'de Settings › Account › AI assistants'ı aç, ajanı seç ve Create token'a tıkla, ardından token'ı Authorization: Bearer <token> olarak gönder.

Her iki yolda da ajan Connected devices altında "Claude Code (MCP)" ya da benzeri bir adla görünür; oradan oturumunu kapatırsan artık hiçbir şey okuyamaz. Her istemci için ayrıntılar doküman sayfasında.

Araçlar

  • get_recording: Elinde bir bağlantı varsa başlangıç noktası. Başlık, açıklama, sayfa, cihaz ve süre, ziyaret edilen sayfalar, ilk konsol hataları ve başarısız istekler.
  • get_console: Mesajlar sırasıyla, seviyeye göre (yalnızca hatalar, uyarılar ve hatalar ya da hepsi), stack trace'ler ve metin aramasıyla.
  • get_network: Metot, durum, tür ve süreyle istekler. Yalnızca başarısız istekleri ya da tek bir endpoint'i, ajanın ihtiyacı olduğunda da header ve body'leri iste; böylece 4 MB'lık bir log yerine önemli olanı okur.
  • get_user_actions: Tıklamalar, yazma (metnin kendisi asla değil), kaydırmalar ve sayfa geçişleri sırasıyla; yeniden üretme adımlarına dönüşmeye hazır.
  • list_recordings: Bağlantı yapıştırmadığın durumlar için, aramalı son raporların.

Tipik bir oturum şöyle: Bir rapor bağlantısını Claude Code'a yapıştırıp nedeni bulmasını istiyorsun. Ajan özeti okuyor, başarısız istekleri body'leriyle istiyor, POST /api/orders isteğinden doğrulama hatasıyla dönen bir 500 buluyor, konsolda buna karşılık gelen istemci tarafı hatayı okuyor ve repondaki handler'ı açıyor.

MCP nedir

Model Context Protocol, yapay zekâ uygulamalarının dış araçlara ve verilere bağlanmasını sağlayan açık bir standart. Bir sunucu, "X raporunun konsol logunu getir" gibi bir dizi araç sunar; Claude Code ya da Cursor gibi bir istemci de bir görev üzerinde çalışırken bunları çağırır. Sunucuyu bir kez bağlarsın, ne zaman kullanacağına ajan karar verir.

Bug düzeltirken bunun önemi şu: İşe yarayan kanıt kodda değil, bug raporunda. Başarısız isteği ve hatanın tam metnini okuyabilen bir ajan doğrudan doğru dosyaya gidebilir.

Erişim ve gizlilik

Sunucu, Midge'in geri kalanıyla aynı erişim kontrollerini kullanır. Senin token'ına sahip bir ajan, senin açabildiğini açabilir, fazlasını değil: "Only me" (Yalnızca ben) olarak ayarlanmış bir rapor sende kalır, bir çalışma alanı raporu da o alanın üyelerinde. Herhangi birinin "Anyone with the link" (Bağlantıya sahip herkes) olarak paylaştığı bir rapor, tıpkı tarayıcıda olduğu gibi, bağlantıya sahip ve giriş yapmış her ajan için açılır. Sunucu yalnızca okur; hiçbir şeyi değiştiremez, silemez ya da paylaşamaz.

Raporlar Midge'e ulaşmadan önce maskelenir. Şifreler, kart numaraları, token'lar ve çerezler, hiçbir şey cihazından çıkmadan önce silinir. Ajan, bir ekip arkadaşının göreceği maskelenmiş verinin aynısını alır. Kurallar maskeleme sayfasında listeleniyor.

MCP olmadan

Ajanın MCP konuşmuyorsa bir raporu sohbete yine elle taşıyabilirsin:

  • cURL olarak kopyala: Başarısız isteği ağ logları panelinde aç ve kopyala. Authorization header'ı ve çerezler [REDACTED] olarak gelir; bir sohbet dökümünde istediğin de tam olarak bu.
  • Maskelenmiş HAR'ı indir: Raporun ağ logunu HAR dosyası olarak ekle. Ajanlar bunu iyi işler; önce kendin bakmak istersen ücretsiz HAR görüntüleyicide aç.
  • Konsolu yapıştır: Hatayı ve stack trace'ini, varsa hemen öncesindeki uyarıyı da kopyala.

Neden MCP

Tek bir editör için bir eklenti yapabilirdik. MCP'yi pek çok ajan ve editör destekliyor; bu yüzden tek bir sunucu Claude Code'a, Cursor'a ve ekibinin bundan sonra kullanacağı her şeye hizmet ediyor. Ayrıca neyi okuyacağının kontrolü ajanda kalıyor: Tam olarak ihtiyaç duyduğu istekleri istiyor.

Sırada Jira, Linear, GitHub Issues ve Slack entegrasyonları var.

Midge ücretsiz: sınırsız kayıt, 15 dakikaya kadar video ve filigran yok.

Sık sorulan sorular

Midge MCP sunucusu şu an kullanılabilir mi?
Evet, üstelik ücretsiz. Ajanına https://midge.dev/mcp adresini ekle (Claude Code'da: claude mcp add --transport http midge https://midge.dev/mcp) ve istediğinde tarayıcıda Midge'e giriş yap. Giriş yapamayan ajanlar Settings › Account › AI assistants'tan alınan bir token kullanır.
Hangi ajanlarla çalışıyor?
Streamable HTTP üzerinden, header ile uzak MCP sunucularını destekleyen her istemciyle; Claude Code ve Cursor da bunlara dahil.
Ajan neleri okuyabilir?
Raporun özetini (başlık, açıklama, sayfa, cihaz, ziyaret edilen sayfalar), konsol mesajlarını, filtre ve body'leriyle ağ isteklerini ve kullanıcının adımlarını. Yalnızca okuyabilir ve yalnızca token'ı oluşturan kişinin açabildiği raporları.
Ajan gizli bilgilerimi görecek mi?
Hayır. Raporlar yüklenmeden önce, tarayıcıda ya da Mac'inde maskelenir; Midge ham değerleri hiçbir zaman saklamaz. MCP sunucusu yalnızca Midge'de olanı, yani maskelenmiş veriyi döndürebilir.