Sorun giderme

Yaygın aksaklıkları çözün: bağlantı, betikler, Web arayüzü kimlik doğrulaması. Aşağıdaki hızlı kontrollerle başlayın.

Önce hızlı kontroller

Photoshop kurulu ve açık — sunucu onu başlatabilir, ancak açık bir örnek olası nedenlerin yarısını eler.
MCP istemci yapılandırmanız doğru sunucuyu gösteriyor — Başlangıç bölümündeki parçacıkla karşılaştırın.
Web arayüzü sekmeleri: CLI’ın yazdırdığı tam URL’den yeniden yükleyin — sunucu yeniden başlatması boyunca açık kalan bir sekme eski bir token taşır.

Yaygın sorunlar

“Photoshop bulunamadı”

Neden: Photoshop varsayılan kurulum konumunda değil, bu yüzden sunucu binary’yi bulamıyor.

Çözüm:

Photoshop’un varsayılan konumda kurulu olduğundan emin olun veya istemci yapılandırmanızda PHOTOSHOP_PATH ile sunucuyu özel bir yola yönlendirin:

mcp config

{
  "env": {
    "PHOTOSHOP_PATH": "C:\\Custom\\Path\\Adobe Photoshop 2025\\Photoshop.exe"
  }
}

“Photoshop’a bağlanılamadı”

Neden: Photoshop çalışmıyor ya da betik desteği engellenmiş.

Çözüm:

Photoshop’un çalıştığından emin olun — sunucu onu başlatmayı dener, ancak çalışan bir örnek daha hızlı ve güvenilir bağlanır.
Photoshop tercihlerinde betik desteğinin etkin olduğunu kontrol edin.
Windows’ta COM otomasyonunun güvenlik ayarları tarafından engellenmediğini doğrulayın.

Web arayüzü: /api/* yolundan 401 unauthorized

Neden: Her /api/* isteği, arayüz sunucusu başlatıldığında üretilen oturum token’ını sunmalıdır. Tarayıcı bunu otomatik olarak alır; eski sekmeler ve harici betikler alamaz.

Çözüm:

Tarayıcıda: sayfayı photoshop-mcp-ui tarafından yazdırılan URL’den yeniden yükleyin.
Bir betikten: token’ı ~/.photoshop-mcp/ui-session.json dosyasından okuyun ve başlık olarak gönderin:

terminal

TOKEN=$(node -p "require('$HOME/.photoshop-mcp/ui-session.json').token")
curl -H "x-psmcp-token: $TOKEN" http://127.0.0.1:5174/api/status

Authorization: Bearer <token> da çalışır. Bilinen bir token sabitlemek için sunucuyu başlatmadan önce PSMCP_UI_TOKEN ayarlayın.

Web arayüzü: 403 invalid_host veya invalid_origin

Neden: Token kontrolünden önce iki koruma çalışır: invalid_host, Host başlığının sunucunun portunda geri döngü adresine çözümlenmediği anlamına gelir (bu, DNS rebinding’i engeller); invalid_origin ise isteğin arayüzün kendi origin’inden farklı bir kaynaktan geldiği anlamına gelir.

Çözüm:

Arayüzü CLI’ın yazdırdığı tam URL üzerinden açın (http://127.0.0.1:<port>) — yalnızca makinenizi gösteren bir alan adıyla değil ve başka bir portta sunulan bir sayfadan değil.

photoshop_execute_script “Result: undefined” döndürüyor

Neden: ExtendScript, sunucu tarafında bir IIFE sarmalayıcısı içinde çalışır. Açık bir return olmadan blok undefined olarak değerlendirilir — yan etkiler (katman yeniden adlandırmaları, özellik değişiklikleri) yine de uygulanmış olabilir.

Çözüm:

Betiğinize açık bir return ekleyin:

photoshop_execute_script

photoshop_execute_script({
  code: `
    app.activeDocument.activeLayer.name = "Updated";
    return { ok: true };
  `
})

Ayrıntılar için Kullanılabilir araçlar bölümündeki photoshop_execute_script kısmına bakın.

“Betik yürütme zaman aşımı”

Neden: Varsayılan zaman aşımı 30 saniyedir ve büyük belgeler işlemleri bunun ötesine taşıyabilir.

Çözüm:

Karmaşık işlemleri daha küçük adımlara bölün ve sırayla çalıştırın.

Web arayüzü: CLI hesabı kimlik doğrulaması

Web arayüzünde Claude Code / Gemini CLI hesabı modunu kullanırken görülen belirtiler.

Belirti	Olası neden	Çözüm
cli_not_found	Claude Code / Gemini CLI kurulu değil	npm i -g @anthropic-ai/claude-code veya npm i -g @google/gemini-cli
not_authenticated	CLI OAuth oturumu yok (API anahtarı / SDK kimlik doğrulaması sayılmaz)	Terminal’de claude auth login veya gemini auth login çalıştırın ya da API anahtarı kimlik doğrulamasına geçin
SDK istemcisi çalışıyor, arayüzde CLI modu başarısız	SDK/API kimlik bilgileri CLI OAuth’tan ayrıdır	Web arayüzünde API anahtarı kullanın ya da CLI modu için claude auth login ile giriş yapın
claude / gemini PATH üzerinde değil	Özel kurulum konumu	Settings → CLI path → Check connection
Sohbet IDE’de çalışıyor ama arayüzde çalışmıyor (CLI modu)	OAuth token’ları yalnızca CLI’ya özeldir	Arayüzde CLI hesabını kullanın; API anahtarları ve CLI oturumları ayrıdır
Gemini çok turlu sohbette unutkan hissettiriyor	Headless CLI her turda yeni bir oturum başlatabilir	Bilinen sınırlama; geçmiş isteme başa eklenir (MVP)

Hata ayıklama günlüğü

İstemci yapılandırmanızda LOG_LEVEL=0 ile ayrıntılı günlük kaydını etkinleştirin:

mcp config

{
  "env": {
    "LOG_LEVEL": "0"
  }
}

Hâlâ takıldınız mı?

Mevcut sorunları arayın veya yeni bir sorun açın — hata ayıklama günlüğüyle yakalanan kayıtlar çok yardımcı olur.

GitHub sorunları Topluluk tarifleri