AI Ajanları İçin SDK Dokümantasyonu Yazmayı Bırakın: Bunun Yerine MCP Sunucuları Oluşturun
BridgeXAPI, MCP sunucularının mesajlaşma API'lerini Claude Code ajanları için keşfedilebilir bir yürütme altyapısına dönüştürdüğünü savunuyor.
AI ajanları dokümantasyon okumaz. Altyapıyı keşfederler.
Bir SDK oluşturduğunuzda, insanlar için oluşturursunuz. İnsanlar README dosyalarını okur. İnsanlar metod imzalarını tarar.
Claude Code gibi AI ajanları farklı çalışır. Bir ajanın çalışma zamanında (runtime) üç şeyi bilmesi gerekir:
- Hangi yetenekleri sunuyorsunuz?
- Kısıtlamalar nelerdir?
- Çağrıları güvenli bir şekilde nasıl zincirleyebilirim?
Model Context Protocol (MCP) bunu çözer. Bir ajanın bir uç noktayı (endpoint) tahmin etmesi yerine, önce yetenekleri inceler. Eyleme geçmeden önce strateji üzerine muhakeme yapar ve kısıtlamaları doğrular.
Claude Code'u harici servislerle kullanıyorsanız, yaşanan zorluğu bilirsiniz. Ajanlar yollar uydurur (hallucinate). Parametreleri tahmin ederler. API'nizi birkaç örnekten öğrenmeye çalışırken token harcarlar.
Bir MCP sunucusu bu sorunu çözer.
İkisini karşılaştıralım:
SDK
- İnsanların doküman okumasını gerektirir
- Sabit fonksiyon imzaları
- Tek bir yürütme yolu
- Manuel hata yönetimi
MCP Server
- Ajanlar için kendini tanımlayan (self-describing)
- Keşfedilebilir yetenekler
- Ajanlar strateji üzerine muhakeme yapar
- Yerleşik kısıtlama doğrulaması
Claude Code kullanıcıları için bu devasa bir kazançtır. Eğer bir servisin MCP sunucusu varsa, onu eklemek için tek bir komut çalıştırmanız yeterlidir. Claude aracı anında anlar. Prompt engineering yapmanıza veya CLAUDE.md dosyanızda uzun açıklamalar yazmanıza gerek kalmaz.
Eğer API sağlıyorsanız, AI için dokümantasyon yazmayı bırakın. Bir MCP sunucusu oluşturun. SDK'nız insanlar içindir. MCP sunucunuz ise ajanlar içindir.
Bunu nasıl uygularsınız:
- API geliştiriyorsanız: Ürününüzle birlikte bir MCP sunucusu sunun.
- API kullanıyorsanız: Uzun promptlar yazmak yerine ince bir MCP wrapper'ı oluşturun.
- Bir ekibe liderlik ediyorsanız: MCP kullanılabilirliğini API tasarım incelemenizin bir parçası haline getirin.
SDK dönemi bitmedi. Ancak ajan tabanlı (agentic) iş akışları için önemli olan arayüz MCP sunucularıdır.
Kaynak: https://dev.to/gentic_news/stop-writing-sdk-docs-for-ai-agents-build-mcp-servers-instead-1kmi
İsteğe bağlı öğrenme topluluğu: https://t.me/GyaanSetuAi