Picasi MCP sunucusu yanıt vermezse ne yapmalıyım?

Kısa yanıt

Picasi MCP sunucusu yanıt vermiyorsa bunun nedeni çoğunlukla geçersiz bir API token’ı, eski bir yapılandırma dosyası ya da MCP sunucusunun yapay zekâ uygulamasına düzgün bağlanmamış olmasıdır.

Ayrıntılar

Token’ı denetle:

Picasi’de Workspace ayarları → Yapay zekâ bağlantıları sayfasına git ve Aktif erişim token’ları altında token’ın hâlâ orada olup olmadığını ve Son kullanım tarihini denetle. Picasi token’ın kendisini oluşturulduktan sonra bir daha göstermez. Token yoksa ya da değeri artık elinde değilse yenisini oluştur ve .mcp.json dosyandaki ya da yapılandırmandaki değerin yerine koy.

Claude Code’daki yapılandırma dosyasını denetle:

~/.claude.json dosyasını ya da projeye özgü .mcp.json dosyasını aç ve şunları denetle:

PICASI_API_TOKEN doğru ayarlı mı?
Adres (https://picasi.app/mcp) doğru mu?
JSON sözdizimsel olarak doğru mu (eksik virgül yok, yanlış tırnak yok)?

Claude Desktop / ChatGPT (OAuth):

OAuth temelli bağlantılarda oturumun süresi dolmuş olabilir. Picasi’de Kişisel ayarlar → Bağlantılar sayfasını aç ve bağlantının hâlâ orada olup olmadığını denetle. Değilse ya da artık çalışmıyorsa onu geri al ve asistanı ilk seferdeki gibi yeniden bağla.

MCP sunucusunu yeniden yükle:

Claude Code’da: sohbete /mcp yaz ve picasinin bağlı sunucu olarak listelenip listelenmediğini denetle. Değilse uygulamayı yeniden başlat — MCP sunucuları başlangıçta yüklenir.

Başka hiçbir şey çalışmazsa:

Yeni bir API token’ı oluştur, eskisini geri al, tüm yapılandırma dosyalarını güncelle ve yapay zekâ asistanını yeniden başlat.

Başka sık görülen hatalar

Bir araç çağrısında „Permission required“ ya da scope hatası

Çağrılan araç, bağlantıda verilenden yüksek bir scope ister. Örnek: create_source write ister, ama token yalnızca read ile oluşturulmuştur.

API token’ı: Workspace ayarları → Yapay zekâ bağlantıları altında uygun İzin düzeyi ile yeni bir token oluştur ve onu istemciye gir.
OAuth (Claude.ai, ChatGPT): Kişisel ayarlar → Bağlantılar altında var olan bağlantıyı geri al ve yeniden bağlanırken Okuma ve yazma seç.

401 Unauthorized yanıtı

Sunucu geçerli bir token tanıyamadı.

Authorization: Bearer … başlığı eksik mi ya da bearer dizgesi boş mu? İstemci yapılandırmasını denetle.
Claude Code’da: PICASI_API_TOKEN ortam değişkeni yalnızca istemcinin başlatıldığı uçbirimde ayarlı olabilir. Token .mcp.json içinde anılıyorsa onu orada doğrudan ayarla.

403 Forbidden yanıtı

Token geçerlidir, ama istenen kaynak bağlı Workspace’e ait değildir.

Token’ın doğru Workspace için verilip verilmediğini denetle. Workspace’ler arasında geçişte yeni bir token gerekir.

Ağ hataları ya da zaman aşımları

İstek Picasi’ye ulaşmıyor ya da yarıda kesiliyor.

Şirketinin VPN’ini ya da vekil sunucusunu denetle: https://picasi.app/mcp erişilebilir olmalıdır.
Çözümleme isteklerinde (özetler, geri bildirim): yapay zekâ istemcisi yaklaşık 30 saniye sonra zaman aşımına uğrar. Bu çözümlemeler şu anda MCP üzerinden sunulmaz — bunun yerine Report’u Picasi uygulamasında üret ve get_report ile al.

Bağlantı düzenli olarak kopuyor (Claude.ai / ChatGPT)

OAuth erişim token’larının süresi dolar. Picasi bağlantıyı normalde kendiliğinden yeniler; ender durumlarda bağlantı kalıcı olarak yitirilir.

Kişisel ayarlar → Bağlantılar altında bağlantıyı geri al ve asistanı yeniden bağla.
Bilinen sorun: Uzun bir hareketsizlikten sonra (> 15 gün yenilemesiz) bağlantının yeniden yetkilendirilmesi gerekir.

Sunucu sürümü istemciyle uyuşmuyor

Yapay zekâ istemcisi bir protokol sürümü taşıyan bir hata iletisi gösteriyorsa (örneğin unsupported protocol version) istemci büyük olasılıkla fazla eskidir.

İstemciyi güncelle: Claude Code (claude update), Claude Desktop ve ChatGPT, kendi uygulama mağazaları üzerinden.

Bağlantı var, ama veri yok

Uygulamada kaynaklar görünür olduğu hâlde list_sources boş liste döndürüyor.

Doğru Workspace’e bağlı olup olmadığını denetle. Ekip bağlamını get_team_context ile doğrulayabilirsin — team.name alanı o an bağlı Workspace’i gösterir.