# MCP Uygulama Plani (Kod Gelistirme Odakli)

Bu planin hedefi:
- MCP'yi once MD tabanli ve guvenli sekilde calisir hale getirmek
- Sonra kod gelistirmeyi hizlandiran tool'lara gecmek

## Faz 1 - MD tabanli temel (1-2 gun)

1. Hedefi sabitle
- Ilk hedef: endpoint degisikligi oncesi etki analizi ve test plani bilgisi almak.

2. Tool spec dosyalarini olustur
- docs/mcp-tools/codebase_map.md
- docs/mcp-tools/endpoint_contract_find.md
- docs/mcp-tools/test_plan_suggest.md

3. MCP servere iki read-only tool ekle
- md_guide_list
- md_guide_get

4. Guvenlik sinirlari
- Sadece docs/mcp-tools klasoru okunur
- Sadece .md dosyalari listelenir/okunur
- Path traversal engeli uygulanir
- Maksimum dosya boyutu limiti uygulanir

5. Dogrulama
- tools/list icinde yeni 2 tool gorunmeli
- md_guide_list en az 3 dosya donmeli
- md_guide_get secilen dosyayi okumali

## Faz 2 - Kod zeka tool'lari (2-4 gun)

1. codebase_map runtime
- Proje klasor agacini ozetler
- Kritik dosyalari vurgular

2. endpoint_contract_find runtime
- method + path ile handler/model/response baglarini bulur

3. test_plan_suggest runtime
- Hedef endpoint/dosya icin test checklisti dondurur

## Faz 3 - Kalite ve olcekleme (1-2 gun)

1. Standart hata modeli
- invalid params
- not found
- internal error

2. Gozlemlenebilirlik
- tool cagrisi sayisi
- basari/hata orani
- yanit suresi

3. Operasyon notlari
- README'de hizli kullanim
- Swagger'da endpoint gorunurlugu

## Bu hafta icin net gorev listesi

1. Plan dosyasi hazir
2. 3 MD spec dosyasi hazir
3. md_guide_list implement
4. md_guide_get implement
5. MCP paket testleri
6. README ornekleri

## Hazirlik tamam olma kriteri

- MCP tools/list cagrisi yeni tool'lari donduruyor
- md_guide_get ile secilen rehber metni geliyor
- Invalid guide adinda temiz hata donuyor
- Kod derleniyor ve testler geciyor