Photoshop Full MCP v2

Photoshop Full MCP v2 ist ein lokaler, Capability-gesteuerter MCP-Server für Photoshop. Er richtet sich an das installierte Photoshop 2026 (27.9) und vermeidet Annahmen über Version und Installationspfad.

Schnellstart für Windows

Voraussetzungen: Windows 10/11, Photoshop 24 oder neuer, Node.js 20 oder neuer sowie Codex Desktop oder das Codex-CLI. Photoshop 2026 (27.9) ist der Referenz-Host.

1. Laden Sie photoshop-full-mcp-v2.0.1-windows.zip aus dem neuesten Release herunter und entpacken Sie es. Die danebenliegenden signierten Manifest und Signaturen authentifizieren künftige In-App-Updates; die .sha256-Datei ist eine optionale Korruptionsprüfung.

2. Öffnen Sie PowerShell im extrahierten Ordner photoshop-full-mcp-2.0.1 und führen Sie Folgendes aus:

   powershell -NoProfile -ExecutionPolicy Bypass -File .\Install.ps1

   Der Installer verifiziert die gebündelte Laufzeitumgebung, installiert sie unter %LOCALAPPDATA%\PS_MCP und registriert einen separaten photoshop_full_mcp-Server. Der Checkout- und Download-Ordner wird danach nicht mehr benötigt.

3. Doppelklicken Sie auf die enthaltene photoshop-full-mcp-v2.0.1.ccx, um das Photoshop-Plugin zu installieren. Falls keine CCX-Installation möglich ist, verwenden Sie Adobe UXP Developer Tools und wählen das von der Diagnose gemeldete installierte Manifest.

4. Starten Sie Codex neu, öffnen Sie Photoshop und wählen Sie dann Plugins > Photoshop Full MCP Bridge.

5. Rufen Sie in Codex photoshop_pairing_begin auf, geben Sie den vollständigen port-code-Wert ein, der im vertrauenswürdigen Windows-Dialog im Photoshop-Panel angezeigt wird, und rufen Sie photoshop_host_describe auf. Eine Antwort mit bridge.connected: true ist der erste Erfolgs-Check.

Führen Sie Doctor jederzeit aus:

powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\PS_MCP\app\tools\Doctor.ps1"

Der Standard-Genehmigungsmodus ist automatisch. Normale Bearbeitungsbefehle erfordern keine einzeln bestätigten Genehmigungsklicks. Die bebilderte Windows-Installationsanleitung und der Fehlerbehebungsleitung enthalten Schritte für Update, Entfernung und Wiederherstellung.

Es wird nicht behauptet, dass jede Photoshop-UI-Funktion skriptbar ist. Der Katalog unterscheidet:

• supported: implementiert und durch ein Live-Photoshop-Fixture auf dem Zielhost nachgewiesen

• experimental: abhängig von Berechtigungen, Modell, Netzwerk oder Credits

• requires_user: erzeugt einen nicht blockierenden Auftrag mit expliziten nativen Menüanweisungen, die der Nutzer ausführen muss; er automatisiert keine Betriebssystemklicks

• unverified: erfasst, aber blockiert, bis eine lokale Fixture besteht

• unavailable: kein zuverlässiger Desktop-UXP-Vertrag bekannt

Related MCP server: Photoshop MCP Server

Architektur

• MCP-Server: Node.js/TypeScript über stdio

• Photoshop-Bridge: UXP-Manifest-v5-Panel über authentifiziertes 127.0.0.1

• Discovery: Ports 38452 bis 38462

• Pairing: kurzwertiges 128-Bit-port-code-Capability, das nur in einem vertrauenswürdigen lokalen Windows-Dialog aufgerufen wird, der von photoshop_pairing_begin geöffnet wird

• Ausführung: Schema-Validierung, Capability/Risiko-Richtlinie, FIFO-Warteschlange, executeAsModal, eine Historie-Gruppierung und Vorher/Nachher-Zustandsverifizierung

• Genehmigungen: standardmäßig automatisch; bereichsgebundene Einmal-Tokens, Replay-Schutz, Pfadlimits und erweiterte Descriptor-Callowlisten bleiben erzwungen

• Standard-Dateibridge: Export und eingeschränkte wiederholtes Öffnen verwenden den Server-eigenen Ordner %LOCALAPPDATA%\PS_MCP\exports ohne Dateiauswahldialog; ein benutzergewählter persistenter UXP-Ordner bleibt optional

• Erweitertes raw batchPlay: standardmäßig versteckt; setzen Sie PS_MCP_ADVANCED=confirm, um nur die parameterfreien Descriptoren deselect und invert verfügbar zu machen. Andere raw Deskriptoren und alle rohen JSX werden abgelehnt, bevor sie Photoshop erreichen

• Telemetrie: keine

Die breite Feature-Inventarliste befindet sich in catalog/features.json. Ausführbare Verträge liegen in catalog/commands.json.

Aktueller Audit-Zustand: 101 Befehlskontrakte (87 supported, 1 experimental, 0 unverified, 11 requires_user, 2 unavailable) und 52 Feature-Gruppen (21 supported, 1 experimental, 0 unverified, 10 requires_user, 20 unavailable). Ein Befehl oder eine Feature-Gruppe wird erst nach Bestehen der signierten Live-Fixtur von Photoshop 27.9 auf supported gesetzt. Ungültige, ererbte Generative-Fill- und Neural-Filter-Deskriptoren sind ausdrücklich nicht verfügbar, und falsch formatierte oder nicht-allowlistierte raw Deskriptoren werden serverseitig abgelehnt, sodass sie den Dialog für unbekannte Befehle von Photoshop nicht öffnen können.

Serviceinstallation aus dem Quellcode

Die Installation über das Release-ZIP oben wird empfohlen. Mitwirkende können stattdessen das Repository klonen und ausführen:

npm ci --no-audit --no-fund
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\Install-Local.ps1

Der Kompatibilitäts-Wrapper kompiliert einmalig, kopiert eine eigenständige Produktions-Laufzeitumgebung nach %LOCALAPPDATA%\PS_MCP und registriert diese installierte Kopie. Das spätere Verschieben oder Löschen des Quell-Checkouts unterbricht den MCP-Server nicht. Der Installer registriert photoshop_full_mcp neben einem vorhandenen photoshop_mcp; er entfernt das alte Paket nicht und bearbeitet es nicht.

Für das UXP-Plugin führen Sie npm run uxp:package aus und installieren Sie die generierte CCX, oder Sie laden das in Doctor gemeldete installierte Manifest in Adobe UXP Developer Tools. Optional können Sie einen Exportordner im Panel auswählen. Ohne einen solchen verwendet document.export den authentifizierten, servereigenen Standard-Exportordner.

Update und Deinstallation

# Download, verify, and install the newest GitHub release
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\PS_MCP\app\tools\Update.ps1"

# Remove the installed runtime and Codex registration; preserve pairing and exports
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\PS_MCP\app\tools\Uninstall.ps1"

# Also remove pairing state and exports
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\PS_MCP\app\tools\Uninstall.ps1" -RemoveUserData

Sichere Verwendungsreihenfolge

1. photoshop_host_describe

2. photoshop_capability_list

3. photoshop_state_get

4. photoshop_command_search / photoshop_command_describe

5. photoshop_command_execute

6. photoshop_preview_get nach sichtbaren Änderungen

Zerstörerische, validierungsbezogene, credit-verbrauchende und fortgeschrittene Allowlist-Befehle werden automatisch vom lokalen Server genehmigt, sodass kein Genehmigungsklick im Photoshop-Panel erforderlich ist. photoshop_approval_request bleibt als Kompatibilitätsversion und gibt sofort einen abgeschlossenen, bereichsgebundenen Auftrag zurück. Nur wenn Sie den bisherigen Workflow mit Klick-zur-Freigabe möchten, setzen Sie PS_MCP_APPROVAL_MODE=panel. Pfad-Sandboxing, Capability-Status-Gates, Replay-Schutz und Raw-Descriptor-Allowlisten werden dabei nicht umgangen.

Für die lokale Host-Validierung starten Sie einen temporären Server mit PS_MCP_VALIDATION=confirm. Damit werden photoshop_validation_request und photoshop_command_validate verfügbar. Sie akzeptieren nur katalogisierte, unbestätigte UXP-DOM-Befehle, werden standardmäßig automatisch genehmigt und arbeiten nur mit Dokumenten, die PS_MCP_VALIDATION_* heißen. Die Validierungsausführung setzt eine Capability niemals automatisch.

Inventar und Live-Nachweis-Audit

npm run check umfasst ein maschinelles Audit jedes Befehl- und Feature-Eintrags. Das Audit per House: Handlungs-Presence, Live-Fixture-Herkunft, Digest-Abweichungs vom Katalogvertrag sowie Status/Engine-Route-Konsistenz. Ein supported-Befehl oder -Feature-Enter fällt bei der Prüfung durch, wenn nicht unter evidence/live eine passende transaktionsgebunde Fixture existiert; eine Implementierung oder eine Doku bequemsten, der Support so allein nicht bewirken.

Erzeugen Sie den vollständigen schreibgeschützten Bericht mit:

npm run audit:inventory:json

Ein Promotion-Review erfordert zusätzlich ein frisch von photoshop_host_describe erfasstes Ergebnis, dessen Bridge aktuell verbunden ist. Die Live-Fixture selbst muss zudem eine gültige lokale Signatur für den Nachweis tragen:

npm run audit:promotion -- --promotion-command selection.ellipse --host-report .\host-describe.json

Der Befehl schlägt mit LIVE_HOST_DISCONNECTED fehl, wenn die UXP-Bridge wirklich nicht ordnungsgemäß lebt, auch wenn eine ältere Fixture existiert. Nachweise werden nicht mehr aus Host-, Ergebnis- oder Behauptungs-JSON akzeptiert, das der Aufrufer selbst geschrieben hat. Der Recorder startet selbst eine MCP-Sitzung mit Validierungsprofil, prüft die verbundene Photoshop-Identität, erhält automatische bereichsgebundene Genehmigung, führt den Befehl in einem PS_MCP_VALIDATION_*-Dokuments aus, prüft Hashs von Zustand und Pixel-Vorschau, führt bei Bedarf den Undo-Unterbricht, schließt das temporäre Dokument und signiert die Transaktionsquittung:

Set-Content .\validation-args.json '{"left":0,"top":0,"right":64,"bottom":64}'
npm run evidence:record -- --command selection.ellipse --args .\validation-args.json

Der private Signaturschlüssel für Nachweise liegt unter %LOCALAPPDATA%\PS_MCP mit einer Nur-Benutzer-ACL vor; im Repository ist nur der öffentliche Verstifikationsschlüssel gespeichert. Der Recorder schreibt ausschließlich Hashes und Zulässige Host-/Verifizierungs-Metadaten. Er kopiert keine Pixel, Dokumente oder deren Namen, keine Bruchteil-Ports, kein Gemini, Marshalling, Argumente oder rohe Photoshop-ErgebnisseDie Aufnahme eines Nachweises bearbeitet catalog/commands.json nicht; die Beförderung eines Status bleibt eine separate, reviewte Änderung.

Verifikation

npm run check
npm test
npm --prefix apps\uxp-plugin run check
npm run build
npm run test:contract

Live-Generative Tests sind bewusst ausgeschlossen. Sie müssen ausdrücklich genehmigt werden, da sie Credits verbrauchen können und ein angemeldetes Google-Konto voraussetzen.

Falls ein Validierungslauf unterbrochen wird, prüfen Sie vor der Bereinigung das aktive Dokument. Der Wartungskommando ist standardmäßig im Trockenlaufmodus und stoppt, sobald der aktive Titel kein eigener PS_MCP_*-Validierungstitel ist:

npm run cleanup:owned-documents
npm run cleanup:owned-documents -- --apply

Erfassen und Hinzufügen einer ActionJSON

Der Aufzeichnung eines Befehls durch Entwickler-ActionRecorder von Photoshop, anschließend einer unentgültigen Katalog-Eintrag neu zu erzeugen:

node .\scripts\import-action-recording.mjs --id filters.example --category filter --en "Example Filter" --ko "예제 필터" --file .\recording.json

Der Importeur gibt eine Katalogdefinition and einen SHA-256-Nachweis-Digest aus. Es stuft den Befehl nie auf supported; die Stilbstufen-Erzeugung erfordert eine integrations-Fixture mit isoliertem Dokument.

Datenspeicherorte

• Kopplungsgeheimnis und End-Geräte-Metadaten: %LOCALAPPDATA%\PS_MCP

• Standardexporte: %LOCALAPPDATA%\PS_MCP\exports

• UXP-Token: sicherer UXP-Speicher von Photoshop

Geheimnisse und Vorschau-Bilddaten werden niemals in Protokolle geschrieben.