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

Piyzi MCP Server, Piyzi'deki raporlarınızı Claude, ChatGPT gibi MCP (Model Context Protocol) destekleyen yapay zekâ araçlarına 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, ritminden sapan ve kayıp müşteriler, güvenilirlik ve 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 ve işletmenize bağlıdır: yapay zekâ aracı, sizin panelde görme yetkiniz olan raporların dışına çıkamaz. Genel bakış için rolünüzde Özet ekranını görebilir, diğer altı rapor için Raporları görebilir yetkisi gerekir; işletme sahibinde hepsi açıktır. Yetkiniz sonradan kaldırılırsa erişim aynı anda kapanır.

Ön koşullar

• Yukarıdaki rapor yetkileri.

• MCP sunucusu (özel bağlayıcı) eklemeyi destekleyen bir yapay zekâ aracı; Claude'da bağlantı ekleme özelliği bulunan bir plan.

• Pi Store'daki Piyzi MCP Server penceresini açmak için rolünüzde Entegrasyonları görebilir yetkisi. Anahtar oluşturma, bağlantılarınızı görme ve iptal etme bu pencereden yapılır ve ayrıca bir yetki istemez; herkes yalnız kendi bağlantılarını görür. Piyzi hesabınızla izin vererek bağlanmak bu yetkiyi istemez, ama bağlantıyı panelden iptal edebilmek için pencereye erişmeniz gerekir.

Pencerede neler var?

İşletmem → Pi Store sayfasında Yapay Zekâ başlığı altındaki Piyzi MCP Server kartına tıklayın. Pencerede yukarıdan aşağıya şunlar bulunur:

• Kullanılabilir araçlar: yapay zekâ aracınızın çağırabileceği yedi raporun listesi.

• Yeni bağlantı: anahtarla bağlanırken bağlantıya isim verdiğiniz alan ve Bağlantı Oluştur düğmesi.

• Kurulum bilgileri: Sunucu adresi (https://api.piyzi.com/mcp) ve yanındaki kopyalama simgesi.

• Bağlantılarınız: bu işletmede açık bağlantılarınızın tablosu. Sütunlar İsim, Anahtar (anahtarın ilk karakterleri), Son kullanım (hiç kullanılmadıysa “Hiç kullanılmadı”) ve İşlem (iptal için çöp kutusu). Bağlantı yoksa “Henüz bağlantı oluşturmadınız.” yazar.

İki bağlanma yolu

Aracınız hangisini destekliyorsa onu kullanın. Claude'un özel bağlayıcı ekranı gibi yalnız sunucu adresi soran araçlarda Piyzi hesabınızla izin verirsiniz (1. yol); bu yolda anahtar gerekmez. İstek başlığı (header) girmenize izin veren araçlarda bağlantı anahtarını kullanırsınız (2. yol). Penceredeki sunucu adresinin altında yazan “yetkilendirme başlığına bağlantı anahtarınızı girin” notu 2. yol içindir.

1. yol: Piyzi hesabınızla izin vererek bağlanma

1. 1

   Sunucu adresini kopyalayın

   Piyzi MCP Server penceresindeki Kurulum bilgileri bölümünde, Sunucu adresi satırındaki adresi yanındaki simgeyle kopyalayın: https://api.piyzi.com/mcp.

2. 2

   Aracınızda bağlantı ekleyin

   Yapay zekâ aracınızda (örneğin Claude'da) özel bağlayıcı ya da MCP sunucusu eklerken bu adresi yapıştırın. Anahtar girmeyin.

3. 3

   Piyzi'de izin verin

   Aracınız sizi Piyzi'nin Bağlantı izni sayfasına yönlendirir. Piyzi'de oturumunuz açık değilse önce giriş yaparsınız, ardından bu sayfaya dönersiniz. Sayfada bağlantının neler yapabileceği yazar. Birden fazla işletmeniz varsa Hangi işletme için izin veriyorsunuz? listesinden işletmeyi seçin ve İzin Ver'e basın. Reddet bağlantıyı başlatmadan aracınıza döner.

4. 4

   Aracınıza dönün

   İzin verince aracınıza geri yönlendirilirsiniz; bağlantı hazırdır. Şifreniz araca hiç girilmez.

• Bu yolla kurulan bağlantı, izin verdiğiniz işletmenin Piyzi MCP Server penceresinde Bağlantılarınız tablosunda aracın adıyla (örneğin “Claude”) görünür; iptali oradan yaparsınız.

• Bağlantı 90 gün geçerlidir. Süre dolunca araç Piyzi'ye erişemez; aracınızda bağlantıyı yeniden kurup tekrar izin verin. Süresi dolan bağlantı tabloda kalmaya devam eder; çöp kutusuyla kaldırabilirsiniz.

2. yol: Bağlantı anahtarıyla bağlanma

1. 1

   Bağlantıya isim verin

   Yeni bağlantı alanına bağlantıyı tanıyacağınız bir isim yazın (örneğin “Ofis bilgisayarım”, en fazla 80 karakter) ve Bağlantı Oluştur'a basın. İsim boşsa “Lütfen bağlantıya bir isim verin.” uyarısı çıkar.

2. 2

   Anahtarı kopyalayın

   Yeşil Bağlantı anahtarınız hazır kutusunda pmcp_live_ ile başlayan anahtarı Kopyala ile alın ve güvenli bir yerde saklayın. Anahtar yalnız bu kez gösterilir; pencereyi kapattığınızda bir daha görüntülenemez.

3. 3

   Aracınıza girin

   Aracınızın MCP sunucusu ayarında adres olarak https://api.piyzi.com/mcp yazın ve istek başlığına (header) şunu ekleyin: Authorization: Bearer <bağlantı anahtarınız>.

• Anahtarla kurulan bağlantının süresi dolmaz; siz iptal edene kadar çalışır.

• Anahtar, oluşturduğunuz sırada panelde seçili olan işletmenin verilerine erişir. Başka bir işletme için o işletmeye geçip ayrı bir anahtar oluşturun.

• Aynı işletmede 10 açık bağlantınız olduğunda (izin vererek kurulanlar da sayılır) yeni anahtar oluşturulamaz ve “En fazla bağlantı sayısına ulaştınız. Önce kullanmadığınız bir bağlantıyı iptal edin.” uyarısı çıkar.

Her cihaz ya da araç için ayrı bağlantı

Ofis bilgisayarınız, dizüstünüz ya da farklı araçlarınız için ayrı bağlantı oluşturmanız önerilir. Birini kaybettiğinizde yalnız o bağlantıyı iptal edersiniz, diğerleri çalışmaya devam eder.

Bağlantıyı iptal etme

1. 1

   Pencereyi açın

   İşletmem → Pi Store → Piyzi MCP Server penceresini açın.

2. 2

   Çöp kutusuna basın

   Bağlantılarınız tablosunda iptal etmek istediğiniz bağlantının İşlem sütunundaki çöp kutusu simgesine basın.

3. 3

   Onaylayın

   “Bağlantı iptal edilsin mi?” penceresinde İptal Et ile onaylayın (Vazgeç hiçbir şeyi değiştirmez). Erişim o anda kesilir ve bağlantı tablodan kalkar.

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 yalnız tek yönlü özet olarak sakladığı için bir daha gösteremez. Kaybederseniz yeni bağlantı oluşturun.

• Anahtarın ya da bağlantını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 araçlara verin.

Sorun giderme

• Araç “bağlanılamadı” diyor: sunucu adresini eksiksiz kopyaladığınızdan emin olun; adres /mcp ile bitmelidir. Anahtarla bağlanıyorsanız başlığın “Authorization: Bearer ” ile başladığını ve anahtarın iptal edilmediğini kontrol edin.

• “Bu izin isteği geçersiz veya eksik.” sayfası: izin sayfası yalnız aracınızın başlattığı bağlantıyla çalışır. Bağlantıyı aracınızdan yeniden başlatın.

• Bağlantı bir süre sonra çalışmayı bıraktı: izin vererek kurulan bağlantının 90 günlük süresi dolmuş ya da bağlantı iptal edilmiş olabilir. Aracınızda bağlantıyı yeniden kurun.

• “Yetkiniz yok” yanıtı geliyor: ilgili rapor yetkiniz kapalı olabilir. Genel bakış için Özet ekranını görebilir, diğer raporlar için Raporları görebilir yetkisini işletme sahibinizden isteyin; yetki açılınca yeni bağlantı kurmanıza gerek kalmaz.

• Rakamlar panelden farklı görünüyor: tarih aralığını kontrol edin. Araca “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ı: her bağlantı dakikada en fazla 120 istek yapabilir; art arda çok soru sorulduğunda bu sınır devreye girer. Bir dakika bekleyip devam edin.

• Yanlış işletmenin verisi geliyor: bağlantı, izin verirken seçtiğiniz ya da anahtarı oluştururken panelde seçili olan işletmeye bağlıdır. Diğer işletme için ayrı bir bağlantı kurun.