trkit
GitHub
Menü

AI ile geliştirme

Claude Code

trkit projelerinde Claude Code kullanımı; CLAUDE.md, MCP sunucusu ve örnek iş akışları.

.mdChatGPT'de açClaude'da aç

create-trkit-app ile oluşturulan projeler Claude Code için hazırdır; ek ayar gerekmez.

Hazır gelenler

CLAUDE.md: Claude Code her oturumda bu dosyayı okur. trkit'in CLAUDE.md dosyası @AGENTS.md satırıyla proje kurallarını içe aktarır. Claude'a özel talimatlarınızı bu dosyaya, tüm araçlarda geçerli olanları AGENTS.md'ye yazın.

.mcp.json: trkit MCP sunucusu proje kapsamında tanımlıdır:

.mcp.json
{
  "mcpServers": {
    "trkit": { "command": "npx", "args": ["-y", "@trkit-app-pack/mcp"] }
  }
}

Projeyi Claude Code'da ilk açtığınızda bu sunucuyu onaylamanız istenir. Bağlı sunucuları /mcp komutuyla görebilirsiniz.

Başlarken

cd benim-sitem
claude

İlk istek olarak şirket bilgilerini doldurtabilirsiniz:

trkit.config.ts dosyasını şu bilgilerle doldur: unvan "Örnek Gıda Ltd. Şti.",
MERSİS 0123456789000015, adres "...", telefon "0212 ...", e-posta "info@...".
Site Vercel'de barınıyor. Sonra npx trkit check çalıştır ve kalan uyarıları açıkla.

MCP'yi elle eklemek

trkit dışında oluşturulmuş bir projede:

# Yalnızca bu proje için, ekip arkadaşlarıyla paylaşılır (.mcp.json'a yazar)
claude mcp add --scope project trkit -- npx -y @trkit-app-pack/mcp

# Tüm projeleriniz için
claude mcp add --scope user trkit -- npx -y @trkit-app-pack/mcp

# Kendi yayınladığınız uzak sunucu
claude mcp add --transport http trkit https://<sunucunuz>/mcp

Önerilen iş akışı

  1. Planla: Büyük işlerde önce plan isteyin: "iyzico entegrasyonu için plan çıkar, trkit_guide odeme rehberine uy."
  2. Bileşeni ekle: Claude npx trkit add odeme komutunu çalıştırır veya trkit_get_files aracıyla dosyaları alır.
  3. Doğrula: "npm run build çalıştır ve hataları düzelt." AGENTS.md bunu zaten ister.
  4. Gözden geçir: Ödeme ve yasal metin değişikliklerini kendiniz kontrol edin.

İpuçları

  • Uzun oturumlarda Claude'a "AGENTS.md'deki trkit kurallarını hatırla" demek bağlamı tazeler.
  • Yeni bir trkit sürümüne geçtiğinizde Claude'a "trkit_list ile yeni bileşenleri kontrol et" diyebilirsiniz.
  • Tekrarlayan işler için .claude/commands/ altında kendi slash komutlarınızı yazabilirsiniz, örneğin yeni bir yasal sayfa ekleyip footer'a bağlayan bir komut.