İleri Düzey Profesyonel Yazılım & Kodlama

Claude Code ve Model Context Protocol (MCP) ile Profesyonel Web Uygulaması Geliştirme

Büyük dil modellerini basit bir kod tamamlama aracından tam teşekküllü otonom yazılım mühendislerine dönüştüren Model Context Protocol (MCP) mimarisi ve Claude Code ile sıfırdan üretim kalitesinde proje geliştirme kılavuzu.

YZ Merkezi Yazılım Mimarisi Ekibi • 17.09.2026 • 15 dk okuma • 1 görüntülenme
Tüm Rehberler

Yapay zekâ destekli yazılım geliştirme, basit sohbet pencerelerinde kod parçacığı kopyalayıp yapıştırma dönemini geride bıraktı. Anthropic tarafından açık kaynak olarak tanıtılan Model Context Protocol (MCP), yapay zekâ modellerinin yerel geliştirme araçlarına, canlı veritabanlarına, dosya sistemine ve GitHub repolarına güvenli bir protokolle doğrudan bağlanmasını sağlıyor.

Bu kapsamlı kılavuzda, terminal tabanlı yeni nesil ajan Claude Code ile MCP sunucularını nasıl kuracağınızı, veritabanı şemasına doğrudan bağlayarak çok dosyalı mimari geliştirmeyi ve birim testlerle desteklenen üretim seviyesinde bir web uygulamasını nasıl inşa edeceğinizi inceleyeceğiz.

Adım Adım Uygulama

1

Model Context Protocol (MCP) Mimarisi ve Ekosistem Standartları

Model Context Protocol (MCP); yapay zekâ ajanları (Host/Client) ile veri kaynakları veya geliştirici araçları (Server) arasında standart bir JSON-RPC protokolü üzerinden iki yönlü güvenli iletişim kurar.

Klasik REST API entegrasyonlarının aksine MCP; şema keşfi (tool discovery), dinamik bağlam kaynakları (resources) ve sistem istemleri (prompts) gibi yetenekleri modele yerel bir refleks olarak kazandırır. Bu sayede model projenizdeki dosyaları, veritabanı tablolarını ve Git geçmişini kör bir tahmin yerine doğrudan okur.

İpucu

MCP mimarisinde araçlara her zaman en az yetki prensibiyle (least privilege) yaklaşın. Geliştirme yaparken dosya okuma ve test çalıştırma izinlerini açık tutarken dosya silme işlemlerini onay mekanizmasına bağlayın.

Dikkat Edilecek Nokta

Production (canlı) ortam veritabanlarına doğrudan yazma yetkisi olan MCP sunucuları bağlamayın; her zaman izole bir geliştirme veya staging veritabanı kullanın.

2

Claude Code CLI Kurulumu ve Geliştirici Ortamı Yapılandırması

Claude Code, doğrudan terminalinizde çalışan ve kod tabanınızı bir kıdemli mühendis gibi baştan sona anlayan resmi bir komut satırı aracıdır. Node.js 18+ ortamında aşağıdaki komutla global olarak yükleyin:

npm install -g @anthropic-ai/claude-code

Kurulum sonrasında proje dizininize geçerek claude komutunu çalıştırın ve Anthropic API anahtarınız ile oturum açın. Projenin kök dizinine bir CLAUDE.md veya AGENTS.md dosyası koyarak mimari kurallarınızı, test komutlarınızı ve kodlama standartlarınızı tanımlayın.

İpucu

Proje kökündeki CLAUDE.md dosyasına birim test çalıştırma komutunuzu (örn. ./vendor/bin/phpunit) yazarsanız, Claude Code her refactoring sonrasında testleri otomatik koşarak regresyonları anında onarır.

Dikkat Edilecek Nokta

API anahtarınızı kesinlikle Git reposuna eklemeyin; sistem ortam değişkeni (ANTHROPIC_API_KEY) olarak saklayın.

3

PostgreSQL ve GitHub MCP Sunucularını Sisteme Bağlama

Claude Code'un projenizdeki veritabanı şemasını ve GitHub açık sorunlarını doğrudan görebilmesi için MCP sunucularını yapılandırın. claude mcp add komutuyla resmi PostgreSQL ve GitHub sunucularını ekleyin:

claude mcp add postgresql npx -y @modelcontextprotocol/server-postgres postgresql://kullanici:sifre@localhost:5432/proje_db

Bağlantı sağlandıktan sonra Claude Code artık şemayı analiz edebilir, sorgu performanslarını ölçebilir ve migration dosyalarını sıfır hata ile üretebilir.

İpucu

Veritabanı MCP sunucusunda salt okunur (read-only) kullanıcı tanımlamak güvenlik açısından en iyi uygulamadır.

Dikkat Edilecek Nokta

Bağlantı dizesindeki şifreleri açık komut geçmişinde bırakmamak için ortam değişkenlerinden referans verin.

4

Çok Dosyalı Mimari İskeletin İnşası ve Otonom Refactoring

Claude Code'a projenizin mimari gereksinimlerini aktararak uçtan uca özellik geliştirmesini isteyin. Örneğin: "PostgreSQL şemasındaki guides tablosunu oku, bu tabloya uygun Repository katmanını, Controller sözleşmesini ve arayüz şablonunu oluştur."

Claude Code dosyaları tek tek gezerek mevcut kod tabanındaki yardımcı fonksiyonları, isimlendirme standartlarını ve tasarım tokenlarını otomatik tespit eder ve projenin mevcut dokusunu bozmadan yeni modülü entegre eder.

İpucu

Büyük görevleri tek bir promptta istemek yerine mimari planlama, backend mantığı, frontend arayüzü ve testler şeklinde aşamalı olarak yönlendirin.

Dikkat Edilecek Nokta

Herhangi bir dosya düzenlemesinden önce projenizde temiz bir Git commit geçmişi olduğundan emin olun; böylece istenmeyen bir değişiklik anında geri alınabilir.

5

Otomatik Birim Testlerin Koşulması, Statik Analiz ve Dağıtım

Geliştirme tamamlandığında Claude Code terminalde birim testlerinizi ve statik analiz (PHPStan / Linter) araçlarını çalıştırır. Eğer başarısız olan bir test assertion'ı çıkarsa hatanın kök nedenini analiz eder, ilgili dosyayı açarak düzeltir ve testler yeşil olana kadar iterasyonu sürdürür.

Son aşamada Dockerfile ve CI/CD GitHub Actions iş akışını güncelleyerek üretim ortamına güvenle dağıtıma hazır hale getirir.

İpucu

Commit mesajlarınızı Claude Code'a conventional commit formatında (feat, fix, refactor, docs) yazdırarak repo geçmişinizi düzenli tutun.

Dikkat Edilecek Nokta

Testlerin yeşil olması manuel kullanıcı deneyimi testlerinin yerini tutmaz; tarayıcıda görsel ve erişilebilirlik kontrollerini mutlaka gerçekleştirin.

Geliştirme Çıktısı: Tam Otonom CI/CD ve Test Kapsamı

Uygulama basamakları tamamlandığında elde edilen nihai çıktı ve çıkarımlar.

Claude Code ve Model Context Protocol (MCP) mimarisi sayesinde geliştirici terminalden hiç ayrılmadan sıfırdan veritabanı şeması, REST API uçları, kapsamlı birim testler ve temiz bir mimari dokümantasyon inşa etti. Hata ayıklama süresi %60 oranında kısalırken, testlerin regresyonları anında yakalaması sayesinde üretim kalitesinde bir web uygulaması başarıyla yayına alındı.

İçindekiler