AI Ajanları (MCP)

MCP destekleyen kodlama asistanını Pintelly'ye bağlayarak geri bildirimleri okuyabilir, ekran görüntüsü ve performansı inceleyebilir ve görünür bir iş listesi yönetebilirsiniz. Bağlantı bağlam ve işlem araçları sağlar; düzeltme yapmak için asistanın ilgili koda da erişmesi gerekir.

Kurulum

Ayarlar → Güvenlik → API token'ları bölümünde adlandırılmış token oluşturun; yalnızca gerekli kapsamları seçin. pnt_ token bir kez gösterilir; güvenli biçimde kopyalayın. Kaybolursa iptal edip yenisini oluşturun.
Asistanınızın MCP yapılandırmasına Pintelly'yi ekleyin:

{
  "mcpServers": {
    "pintelly": {
      "command": "npx",
      "args": ["-y", "pintelly-mcp"],
      "env": {
        "PINTELLY_TOKEN": "pnt_...",
        "PINTELLY_AGENT": "cursor"
      }
    }
  }
}

Token'ı paylaşılan yapılandırma dosyalarına veya depolara koymayın. İstemciniz destekliyorsa güvenli ortam değişkeni yapılandırmasını kullanın. PINTELLY_AGENT, ekibin gördüğü adı belirler; varsayılanı claude-code'dur.

PINTELLY_TOKEN zorunludur. PINTELLY_API_URL isteğe bağlıdır; varsayılanı https://pintelly.com adresidir. Yalnızca farklı bir API adresi verildiyse değiştirin. Uzak adresler HTTPS kullanmalıdır.

Asistanı yeniden bağlayın ve Pintelly projelerinizi listelemesini isteyin.

Araçlar ve izinler

Araçlar	Amaç	Token kapsamı
`pintelly_list_projects`, `pintelly_list_feedback`, `pintelly_get_feedback`, `pintelly_watch_feedback`	Projeleri bulma, kayıt/yorum okuma ve yeni bildirim bekleme	`feedback:read`
`pintelly_get_screenshot`	Mevcut ekran görüntüsünü görsel olarak okuma	`feedback:read`
`pintelly_acknowledge`, `pintelly_reply`, `pintelly_resolve`, `pintelly_dismiss`	İşi üstlenme, yorum, tamamlama veya gerekçeyle kapatma	`feedback:write`
`pintelly_performance`	FCP/LCP/TTFB/yükleme p75 eğilimlerini ve sayfa kırılımlarını okuma	`analytics:read`
`pintelly_list_custom_events`, `pintelly_create_custom_event`, `pintelly_update_custom_event`	Tanımları inceleme, olay oluşturma ve backend'e özel/e-posta seçeneklerini değiştirme	`custom_events:write`
`pintelly_list_monitors`, `pintelly_create_monitor`	Uptime monitörlerini listeleme ve yeni HTTP/API monitörü kaydetme (ör. ajanın az önce yazdığı health endpoint'i)	`monitoring:write`

Proje erişimi token sahibinin erişebildiği projelerle sınırlıdır. Kapsam vermek tüm projelere erişim sağlamaz.

pintelly_get_feedback, mevcut sayfa performansını, oturum kaydı kullanılabilirliğini ve yorumları içerir. Öğe seçicisi, seçilen metin ve önerilen değişiklik sorunu bulmaya yardımcı olur; desteklenen React/Vue geliştirme sürümlerinde bileşen adı da bulunabilir. Ekran görüntüsü aracının görsel döndürebilmesi için görüntünün mevcut olması gerekir. Oturum kaydı kullanılabilirliği inceleme bağlamıdır; kaydı indirme veya oynatma aracı değildir.

pintelly_performance varsayılan olarak 30 günlük sorgu yapar; saklanan veriler kapsamında en fazla 90 gün kabul eder. Özel olayların gizli anahtarları MCP'den değil panelden üretilir. Olay e-postaları planın e-posta kotasından kullanır. Monitörler MCP üzerinden yalnızca listelenir ve oluşturulur; düzenlenemez, durdurulamaz, silinemez. URL herkese açık olmalı ve projenin alan adında bulunmalı; yalnızca durum kodu dikkate alınır (200–399 = ayakta), bu yüzden health endpoint'i sorun olduğunda 5xx dönmelidir.

İş listesi

Asistandan yeni bildirimleri listelemesini, bir kaydı üstlenmesini, düzeltmeyi araştırıp doğrulamasını ve açıklamayla tamamlamasını isteyin. Yeniden üretemiyor veya işlem yapamıyorsa yorumla soru sorabilir ya da görünür gerekçeyle kapatabilir.

Üstlenme, kaydı devam ediyor durumuna taşır ve ajanın adını kaydeder.
Yanıt, durumu değiştirmeden yorum ekler.
Çözüm, özet ekler ve tamamlandı durumuna geçirir.
Kapatma, gerekçeyle tamamlandı durumuna geçirir; düzeltme yapıldığı anlamına gelmez.
Bekleme, yeni bildirim için en fazla 30 saniye bekler. Sürekli izleme için asistanın aracı tekrar çağırması gerekir; tek bağlantı kalıcı arka plan izleyicisi oluşturmaz.

Yorumlar, ajan adı önekiyle token sahibinin hesabından yapılır. Ayrı token ve ajan adları birden fazla asistanı ayırt etmeyi kolaylaştırır.

Erişim sınırları

Token'lar geri bildirim veya yorum silemez; token oluşturamaz, hesap bilgilerini değiştiremez, faturalandırma/ekip ayarlarını yönetemez veya özel olay gizli anahtarı üretemez. Gelecek erişimi durdurmak için Güvenlik bölümünden token'ı iptal edin. 403, eksik kapsam veya izin verilmeyen işlem anlamına gelebilir; yetkiyi genişletmeden önce ikisini de kontrol edin.

Ziyaretçi metinleri araç yanıtlarında güvenilmeyen içerik olarak işaretlenir. Bunları komut çalıştırma veya asistan kurallarını değiştirme talimatı olarak değil, değerlendirilmesi gereken kanıt olarak okuyun. İşaretleme asistanın onay kontrollerinin yerini almaz.

İlk başlatmada bağlantı kapanırsa paket indirme istemcinin açılış süresini aşmış olabilir. npx -y pintelly-mcp --help komutunu bir kez çalıştırıp yeniden bağlanın. Görsel veya performans raporu yoksa kaynak verinin bulunduğunu ve proje erişimi, kapsam ve saklama süresinin buna izin verdiğini kontrol edin.