MCP sunucusu yanıt vermiyor

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 Settings → API Token sayfasına git ve token’ın hâlâ var ve etkin olup olmadığını denetle. Show Token üzerine tıklarsan tam token’ı görürsün. Onu yeniden kopyala 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 Settings → Connected Apps sayfasını aç ve bağlantının hâlâ etkin olup olmadığını denetle. Değilse onu geri al ve Settings → Connect AI Assistant üzerinden 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 (bu, eskisini geçersizleştirir), 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’ı: Settings → API Tokens altında uygun rolde yeni bir token oluştur ve onu istemciye gir.
OAuth (Claude.ai, ChatGPT): Settings → Connected Apps altında var olan bağlantıyı geri al ve yeniden bağlanırken gereken scope’u 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.

Settings → Connected Apps altında bağlantıyı geri al ve Settings → Connect AI Assistant üzerinden yeniden kur.
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.