Kullanıcıların ürününüzde ne yaptığını AI asistanınıza sorun

Altı adım, çoğu kendi PostHog ayarlarınızda. Baştan bilmeniz gereken iki şey: anahtar size özeldir ve yalnızca bir kez gösterilir; PostHog'u kendi sunucunuzda çalıştırıyorsanız adresine internetten ulaşılabilmesi gerekir.

1. 1

   PostHog Cloud mu, kendi sunucunuz mu, belirtin

   PostHog Cloud, posthog.com'a giriş yaparak kullandığınız sürümdür. Kendi sunucunuz seçeneğini yalnızca şirketinizde biri PostHog'u sizin sunucunuza kurduysa seçin.

   Hangi bölgede (ABD ya da AB) olduğunuz sorulmaz. Her anahtar tek bir bölgeye aittir ve diğer bölge onu tanımaz; HeyMetra doğru bölgeyi anahtardan anlar.

2. 2

   Kendi sunucunuzsa adresini not edin

   PostHog'u açtığınız adres, örneğin analytics.sirketiniz.com. PostHog Cloud kullanıyorsanız bu kutu görünmez.

3. 3

   Settings → Kişisel API anahtarı (Personal API key)s'i açın

   Projenin ayarlarında değil, kendi hesap menünüzün altındadır. Kişisel API anahtarı tek bir projeye değil size aittir ve erişebildiğiniz bütün projeleri görür.

   PostHog kişi başına on kişisel anahtara izin verir. Başka bir yerde kullandığınız anahtarı paylaşmak yerine HeyMetra için ayrı bir anahtar oluşturun; sonradan iptal ettiğinizde başka hiçbir şey etkilenmez.

4. 4

   Okuma izinleriyle bir anahtar oluşturun

   Bütün izinleri vermek yerine tek tek seçin. Okuma için Projects, Insights, Queries ve Events gerekir; PostHog bunları `project:read`, `insight:read`, `query:read` ve `event:read` olarak gösterir. AI asistanınızın değişiklik önermesini istemiyorsanız yazma izinlerini kapalı bırakın.

   Bir izin eksikse PostHog hata verir ve hangi iznin eksik olduğunu yazar; tahmin etmeniz gerekmez, o izni ekleyip sorunu çözersiniz.

5. 5

   Anahtarı hemen kopyalayın

   Anahtar `phx_` ile başlar ve yalnızca bir kez gösterilir. Sayfayı yenilerseniz bir daha göremezsiniz; o durumda tek çözüm yeni bir anahtar oluşturmaktır.

6. 6

   HeyMetra'ya yapıştırıp bağlantıya bir ad verin

   Bağlantılar ekranında PostHog'u seçin, anahtarı yapıştırın, gerekiyorsa adresi yazın ve bağlantıya 'PostHog' değil, ürününüzün adını verin. Anahtar şifreli saklanır ve bir daha gösterilmez; HeyMetra kaydetmeden önce anahtarın çalıştığını kontrol eder.

Sonra HeyMetra'yı AI asistanınıza ekleyin

Claude ChatGPT Grok Perplexity Claude Code Codex Cursor Antigravity

Bilinen dört sorun var. PostHog'un reddettiği bir anahtar genellikle doğru anahtardır ama yanlış adrese girilmiştir. Diğerleri ya PostHog'un adını söylediği eksik bir izindir ya da sizinle paylaşılmamış bir projedir.

Anahtarı doğru kopyaladığınız halde reddediliyor.

Adres yanlış. AB bölgesinde oluşturulan bir anahtarı ABD sunucusu tanımaz; şirketin kendi sunucusunda oluşturulan bir anahtarı ise ikisi de tanımaz. Her üç durumda da sorun adreste olduğu halde anahtar hatalıymış gibi görünür.

PostHog'a giriş yapın, tarayıcının adres çubuğundaki adrese bakın ve bağlantıyı buna göre düzenleyin.

PostHog kendi sunucunuzda çalışıyor ve internetten erişilemiyor.

HeyMetra sunucunuza kendi sunucularından bağlanır. Yalnızca şirket ağınızın içinden ya da VPN ile açılan bir adrese biz ulaşamayız.

İnternetten erişilebilen bir adreste çalışan bir kurulum bağlayın. Bu kısıtı aşmak için kurulabilecek bir araç yok.

Bağlantı kuruldu ama bir soru izin hatası veriyor.

Anahtar, o sorunun gerektirdiği izin verilmeden oluşturulmuş. Kullanıcı hareketlerini okumak ve özel bir sorgu çalıştırmak ayrı izinlerdir; biri çalışırken diğeri çalışmayabilir.

Eksik izni PostHog'da ekleyin (hata mesajı hangisi olduğunu yazar) ya da okuma izinleriyle yeni bir anahtar oluşturup bağlantının yanındaki kalem simgesiyle eskisinin yerine yapıştırın. Bağlantının adı ve diğer ayarları olduğu gibi kalır.

Ürünlerinizin yalnızca bir kısmı görünüyor.

Kişisel API anahtarı yalnızca sizin erişebildiğiniz projeleri görür. Başkasına ait ve sizinle paylaşılmamış bir proje bunlardan biri değildir.

PostHog'da o projeye eklenmeyi isteyin, sonra proje listesinin güncellenmesi için yeniden bağlayın.