Piyzi MCP Server: işletmenizi yapay zekâ aracınıza bağlayın

Piyzi MCP Server, Piyzi'deki raporlarınızı Claude'a açar. Bağlandıktan sonra “bu ay nasıl gidiyoruz”, “kimler borçlu”, “hangi personel ne kadar ciro yaptı” gibi soruları normal cümlelerle sorar, cevabı Piyzi verilerinizden alırsınız.

Neye erişir, neye erişmez?

Bağlantı yalnızca okuma yapar. Yedi raporu görebilir:

• İşletme genel bakışı — randevu, satış, tahsilat, müşteri ve paket özeti

• Kasa raporu — gelir, gider, net nakit akışı, ödeme yöntemi kırılımı

• Müşteri raporu — borçlular, gelmeyenler, harcamaya göre süzme

• Personel raporu — kişi bazında ciro ve prim

• Ürün stok raporu — eldeki stok, stok değeri, tükenen ürünler

• Paket satış raporu — satılan paketler, tahsilat ve kalan tutar

• Kanal/kaynak raporu — müşterilerin hangi kanaldan geldiği

Bağlantı sizin hesabınıza bağlıdır: Claude, sizin panelde görme yetkiniz olan raporların dışına çıkamaz. Rapor yetkiniz yoksa Claude da o raporu göremez; yetkiniz sonradan kaldırılırsa erişim aynı anda kapanır.

Ön koşullar

• Piyzi hesabınızda ilgili rapor yetkileri (işletme sahibiyseniz hepsi açıktır).

• Claude hesabı — bağlantı ekleme özelliği bulunan bir Claude planı.

• Bağlantıyı hangi işletme için vereceğinizi bilmeniz; birden fazla işletmeniz varsa onay ekranında seçersiniz.

Bağlantıyı kurma

1. Sol menüden Pi Store'u açın.

2. “Piyzi MCP Server” kartına tıklayın.

3. Bağlantıya bir isim verin (örneğin “Ofis bilgisayarım”) ve “Bağlantı Oluştur” düğmesine basın.

4. Ekranda görünen bağlantı anahtarını kopyalayın; bu anahtar yalnızca o an gösterilir.

5. Aynı ekrandaki sunucu adresini kopyalayın.

6. Claude'da bağlantı eklerken sunucu adresini yapıştırın ve istendiğinde Piyzi hesabınızla izin verin.

Her cihaz için ayrı bağlantı

Ofis bilgisayarınız ve dizüstünüz için ayrı bağlantı oluşturmanız önerilir. Bir cihazı kaybettiğinizde yalnız o bağlantıyı iptal edersiniz, diğerleri çalışmaya devam eder. Aynı anda en fazla 10 açık bağlantınız olabilir.

Bağlantıyı iptal etme

1. Pi Store → Piyzi MCP Server ekranını açın.

2. Listeden iptal etmek istediğiniz bağlantının yanındaki çöp kutusu simgesine basın.

3. Onaylayın; erişim o anda kesilir.

Güvenlik

• Bağlantı anahtarı bir paroladır: onu bilen, sizin görebildiğiniz raporları görür. Sohbet gruplarında, ortak belgelerde veya ekran görüntüsünde paylaşmayın.

• Anahtar yalnızca oluşturulduğu anda gösterilir; Piyzi onu geri gösteremez çünkü şifrelenmiş özeti saklanır. Kaybederseniz yeni bağlantı oluşturun.

• Anahtarın yanlış kişiye ulaştığından şüpheleniyorsanız beklemeden iptal edin.

• Raporlar müşteri adı ve tutar gibi kişisel veriler içerir; bağlantıyı yalnızca kendi kullandığınız uygulamalara verin.

Sorun giderme

• Claude “bağlanılamadı” diyor: sunucu adresini eksiksiz kopyaladığınızdan emin olun; adres /mcp ile bitmelidir.

• “Yetkiniz yok” yanıtı geliyor: ilgili rapor yetkiniz kapalı olabilir. İşletme sahibinizden Raporlar yetkisini açmasını isteyin; yetki açılınca yeni bağlantı kurmanıza gerek kalmaz.

• Rakamlar panelden farklı görünüyor: tarih aralığını kontrol edin. Claude'a “bu ay” dediğinizde içinde bulunduğunuz ayın başından bugüne, “geçen ay” dediğinizde önceki ayın tamamı gelir; paneldeki filtreyle aynı aralığı seçtiğinizde sayılar birebir aynıdır.

• Üç farklı “alacak” rakamı görüyorum: üçü farklı şeyi ölçer ve toplanmazlar. Genel bakıştaki “bekleyen alacak” vadesi tanımlı ödeme kayıtlarıdır; paket satış raporundaki “kalan tutar” yalnız o dönemde satılan paketlerin tahsil edilmemiş kısmıdır; müşteri raporundaki “toplam borç” ise iptal edilmemiş adisyonların kapanmamış bakiyesidir.

• Personel raporunda herkes sıfır görünüyor: ciro yalnızca personeli atanmış işlemlerden hesaplanır. Paket veya ürün satışında personel seçilmediyse tutar hiçbir satıra yansımaz; bu, işletmenin cirosu olmadığı anlamına gelmez.

• Çok fazla istek uyarısı: art arda çok soru sorulduğunda dakikalık sınır devreye girer. Bir dakika bekleyip devam edin.

• Yanlış işletmenin verisi geliyor: bağlantı, izin verirken seçtiğiniz işletmeye bağlıdır. Diğer işletme için ayrı bir bağlantı oluşturun.