Web arayüzü
Photoshop’u MCP sunucusu üzerinden yöneten, tamamen yerel bir sohbet arayüzü. Tek komut ve tarayıcınız açılır — IDE gerekmez.
Tek komutla başlayın
npx -p @alisaitteke/photoshop-mcp photoshop-mcp-ui127.0.0.1 üzerinde yerel bir sunucu başlar (rastgele boş bir port) ve varsayılan tarayıcınız sohbet arayüzünü otomatik olarak açar.
Bir sağlayıcı seçin
İlk açılışta birini seçin — API anahtarıyla ya da mevcut CLI abonelik hesabınızla (Anthropic ve Google).
| Sağlayıcı | Modeller | API anahtarı | CLI hesabı |
|---|---|---|---|
| Anthropic | Claude Sonnet / Opus / Haiku | console.anthropic.com | npm i -g @anthropic-ai/claude-code → claude auth login |
| OpenAI | GPT-5, GPT-4.1, o-series | platform.openai.com | — |
| Gemini 2.5 Pro / Flash / Flash-Lite | aistudio.google.com | npm i -g @google/gemini-cli → gemini auth login | |
| OpenRouter | 100+ models | openrouter.ai | — |
Kimlik doğrulamanın iki yolu
Settings üzerinden, diğer kimlik bilgisini kaybetmeden sağlayıcı başına kimlik doğrulama yöntemini değiştirebilirsiniz — CLI hesabını denerken API anahtarını saklayın, sonra geri dönün.
İlk açılışta ne olur
- Bir sağlayıcı seçin ve API anahtarı ya da Uses your account seçeneğini belirleyin.
- Anahtarı doğrulayın veya CLI bağlantısını kontrol edin. Yapılandırma yerel olarak ~/.photoshop-mcp/data.db altında saklanır (SQLite, chmod 600) — anahtarlar makinenizden asla çıkmaz.
- Doğal dilde istemler yazın. Arayüz modelin yanıtını akış halinde gösterir, Photoshop araç çağrılarını gerçek zamanlı çalıştırır ve her çağrıyı incelenebilir bir kart olarak (girdi + sonuç) gösterir.
- Sağlayıcıyı, kimlik doğrulama yöntemini veya modeli istediğiniz zaman Settings ya da model seçiciden değiştirin — sohbetler, maliyetler ve araç geçmişi oturumlar arasında korunur.
API anahtarı kimlik doğrulaması için isteğe bağlı bir yürütme modu. Adım adım model → araç döngüsü yerine, tek bir planlama çağrısı sırayla çalıştırılacak Photoshop araç çağrılarından oluşan sıralı bir yapılacaklar listesi oluşturur.
- Tek bir planlama çağrısı, Photoshop araç çağrılarından oluşan sıralı bir yapılacaklar listesi oluşturur.
- Araçlar doğrudan sırayla çalışır — adımlar arasında ek model gidiş-dönüşü olmaz.
- Başarısız bir adımda, sınırlı bir onarım döngüsü yalnızca kalan adımları yeniden planlar (en fazla 3 kez).
Varsayılan olarak kapalı — model seçicinin yanındaki anahtarla açın. “arka planı kaldır ve web için dışa aktar” gibi çok adımlı istemler için idealdir; daha az model çağrısı ve daha hızlı uçtan uca yürütme sağlar.
Kimlik doğrulamayı sonra değiştirme
İstediğiniz zaman kenar çubuğundan Settings’i açın.
| İşlem | API anahtarı modu | CLI hesabı modu |
|---|---|---|
| Kurulum | Anahtarı yapıştır → Save | CLI’yı kurun → auth login → Check connection |
| Geçiş | API anahtarını seçin — saklanan anahtar korunur | Uses your account’ı seçin — anahtar silinmez |
| Özel binary | — | claude / gemini PATH üzerinde değilse isteğe bağlı CLI yolu |
| Maliyet gösterimi | Durum çubuğunda token başına tahmin | Aboneliğe dahil rozeti |
Kimlik doğrulama yöntemi, sağlayıcı başına ~/.photoshop-mcp/data.db içinde saklanır — mevcut yapılandırmalar değişmeden çalışmaya devam eder.
CLI bayrakları
photoshop-mcp-ui [--port 5174] [--host 127.0.0.1] [--no-open]Yerel API güvenliği
Arayüz sunucusu sağlayıcı anahtarlarınızı tutar ve Photoshop’u yönetebilir; bu yüzden her /api/* isteği üç kontrolden geçer:
- Host — sunucunun portunda geri döngü (loopback) adresi (veya --host ile belirttiğiniz adres) olmalıdır. DNS rebinding’i engeller.
- Origin — varsa, arayüzün kendi origin’i ile eşleşmelidir. Farklı kaynaktan gelen tarayıcı çağrılarını engeller.
- Oturum token’ı — her başlatmada üretilen rastgele bir gizli değer. Herhangi bir başlığı taklit edebilen ancak token’ı okuyamayan diğer yerel süreçleri engeller.
Tarayıcının token ile uğraşması gerekmez — sunucu, sunduğu sayfaya token’ı kendisi ekler. Betik kullanımı için token’ı ~/.photoshop-mcp/ui-session.json dosyasından okuyun ve bir başlık olarak gönderin:
TOKEN=$(node -p "require('$HOME/.photoshop-mcp/ui-session.json').token")
curl -H "x-psmcp-token: $TOKEN" http://127.0.0.1:5174/api/statusAuthorization: Bearer <token> da çalışır. Bilinen bir token sabitlemek için sunucuyu başlatmadan önce PSMCP_UI_TOKEN ayarlayın; geçerli token taşımayan istekler 401 unauthorized alır.
Ortam değişkenleri
PHOTOSHOP_PATH— özel Photoshop kurulum yolu (isteğe bağlı)LOG_LEVEL— günlük seviyesi (0=DEBUG, 1=INFO, 2=WARN, 3=ERROR)PSMCP_UI_TOKEN— Web arayüzü oturum token’ını sabitlerANALYTICS_DISABLED— anonim kullanım analitiğini tamamen devre dışı bırakmak için 1 veya true yapınPOSTHOG_DISABLED— ANALYTICS_DISABLED için eski takma adRYBBIT_API_KEY / RYBBIT_HOST / RYBBIT_SITE_ID— fork’lar veya staging için isteğe bağlı analitik geçersiz kılmaları
Sorun mu yaşıyorsunuz?
401 hataları, bağlantı sorunları ve CLI hesabı çözümleri sorun giderme sayfasında.