SoloTax MCP 1.2.6

AI asistanları için gelir/gider kayıtları, fatura taslakları ve vergi simülasyonları. Node.js 18 veya üzeri gerekir.

Bu paket resmî belge üretmez ve GİB gönderimi yapmaz. Hesaplamalar tahminidir; vergi mevzuatı ve tutarlar mali müşavirle doğrulanmalıdır. Döviz kurları ExchangeRate-API gösterge verisi veya güncel olmayan sabit örnek değerlerdir; resmî TCMB kuru değildir.

Kurulum

{
  "mcpServers": {
    "solotax": {
      "command": "npx",
      "args": ["-y", "[email protected]"]
    }
  }
}

Bulut hesabı için önce npx [email protected] login çalıştırın. sync_account saklı oturumu sunucudan doğrular; user_id veya e-posta ile kimlik oluşturmaz.

Kayıt ve güvenlik

• Proje .solotax-data.json dosyası okunmaz veya yazılmaz.
• Kayıtlar ~/.solotax/accounts/<doğrulanmış-hesap-hash>/data.json içinde tutulur. Oturum doğrulanamazsa ayrı offline-drafts alanı kullanılır.
• Eski ortak ~/.solotax/data.json ve proje kayıtları otomatik aktarılmaz; kaynak dosyalar silinmez. Aktarımda hesap aidiyeti ayrıca doğrulanmalıdır.
• remote_saved: bulut yazımı ve tekrar okuma doğrulandı.
• local_queued: yalnız yerel taslak kaydedildi; otomatik buluta gönderme yoktur.
• failed: kalıcılık doğrulanamadı; araç hata döndürür.
• Mevcut dosya izinleri 0600, dizinler 0700 yapılır; symlink reddedilir.
• Özel SUPABASE_URL, VITE_SUPABASE_URL, SOLOTAX_APP_URL hedefleri reddedilir.
• Yerel okuma/değiştirme/yazma işlemi süreçler arası kilitle korunur. Kilit 5 saniyede alınamazsa işlem hata verir. Çökme sonrası kalan .lock dosyasını yalnız ilgili tüm MCP süreçlerini kapattıktan sonra kaldırın.

Araçlar

| Araçlar | Davranış | |---|---| | get_my_incomes, get_my_expenses, get_my_invoices | Erişilebilen bulut kayıtları ve etkin alanın yerel taslakları | | add_income_entry, add_expense_entry, add_customer, create_invoice | Durumu açıkça belirtilen kayıt/taslak yazımı | | sync_account | Sunucudan oturum doğrulama durumu | | get_financial_overview, get_tax_summary, calculate_full_tax_liability | Kayıtlardan tahmini özet | | calculate_tax, calculate_invoice_with_taxes, simulate_kdv_return | Vergi/KDV/tevkifat/stopaj simülasyonları | | audit_expense, check_currency_rule_180_days | Ayrıca uzman doğrulaması gerektiren örnek mevzuat açıklamaları | | get_exchange_rates | Gösterge veya sabit örnek kurlar | | get_credit_balance | Bulut doğrulanamazsa bilinmeyen bakiye | | topup_credits | Ödeme sayfasına yönlendirir; bakiye değiştirmez | | submit_gib_invoice | Simülasyon; gerçek GİB çağrısı yoktur | | send_to_accountant | Rapor nesnesi hazırlar; e-posta göndermez, UBL arşivi mevcut değildir |

1.2.5 güvenlik temeli

Proje dizini veri birleştirmesi kaldırıldı; hesap alanları ayrıldı; atomik dosya kaydı, gerçek kalıcılık durumları, endpoint kısıtları ve finansal sınır kontrolleri eklendi. Runtime sürümü package.json'dan okunur. Bu sürüm, resmî finansal üretim onayı değildir.

MIT © SoloTax

1.2.6 değişiklikleri

Süreçler arası dosya kilidiyle eşzamanlı MCP yazımlarında kayıt kaybı önlendi; limit ve kur çevrimi üst sınırları doğrulanıyor. Kilit zaman aşımı hata olarak döner.