Web-Oberfläche

Eine komplett lokale Chat-Oberfläche, die Photoshop über den MCP-Server steuert. Ein Befehl, und dein Browser öffnet sich — keine IDE nötig.

Starte mit einem Befehl

$npx -p @alisaitteke/photoshop-mcp photoshop-mcp-ui

Ein lokaler Server startet auf 127.0.0.1 (zufälliger freier Port), und dein Standardbrowser öffnet die Chat-Oberfläche automatisch.

Wähle einen Anbieter

Beim ersten Start wählst du einen aus — mit API-Schlüssel oder deinem bestehenden CLI-Abo-Konto (Anthropic und Google).

Anbieter	Modelle	API-Schlüssel	CLI-Konto
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	—
Google	Gemini 2.5 Pro / Flash / Flash-Lite	aistudio.google.com	`npm i -g @google/gemini-cli → gemini auth login`
OpenRouter	100+ models	openrouter.ai	—

Zwei Wege zur Authentifizierung

API-SchlüsselStandard

Vercel AI SDK mit deinem Anbieter-Schlüssel. Die Nutzung wird pro Token zu API-Preisen abgerechnet; die Oberfläche zeigt die geschätzten Kosten pro Chat.

Uses your account (dein Konto nutzen)Im Abo enthalten

Nutzt deine lokale OAuth-Sitzung von Claude Code oder Gemini CLI wieder. Es wird kein API-Schlüssel gespeichert; die Nutzung wird auf dein Abo-Kontingent angerechnet statt per API abgerechnet.

Du kannst die Auth-Methode pro Anbieter in den Settings wechseln, ohne die anderen Zugangsdaten zu verlieren — behalte einen API-Schlüssel, während du das CLI-Konto ausprobierst, und wechsle später zurück.

Was beim ersten Start passiert

Wähle einen Anbieter und entscheide dich für API-Schlüssel oder Uses your account.
Validiere den Schlüssel oder prüfe die CLI-Verbindung. Die Konfiguration wird lokal unter ~/.photoshop-mcp/data.db gespeichert (SQLite, chmod 600) — Schlüssel verlassen deinen Rechner nie.
Gib Prompts in natürlicher Sprache ein. Die Oberfläche streamt die Antwort des Modells, führt Photoshop-Tool-Aufrufe in Echtzeit aus und zeigt jeden Aufruf als einsehbare Karte (Eingabe + Ergebnis).
Wechsle Anbieter, Auth-Methode oder Modell jederzeit über Settings oder den Modellselektor — Chats, Kosten und Tool-Verlauf bleiben über Sitzungen hinweg erhalten.

Action PlanBeta

Ein optionaler Ausführungsmodus für die API-Schlüssel-Auth. Statt einer Modell-→-Tool-Schleife pro Schritt erstellt ein einziger Planungsaufruf eine geordnete Todo-Liste von Photoshop-Tool-Aufrufen, die direkt nacheinander ausgeführt werden.

Ein Planungsaufruf erstellt eine geordnete Todo-Liste von Photoshop-Tool-Aufrufen.
Die Tools werden direkt nacheinander ausgeführt — keine zusätzlichen Modell-Roundtrips zwischen den Schritten.
Bei einem fehlgeschlagenen Schritt plant eine begrenzte Reparaturschleife nur die verbleibenden Schritte neu (bis zu 3-mal).

Standardmäßig aus — aktiviere ihn neben dem Modellselektor. Ideal für mehrstufige Prompts wie „Hintergrund entfernen und fürs Web exportieren“, mit weniger Modellaufrufen und schnellerer End-to-End-Ausführung.

Auth später wechseln

Öffne jederzeit die Settings in der Seitenleiste.

Aktion	API-Schlüssel-Modus	CLI-Konto-Modus
Einrichten	Schlüssel einfügen → Save	CLI installieren → auth login → Check connection
Wegwechseln	API-Schlüssel wählen — der gespeicherte Schlüssel bleibt erhalten	Uses your account wählen — der Schlüssel wird nicht gelöscht
Eigene Binary	—	Optionaler CLI-Pfad, falls claude / gemini nicht im PATH liegt
Kostenanzeige	Pro-Token-Schätzung in der Statusleiste	Badge „Im Abo enthalten“

Die Auth-Methode wird pro Anbieter in ~/.photoshop-mcp/data.db gespeichert — bestehende Konfigurationen funktionieren unverändert weiter.

CLI-Flags

$photoshop-mcp-ui [--port 5174] [--host 127.0.0.1] [--no-open]

Sicherheit der lokalen API

Der UI-Server hält deine Anbieter-Schlüssel und kann Photoshop steuern — deshalb durchläuft jede /api/*-Anfrage drei Prüfungen:

Host — muss die Loopback-Adresse (oder der per --host gebundene Host) auf dem Port des Servers sein. Blockt DNS-Rebinding.
Origin — muss, falls vorhanden, mit dem eigenen Origin der Oberfläche übereinstimmen. Blockt Cross-Origin-Aufrufe aus dem Browser.
Session-Token — ein zufälliges Geheimnis pro Serverstart. Blockt andere lokale Prozesse, die beliebige Header fälschen können, das Token aber nicht lesen können.

Der Browser muss sich nicht um das Token kümmern — der Server fügt es in die ausgelieferte Seite ein. Für Skripte: Lies es aus ~/.photoshop-mcp/ui-session.json und sende es als Header:

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> funktioniert ebenfalls. Setze PSMCP_UI_TOKEN vor dem Serverstart, um ein bekanntes Token festzulegen; Anfragen ohne gültiges Token erhalten 401 unauthorized.

Umgebungsvariablen

PHOTOSHOP_PATH — eigener Photoshop-Installationspfad (optional)
LOG_LEVEL — Logging-Level (0=DEBUG, 1=INFO, 2=WARN, 3=ERROR)
PSMCP_UI_TOKEN — das Session-Token der Web UI festlegen
ANALYTICS_DISABLED — auf 1 oder true setzen, um anonyme Nutzungsstatistiken komplett zu deaktivieren
POSTHOG_DISABLED — Legacy-Alias für ANALYTICS_DISABLED
RYBBIT_API_KEY / RYBBIT_HOST / RYBBIT_SITE_ID — optionale Analytics-Überschreibungen für Forks oder Staging

Probleme?

401-Fehler, Verbindungsprobleme und Fixes für das CLI-Konto findest du auf der Fehlerbehebungsseite.

Fehlerbehebung öffnen