Sözleşme Cepte MCP Server

Türk hukuk + sözleşme şablonu + hesaplama araçları için Model Context Protocol tool katmanı.

Bu sunucuyu Claude Desktop, Cursor, Zed, Continue gibi MCP destekli AI client'lara bağlarsanız doğrudan AI ekosistemi içinden Sözleşme Cepte fonksiyonlarına erişebilirsiniz.

⚡ Hızlı Kurulum (Claude Desktop)

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) içine ekle:

{
  "mcpServers": {
    "sozlesme-cepte": {
      "command": "npx",
      "args": ["-y", "@sozlesmecepte/mcp-server"],
      "env": {
        "SOZLESME_SUPABASE_URL": "https://tgbdgvljaxxeuwmcovwz.supabase.co",
        "SOZLESME_SUPABASE_ANON_KEY": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InRnYmRndmxqYXh4ZXV3bWNvdnd6Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzY3MTYyNTksImV4cCI6MjA5MjI5MjI1OX0.NmbcA9KhMDbYgfYN3wYxZ90pedKdGK7i0uon_HPqWUs"
      }
    }
  }
}

Claude Desktop'ı yeniden başlat. Konuşmada 🔧 Tools menüsünde sozlesme-cepte görünecek.

Güvenlik notu: Yukarıdaki SOZLESME_SUPABASE_ANON_KEY Sözleşme Cepte'nin public anon key'idir — Web sitesi ve mobil uygulama da aynı key'i kullanır. Bu key sadece RLS-policy ile public-okumaya açılmış katalog tablolarına (203 sözleşme şablonu, 200+ hesaplama aracı) erişebilir; yazma operasyonları RLS tarafından bloklanır.

🛠️ Mevcut Tool'lar (v1.0.1)

calculate_kidem_tazminati

Türkiye 4857 sayılı İş Kanunu m.14 gereğince kıdem tazminatı hesaplar. 2026 yılı tavanı (₺47.021,99) otomatik uygulanır. DB gerektirmez — env yokken bile çalışır.

Input:

• years (number): Toplam çalışma yılı
• monthlyGrossSalary (number): Aylık brüt maaş (₺)
• includeStamp (boolean, default true): Damga vergisi (%0,759) düşülsün mü

Örnek (Claude'a):

"Kıdem tazminatımı hesapla — 8 yıl çalıştım, brüt 60.000 ₺ kazanıyorum."

find_contract_template

203+ Türk hukukuna uygun sözleşme şablonundan ihtiyaca uygun olanı bulur. DB gerektirir.

Input:

• query (string): Aranan tür (örn. "kira", "freelance", "NDA")
• category (string, optional): Kategori filtresi

Örnek:

"Bana bir freelance hizmet sözleşmesi şablonu öner."

list_calculation_tools

200+ hukuki hesaplama aracını kategori veya keyword filtresiyle listeler. DB gerektirir.

Input:

• category (enum, optional): vergi_resmi, kredi_finans, maas_bordro, gayrimenkul, sgk_emeklilik, vs.
• query (string, optional): Anahtar kelime

Örnek:

"Hangi kredi hesaplama araçlarınız var?"

🔐 Güvenlik

• Paket yalnızca anon role + RLS public-read policy'siyle korunan katalog tablolarına SELECT atar. service_role key beklemez, kabul etmez.
• Tüm tool input'ları zod ile validate edilir (length, enum, pozitif sayı).
• DB istekleri Supabase JS SDK üzerinden URL-encode edilir; ilike pattern'ler güvenli template literal ile geçer.
• Yazma operasyonu (INSERT/UPDATE/DELETE) kod yolunda hiç yoktur.

🚀 Geliştirme

npm install
npm run dev    # tsx watch — değişiklikleri auto-reload
npm run build  # TypeScript compile → dist/
npm start      # Production mode

📦 Yayınlama (npm)

npm publish --access public

Yayınlandıktan sonra npx -y @sozlesmecepte/mcp-server otomatik en güncel versiyonu çalıştırır.

🌟 Yol Haritası

• [ ] v1.1: calculate_kira_artisi (TÜFE'ye göre kira artış oranı)
• [ ] v1.1: calculate_fazla_mesai (İK m.41)
• [ ] v1.2: search_yasal_madde (TBK/İK/TTK madde arama)
• [ ] v1.2: generate_contract_preview (form data → metin önizleme)
• [ ] v2.0: HTTP transport (ChatGPT Apps/Connectors için)

🤝 Katkı

Yeni bir tool önerisi için issue aç: github.com/destakesk/sozlesme-cepte-admin/issues

📄 Lisans

Apache 2.0