Kısa cevap: Hesapİz yapay zekâ asistanına nasıl bağlanır?
Profil sayfanızdaki MCP anahtarları bölümünden kişisel bir anahtar oluşturur, bu anahtarı ve Hesapİz’in MCP adresini kullandığınız asistanın ayarına yazarsınız. Bağlantıdan sonra “Borçlularımız kimler?” veya “Ahmet’in telefonu ne?” gibi soruları yazarak sorarsınız; asistan cevabı Hesapİz’deki güncel kayıtlarınızdan okur. Bağlantı yalnız okuma yapar: kayıt eklemez, değiştirmez, silmez.
MCP (Model Context Protocol), yapay zekâ asistanlarının bir uygulamadaki veriye kontrollü araçlar üzerinden erişmesini sağlayan açık bir bağlantı standardıdır. Hesapİz bu standart üzerinden altı okuma aracı sunar. Asistan sorunuzu anlar, uygun aracı çağırır ve gelen sonucu size Türkçe olarak özetler. Şifreniz hiçbir yapılandırma dosyasına yazılmaz; bağlantı yalnız iptal edebileceğiniz kişisel anahtarla kurulur.
Asistan hangi soruları cevaplayabilir?
Günlük durum aracı, uygulamadaki Günlük Durum ekranının özetini verir: kasa ve banka toplamları, bugün TL kasalara giren ve çıkan para, toplam, vadesi geçmiş ve bugün vadesi gelen alacak ve borçlar. “Bugün durumumuz nasıl?” sorusu için uygundur.
Borçlu müşteriler aracı, size borçlu olan carileri en yüksek bakiyeden başlayarak listeler; isterseniz sizin borçlu olduğunuz tedarikçileri de getirir. Müşteri arama aracı ad, telefon, e-posta, vergi veya kimlik numarasıyla arar. Telefonu “0532 123 45 67”, “+90 532 1234567” ya da boşluksuz yazmanız fark etmez. Müşteri detay aracı ise bir carinin iletişim ve vergi bilgilerini, cari bakiyesini ve açık satış ve alış belgelerini vadeleriyle verir.
Kasa bakiyeleri aracı her kasa ve banka hesabının bakiyesini ve para birimi başına toplamı gösterir. Farklı para birimleri birbirine eklenmez. Vadesi geçenler aracı, vadesi geçmiş, bugün veya önümüzdeki yedi gün içinde vadesi gelecek tahsilat ve ödemeleri gecikme gün sayısıyla listeler.
Tutarlar uygulamadaki gibi Türk biçimiyle gelir, örneğin 1.234,56 TL. “Size borçlu” ifadesi müşterinin firmanıza borcunu, “siz borçlusunuz” ifadesi firmanızın o cariye borcunu anlatır. Asistanın yorumları sizin kayıtlarınızdan türetilir; kayıtta olmayan bir bilgiyi uydurmasını önlemek için sorunuzu müşteri adı, tarih veya tutar gibi açık bilgilerle sormanız iyi sonuç verir.
Yetkiler ve güvenlik
Her anahtar, oluşturan kullanıcıya ve o kullanıcının firmasına bağlıdır. Anahtar, kullanıcının Hesapİz’deki yetkilerinden fazlasını açmaz. Örneğin yalnız Kasalar modülünü görebilen bir personel, asistanda da yalnız kasa araçlarını görür; müşteri araçları onun için listelenmez. Başka bir firmanın kaydı hiçbir araçtan dönmez.
Anahtar yalnız oluşturulduğu anda bir kez gösterilir; sistemde anahtarın kendisi değil, geri çevrilemeyen bir özeti saklanır. Kullanıcı pasifleştirilirse, başka firmaya geçerse ya da firmanın abonelik süresi biterse anahtar kendiliğinden çalışmaz. Her araç çağrısı kim, hangi araç ve ne zaman bilgileriyle kayda geçer. Sorduğunuz arama metni bu kayda yazılmaz. Bir anahtarla dakikada en fazla 60 istek yapılabilir.
Anahtarı bir şifre gibi koruyun: e-postayla göndermeyin, sohbet ekranına yapıştırmayın, ekran görüntüsünde göstermeyin. Bilgisayarınızı değiştirdiğinizde veya anahtarın başkasının eline geçtiğinden şüphelendiğinizde profil sayfasından İptal et düğmesine basın ve yenisini oluşturun. Her cihaz için ayrı anahtar oluşturmanız, birini iptal ettiğinizde diğerlerini etkilememenizi sağlar.
Hangi asistanlarla çalışır?
Hesapİz’in MCP sunucusu internet üzerinden HTTP ile çalışır ve kimliği her istekte gönderilen kişisel anahtarla doğrular. Bu yüzden yapılandırmasına özel başlık eklenebilen istemcilerle doğrudan çalışır: Claude Code, Cursor ve Visual Studio Code bu başlığı kendi ayarlarında kabul eder. Claude Desktop, uzak sunuculara ücretsiz ve açık kaynaklı mcp-remote köprüsüyle bağlanır; bunun için bilgisayarınızda Node.js kurulu olmalıdır.
Claude’un web arayüzündeki özel bağlayıcılar ve ChatGPT’nin bağlayıcıları uzak sunuculara OAuth ile oturum açarak bağlanır. Hesapİz şimdilik kişisel anahtar yöntemini kullandığı için bu iki web arayüzü bağlantı kuramaz. Bu durumda aynı hesabı masaüstü veya geliştirici araçlarından kullanabilirsiniz.
Claude Desktop yapılandırma örneği
Claude Desktop’ta Ayarlar → Geliştirici → Yapılandırmayı düzenle yolunu izleyerek claude_desktop_config.json dosyasını açın. mcpServers bölümüne hesapiz adında bir sunucu ekleyin. Komut alanına npx, argümanlara sırasıyla -y, mcp-remote, https://hesapiz.com/mcp, --header ve Authorization:${HESAPIZ_ANAHTAR} yazın. Aynı sunucunun env bölümüne HESAPIZ_ANAHTAR adıyla “Bearer ” ve ardından anahtarınızı yazın. Bearer ile anahtar arasında bir boşluk bulunmalıdır.
Dosyayı kaydedip Claude Desktop’ı tamamen kapatıp yeniden açın. Sohbet kutusunun altındaki araçlar listesinde hesapiz sunucusunu ve altı aracı görürsünüz. Asistan bir aracı ilk kez çağırırken izin isteyebilir; okuma araçları olduklarını görerek onaylayabilirsiniz.
Claude Code, Cursor ve VS Code
Claude Code kullanıyorsanız terminalde claude mcp add komutunu --transport http seçeneğiyle, hesapiz adıyla ve https://hesapiz.com/mcp adresiyle çalıştırın; --header seçeneğine “Authorization: Bearer” ve anahtarınızı verin. Komuttan sonra /mcp yazarak bağlantının durumunu görebilirsiniz.
Cursor’da proje veya kullanıcı düzeyindeki mcp.json dosyasına, VS Code’da ise mcp.json yapılandırmasına url alanı https://hesapiz.com/mcp olan bir sunucu ekleyin. headers bölümüne Authorization anahtarıyla “Bearer” ve anahtarınızı yazın. VS Code’da tür alanını http olarak seçin. Anahtarı paylaşılan bir proje dosyasına yazmak yerine bu araçların sunduğu gizli değişken veya ortam değişkeni özelliğini kullanmanız, anahtarın kod deposuna girmesini önler.
Sık karşılaşılan durumlar
Asistan “Geçersiz veya iptal edilmiş MCP anahtarı” cevabı alıyorsa anahtar eksik kopyalanmış, Bearer kelimesi unutulmuş ya da anahtar iptal edilmiş olabilir. “Abonelik süreniz bitmiş” cevabı, firmanızın aboneliği yenilenene kadar bağlantının kapalı kalacağını gösterir. Abonelik uzatıldığında aynı anahtar yeniden çalışır.
Bir araç listede görünmüyorsa kullanıcınızın ilgili modülde görüntüleme yetkisi yoktur; firma sahibi Çalışanlar ekranından yetkiyi düzenleyebilir. Asistan yanlış müşteriyi seçtiyse sorunuzu müşteri numarasıyla tekrar sorun; musteri_ara sonucundaki numara her müşteri için tektir.
Adım adım
Profil sayfasını açın
Sağ üstteki hesap menüsünden Profil sayfasına girin ve MCP anahtarları bölümünü bulun. Bölümde sunucu adresi https://hesapiz.com/mcp olarak yazılıdır.
Anahtar oluşturun
Anahtar adı alanına cihazı tanıtan bir ad yazın, örneğin “Claude – ofis bilgisayarı”, ve Anahtar oluştur düğmesine basın.
Anahtarı hemen kopyalayın
Sarı kutuda görünen ve hzm_ ile başlayan anahtarı kopyalayın. Sayfayı yenilediğinizde tekrar gösterilmez; kaybederseniz iptal edip yenisini oluşturursunuz.
Asistanı yapılandırın
Kullandığınız asistanın ayarına sunucu adresini ve “Authorization: Bearer” başlığıyla anahtarınızı yazın, ardından asistanı yeniden başlatın.
İlk sorunuzu sorun
“Hesapİz’e göre bugün durumumuz nasıl?” yazın. Asistan Günlük Durum aracını çağırıp kasa, alacak ve borç özetini getirir.
Kullanmadığınız anahtarları iptal edin
Profil sayfasındaki listede her anahtarın son kullanım zamanı görünür. Kullanmadığınız veya şüphelendiğiniz anahtarı İptal et ile kapatın.
Sık sorulan sorular
Asistan Hesapİz’de kayıt oluşturabilir veya silebilir mi?
Hayır. Bağlantıdaki bütün araçlar yalnız okur. Satış, tahsilat, müşteri veya kasa kaydı eklemek, değiştirmek ya da silmek için uygulamayı kullanmaya devam edersiniz.
Şifremi asistana vermem gerekir mi?
Hayır. Bağlantı yalnız profil sayfasında oluşturduğunuz kişisel anahtarla kurulur. Şifreniz hiçbir yapılandırma dosyasına yazılmaz; anahtarı istediğiniz an iptal edebilirsiniz.
Personelim de anahtar oluşturabilir mi?
Evet. Her kullanıcı kendi anahtarını oluşturur ve anahtar o kişinin modül yetkileriyle sınırlı kalır. Yetkisi olmayan modülün aracı onun asistanında görünmez.
Verilerim yapay zekâ şirketine gider mi?
Asistanın sorduğu araç sonucu, kullandığınız asistan hizmetine iletilir ve o hizmetin gizlilik koşullarına tabidir. Bu nedenle yalnız güvendiğiniz hizmeti bağlayın ve ihtiyacınız olmayan soruları sormayın.