zirve-finansman-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ZIRVE_PORT | No | TCP portu. Instance adı yazdıysanız gerekmez. | |
| ZIRVE_USER | Yes | Salt okunur SQL kullanıcısı. | |
| ZIRVE_FIRMA | No | Varsayılan firma. Zirve giriş ekranındaki "Firma Tanıtıcı Adı". | |
| ZIRVE_SERVER | Yes | Sunucu adresi veya HOST\INSTANCE. Zorunlu. | |
| ZIRVE_PASSWORD | Yes | Salt okunur SQL kullanıcısının parolası. | |
| ZIRVE_QUERY_TIMEOUT | No | Sorgu zaman aşımı, saniye cinsinden. Varsayılan 30. | 30 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Zirve Finansman genel muhasebe verilerine SALT-OKUNUR erişim. Her firma+yıl ayrı bir veritabanıdır; önce firmalari_listele ile firma/yıl seçin. Temel kavramlar: hesap planı (hesplan), fiş başlığı (fisbil, anahtar Refno), yevmiye satırı (yevmiye, anahtar Refno+Refno2). Tip: B=borç, C=alacak. Fistur: 0=açılış, 1=tahsil, 2=tediye, 3=mahsup, 9=kapanış (ayrıca 4=yansıtma, 5=enflasyon düzeltmesi fişlerinde görülür). Dovizadi: 1=TL, 2=USD, 3=EUR (boş=TL); Doviz alanı döviz tutarıdır, Borclu/Alacakli her zaman TL. Belge_Turu: 1=fatura, 8=diğer (adı Belge_Turu_Aciklamasi alanındadır, ör. banka ekstresi), 9=belge yok; diğer kodların ve Odeme_Sekli kodlarının anlamı doğrulanmamıştır, ham kod olarak yorumlayın. Evrakno fatura/belge numarasıdır ve dış sistemlerle eşleştirme için en iyi anahtardır; Vergino karşı tarafın VKN/TCKN'sidir. Hesap kodlarında ayırıcı çoğunlukla '.' olsa da ',' ve '-' içeren kodlar vardır; kodu olduğu gibi kullanın. Tarihler YYYY-AA-GG biçimindedir. mizan ve muavin, Zirve'nin varsayılanı gibi kapanış fişini saymaz (kapanis_dahil ile değişir). Demirbaş (sabit kıymet) kartları yıldan bağımsızdır: demirbas_ara ve demirbas_getir.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| firmalari_listeleB | Zirve'deki firmaları listeler: yillar yevmiye kaydı bulunan, bos_yillar veritabanı olup boş olan yıllar. |
| hesap_araA | Hesap planında arama yapar (cari hesaplar dahil; ör. 120=alıcılar, 320=satıcılar). arama: hesap adında geçen metin (büyük-küçük harf ve Türkçe karakter ayrımı gözetmez). kod_on_eki: hesap kodu başlangıcı (ör. "120" veya "320.01"). vergi_no: hesaba tanımlı VKN/TCKN. sadece_detay: yalnızca kayıt girilebilen alt hesaplar. Hesap kartlarının çoğunda VKN boştur; vergi_no ile sonuç çıkmazsa yevmiye_ara(vergi_no=..., hesap_on_eki="120" veya "320") ile carinin hesap kodunu yevmiye satırlarından bulun. |
| mizanA | Mizan: hesap bazında borç/alacak toplamları ve bakiye (yevmiye satırlarından hesaplanır). kod_on_eki: yalnızca bu kodla başlayan hesaplar (ör. "120"). baslangic/bitis: fiş tarihi aralığı (boşsa tüm yıl; açılış fişi 1 Ocak tarihlidir). seviye: "detay" (alt hesap) veya "ana" (ilk 3 hane). Bakiye = Borc - Alacak (pozitif borç bakiyesi). toplam alanı sayfalamadan bağımsız genel toplamdır. kapanis_dahil: Zirve'nin "kapanış fişi hariç" mizanı gibi, varsayılan olarak kapanış fişi (Fistur 9) sayılmaz; True verilirse kapanmış yıllarda tüm bakiyeler sıfırlanır. |
| muavinA | Muavin (hesap ekstresi): tek bir hesabın hareketleri ve yürüyen bakiyesi. hesap_kodu: tam hesap kodu (ör. "120.00010"; hesap_ara ile bulunur). baslangic verilirse o tarihten önceki hareketler "devreden" olarak özetlenir. Bakiye pozitifse borç, negatifse alacak bakiyesidir. kapanis_dahil: mizan ile tutarlı olsun diye kapanış fişi (Fistur 9) varsayılan olarak sayılmaz; True verilirse kapanmış yılda kapanış bakiyesi sıfır çıkar. Ana hesap ya da olmayan kod verilirse hata döner. |
| yevmiye_araA | Yevmiye satırlarında arama yapar; dış sistem kayıtlarını Zirve'de bulmak için ana araçtır. evrak_no: fatura/belge numarasında geçen metin. vergi_no: satırdaki VKN/TCKN (tam eşleşme). aciklama: satır açıklamasında geçen metin (büyük-küçük harf ve Türkçe karakter ayrımı gözetmez). hesap_on_eki: hesap kodu başlangıcı (ör. "120", "600"). tutar_min/tutar_max: satırın TL tutarı (borç veya alacak); tam tutar için ikisine aynı değeri verin. baslangic/bitis: fiş tarihi aralığı. En az bir filtre verin. |
| fisleri_listeleA | Muhasebe fişlerinin başlıklarını listeler (en son kaydedilen önce). baslangic/bitis: fiş tarihi aralığı. kayit_tarihinden_sonra: kayıt zamanı (Kayittarihi) bu andan sonra olan fişler; YYYY-AA-GG ya da saatle YYYY-AA-GG SS:DD:SS. "Son kontrolden beri ne girildi" sorusu için. fis_no: fiş numarası (baştaki sıfırlar olmadan da verilebilir). kullanici: fişi kaydeden Zirve kullanıcısı (Ozkod). Btop/Atop fişin borç/alacak toplamıdır. Satırlar için fis_getir kullanın. |
| fis_getirA | Tek bir muhasebe fişini başlığı ve yevmiye satırlarıyla getirir (satırlar sayfalıdır). refno: fişin Refno değeri (yevmiye_ara, muavin ve fisleri_listele sonuçlarında bulunur). satir_sayisi fişteki toplam satırdır; devami_var ise sonraki_offset ile devam edin. Not: Zirve'de bir fiş düzeltildiğinde Refno değişir; kalıcı referans olarak Fisno kullanın. |
| demirbas_araA | Demirbaş (sabit kıymet) kartlarında arama yapar. Kartlar yıldan bağımsızdır, yil parametresi yoktur. arama: demirbaş adında geçen metin. kod_on_eki: demirbaş kodu başlangıcı (çoğu kurulumda kod, demirbaşın muhasebe hesap koduyla aynıdır; ör. "253", "254.01"). durum: "hepsi", "aktif" (satılmamış) veya "satilan". alis_baslangic/alis_bitis: alış tarihi aralığı. toplam alanı sayfalamadan bağımsız adet ve alış tutarıdır. HesapKodu demirbaşın muhasebe hesabıdır; hareketleri için muavin(hesap_kodu=...) kullanın. |
| demirbas_getirA | Bir demirbaş kartını yıllık değerleme ve amortisman satırlarıyla getirir. kod: demirbaş kodu (demirbas_ara sonucundaki Kod). yillar: her yıl için dönem başı değer, yeniden değerleme, dönem amortismanı (DonemAmortismani), birikmiş amortisman ve devreden net değer. Dikkat: yıllık satırları Zirve, Demirbaşlar > Raporlar ekranı çalıştırıldığında üretir; bazı yıllar eksik ya da güncel olmayabilir. Kesin tutar için muhasebe kaydına (muavin) bakın. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
The tools mostly target distinct resources and actions: company listing, voucher headers, voucher detail, journal-line search, account search, trial balance, ledger, and fixed assets. There is some potential overlap among fisleri_listele, yevmiye_ara, and fis_getir, and between mizan and muavin, but the descriptions clarify header/line/detail and balance/statement scopes.
Most names follow a readable Turkish object_action pattern in snake_case, such as firmalari_listele, hesap_ara, yevmiye_ara, and fis_getir. The bare report nouns mizan and muavin are minor deviations but still fit the accounting domain.
Nine tools is well-scoped for a finance/accounting query server, with each tool covering a distinct reporting or lookup need. There is no obvious redundant or bloated tool surface.
The surface covers core read-only finance workflows: companies, voucher listing/detail/search, account search, trial balance, ledger, and fixed assets. It lacks write operations and broader finance modules such as invoice or current-account management, but as a reporting/query MCP it is largely complete.