Installation

Vorab: Was Sie brauchen

• Adobe® InDesign®, installiert und gestartet – Mac oder Windows (Windows 10/11 x64; geprüft mit InDesign® 21.6.0 auf Windows 11)
• Claude Desktop mit eigenem Zugang
• Node.js ab Version 20 – nur für Weg B (Eintrag in der Konfigurationsdatei) und für andere MCP-Clients; Prüfung und Installation in Schritt 1 und 2. Mit dem Installationspaket (Weg A) ist keine eigene Node.js-Installation nötig – Claude Desktop bringt Node.js mit.
• Windows: Windows PowerShell 5.1 (powershell.exe, in Windows enthalten)
• Ihren Lizenzschlüssel aus der Bestellbestätigung oder dem Kundenportal von Polar – ein Schlüssel je Arbeitsplatz
• Eine Netzverbindung für die Lizenzprüfung beim ersten Aufruf

Schritt 1 – Node.js prüfen (nur Weg B)

Richten Sie LayoutBridge mit dem Installationspaket ein (Weg A in Schritt 3), überspringen Sie Schritt 1 und 2 und machen Sie direkt mit Schritt 3 weiter.

node -v

node -v

Schritt 2 – Node.js installieren (nur Weg B, nur falls nötig)

1. Rufen Sie nodejs.org auf und laden Sie die LTS-Version herunter – auf dem Mac den .pkg-Installer, unter Windows den .msi-Installer. Ältere Versionen aktualisieren Sie auf demselben Weg.
2. Führen Sie den Installer mit den Voreinstellungen aus. Unter Windows darf die Option zur Installation zusätzlicher Werkzeuge („Tools for Native Modules“) abgewählt bleiben.
3. Schließen Sie Terminal bzw. PowerShell, öffnen Sie es neu und wiederholen Sie Schritt 1. Erst ein neu geöffnetes Fenster kennt das frisch installierte Node.js.

Wer Node.js über Homebrew, nvm, fnm oder Volta verwaltet, kann dabei bleiben – entscheidend ist allein Version 20 oder neuer.

Schritt 3 – LayoutBridge in Claude Desktop eintragen

Es gibt zwei Wege. Weg A ist der kürzere; Weg B ist derselbe Eintrag, den auch andere MCP-Clients bekommen.

Weg A – Installationspaket (Bundle-Datei .mcpb, Claude Desktop)

1. Laden Sie die Datei layoutbridge-spm-1.0.1.mcpb herunter (aktuelle Version, auch auf der Produktseite).
2. Öffnen Sie in Claude Desktop Einstellungen › Desktop-App › Erweiterungen und ziehen Sie die Datei in dieses Fenster – dort steht „Ziehe .MCPB- oder .DXT-Dateien hier her, um sie zu installieren“. Auf dem Mac können Sie die Datei stattdessen per Doppelklick öffnen. Unter Windows öffnet der Doppelklick Claude Desktop nicht – Windows fragt nach einem Programm; ziehen Sie die Datei dort ins Fenster oder wählen Sie unter „Erweiterte Einstellungen“ die Schaltfläche zum Installieren einer Erweiterung (englische Oberfläche: „Advanced settings“ › „Install extension“) und dann die Datei. Claude Desktop zeigt den Installationsdialog; bestätigen Sie mit „Installieren“.
3. Tragen Sie beim Installieren Ihren Lizenzschlüssel in das Feld „Licence key“ ein und klicken Sie auf „Speichern“. Claude Desktop speichert den Schlüssel auf Ihrem Rechner.
4. Schalten Sie die Erweiterung ein. Nach der Installation steht „LayoutBridge for Adobe InDesign®“ unter Einstellungen › Erweiterungen auf „Deaktiviert“. Stellen Sie den Schalter auf „Aktiviert“ – sonst erscheinen keine Werkzeuge.

Weg A braucht kein eigenes Node.js: Claude Desktop startet die Erweiterung mit seinem eingebauten Node.js (Schalter „Use built-in Node.js for MCP“ unter „Erweiterte Einstellungen“, ab Werk eingeschaltet). Schritt 4 ist damit ebenfalls erledigt – weiter mit Schritt 5.

Weg B – Eintrag in der Konfigurationsdatei

Weg B setzt Node.js ab Version 20 voraus (Schritt 1 und 2). Claude Desktop liest seine MCP-Server aus einer Textdatei. Öffnen Sie sie in einem Texteditor (TextEdit im Modus „Reiner Text“, Editor unter Windows, oder ein Code-Editor):

~/Library/Application Support/Claude/claude_desktop_config.json

%LOCALAPPDATA%\Packages\Claude_<Kennung>\LocalCache\Roaming\Claude\claude_desktop_config.json

Ist die Datei leer oder noch nicht vorhanden, hat sie genau diesen Inhalt:

{
  "mcpServers": {
    "layoutbridge-spm": {
      "command": "npx",
      "args": ["-y", "layoutbridge-spm"]
    }
  }
}

Enthält die Datei bereits andere Server unter "mcpServers", fügen Sie nur den Block "layoutbridge-spm": { … } dort ein – mit einem Komma zwischen den Einträgen – und lassen Sie alles andere unverändert. Die Datei ist JSON: jede Klammer und jedes Anführungszeichen zählt, ein fehlendes oder überzähliges Komma macht sie ungültig. Speichern Sie die Datei ohne Änderung des Namens und der Endung.

Beim ersten Start lädt npx das Paket layoutbridge-spm von der npm-Registry; danach startet es aus dem lokalen Speicher.

Schritt 4 – Lizenzschlüssel hinterlegen (Weg B)

Der Schlüssel steht in der Bestellbestätigung und im Kundenportal von Polar und gilt für genau einen Arbeitsplatz. Legen Sie ihn als Datei license.key ab – nur der Schlüssel, ohne weiteren Text, ohne Leerzeile davor:

~/Library/Application Support/layoutbridge-spm/license.key

%USERPROFILE%\.layoutbridge-spm\license.key

Den Ordner layoutbridge-spm bzw. .layoutbridge-spm legen Sie an, falls er fehlt. Ein nachgelegter oder geänderter Schlüssel wirkt sofort, ohne Neustart.

Alternativ tragen Sie den Schlüssel direkt in den Server-Eintrag aus Schritt 3 ein – als weitere Zeile hinter "args", mit Komma davor:

"env": {
  "LAYOUTBRIDGE_SPM_LICENSE_KEY": "IHR-LIZENZSCHLÜSSEL"
}

Oder Sie nennen einen eigenen Dateipfad in der Umgebungsvariablen LAYOUTBRIDGE_SPM_LICENSE_FILE. Reihenfolge, in der LayoutBridge sucht: Umgebungsvariable mit dem Schlüssel, Datei aus LAYOUTBRIDGE_SPM_LICENSE_FILE, license.key am Vorgabeort.

Schritt 5 – Claude Desktop neu starten und prüfen

1. Beenden Sie Claude Desktop vollständig – auf dem Mac mit ⌘ + Q, unter Windows über „Beenden“ im Menü der Anwendung; das Fenster zu schließen genügt nicht – und starten Sie es neu.
2. Starten Sie Adobe® InDesign®.
3. Fragen Sie in Claude Desktop: „Welche InDesign®-Version läuft?“ Claude ruft das Werkzeug get_app_version auf und nennt die Version. Beim ersten Aufruf eines Werkzeugs fragt Claude Desktop, ob es zugelassen wird (englische Oberfläche: „Deny / Always allow / Allow once“) – das ist eine Einstellung von Claude Desktop, kein Fehler; beim Installationspaket steht die Vorgabe unter Einstellungen › Erweiterungen › „Tool-Berechtigungen“. Beim ersten Aufruf prüft LayoutBridge den Lizenzschlüssel online; danach höchstens einmal in 24 Stunden.

Damit ist die Einrichtung abgeschlossen. Die Werkzeuge erscheinen in Claude Desktop auf Weg A unter dem Namen der Erweiterung „LayoutBridge for Adobe InDesign®“, auf Weg B mit dem Präfix layoutbridge-spm:.

Wenn etwas nicht klappt

• Die Werkzeuge erscheinen nicht. Weg A: Die Erweiterung steht noch auf „Deaktiviert“ (Schritt 3). Weg B: Claude Desktop war nicht vollständig beendet; oder die Konfigurationsdatei ist kein gültiges JSON (meist ein Komma) – Claude Desktop meldet das beim Start; oder Node.js fehlt (Schritt 1).
• Meldung „Node.js … found, but version 20 or newer is required“ (nur Weg B). Das installierte Node.js ist zu alt. Aktualisieren Sie es wie in Schritt 2, prüfen Sie mit node -v, beenden Sie Claude Desktop vollständig und starten Sie es neu.
• Antwort mit error.kind: "license". Der Schlüssel fehlt, ist abgelaufen, ungültig oder gerade nicht prüfbar. Die Meldung sagt im Klartext, welcher Fall vorliegt, und nennt den Ort, an dem der Schlüssel erwartet wurde. Prüfen Sie: vollständig kopiert, keine Leerzeichen, richtiger Pfad, Netzverbindung beim ersten Aufruf.
• Antwort mit app_not_available. Adobe® InDesign® läuft nicht. Starten Sie es und wiederholen Sie die Anfrage.
• Rechnerwechsel. Eine Lizenz ist auf einem Arbeitsplatz aktiv. Geben Sie sie auf dem alten Rechner frei, bevor Sie den Schlüssel auf dem neuen eintragen – ohne InDesign®, ohne Claude Desktop, aber mit Node.js ab Version 20:

  npx layoutbridge-spm --deactivate

  Der Befehl sucht den Schlüssel an denselben Orten wie LayoutBridge (Schritt 4). Beim Installationspaket verwahrt Claude Desktop den Schlüssel, und der Befehl findet ihn nicht – legen Sie ihn dann vorher als license.key ab (Schritt 4) oder schreiben Sie an den Support. Haben Sie kein Node.js oder ist der alte Rechner nicht mehr erreichbar, gibt der Support die Aktivierung frei.
• Sonst: Schreiben Sie an den Support – mit Werkzeugname, Fehlertext im Wortlaut, Zeitpunkt, InDesign®-Version und Betriebssystem. Schicken Sie nie Ihren Lizenzschlüssel.

Anweisung für Ihre KI

Wenn Sie eine KI-Anwendung nutzen, die auf Ihrem Rechner arbeiten darf – Claude Code, Claude im Cowork-Modus mit Zugriff auf den Rechner, Cursor, Codex CLI oder eine andere Anwendung mit Zugriff auf Terminal und Dateien –, kopieren Sie den folgenden Text und fügen Sie ihn dort als Nachricht ein. Die Anweisung richtet Weg B ein (Eintrag in der Konfigurationsdatei, mit Node.js); für das Installationspaket (Weg A) brauchen Sie sie nicht. Die KI prüft Node.js, schlägt bei Bedarf die Installation vor, trägt LayoutBridge in Claude Desktop ein und legt den Schlüssel ab; sie fragt vor jedem Schritt nach Ihrer Zustimmung. Ein Chat ohne Zugriff auf Ihren Rechner kann die Schritte nur erklären, nicht ausführen.

Ich möchte LayoutBridge for Adobe InDesign (MCP-Server, npm-Paket „layoutbridge-spm“) auf diesem Rechner für Claude Desktop einrichten. Bitte hilf mir Schritt für Schritt und halte dich dabei an diese Regeln:

1. Zustimmung vor jeder Aktion. Sag mir vor jedem Befehl und vor jeder Dateiänderung, was du tun willst, und warte auf mein Ja. Installiere nichts außer dem, was hier steht, ändere keine anderen Einstellungen und verlange keine Administratorrechte.

2. Node.js prüfen. Führe „node -v“ aus. Erwartet wird Version 20 oder höher. Fehlt Node.js oder ist es älter: Installiere es NICHT selbst. Nenne mir den Download der LTS-Version von https://nodejs.org (Mac: .pkg, Windows: .msi) und warte, bis ich die Installation gemacht und das Terminal neu geöffnet habe. Prüfe dann erneut.

3. Konfigurationsdatei von Claude Desktop finden.
   Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   Windows: Prüfe zuerst, ob es den Ordner %LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\ gibt (Claude Desktop als App-Paket installiert). Wenn ja, gilt die Datei claude_desktop_config.json in diesem Ordner. Nur wenn es ihn nicht gibt: %APPDATA%\Claude\claude_desktop_config.json. Findest du mehrere Claude_*-Ordner, frag mich, statt einen auszuwählen.
   Zeig mir den Inhalt. Lege vor jeder Änderung eine Sicherungskopie im selben Ordner an (Dateiname mit Datum und Uhrzeit). Ist die Datei kein gültiges JSON, ändere sie nicht, sondern zeig mir die Stelle.

4. Eintrag ergänzen. Füge unter „mcpServers“ genau diesen Eintrag hinzu und lass alle anderen Einträge unverändert. Fehlt die Datei, lege sie mit diesem Inhalt an:
{
  "mcpServers": {
    "layoutbridge-spm": {
      "command": "npx",
      "args": ["-y", "layoutbridge-spm"]
    }
  }
}

5. Lizenzschlüssel. Ich gebe dir den Schlüssel selbst. Schreibe ihn – nur den Schlüssel, ohne weiteren Text – in die Datei „license.key“ und lege den Ordner an, falls er fehlt:
   Mac: ~/Library/Application Support/layoutbridge-spm/license.key
   Windows: %USERPROFILE%\.layoutbridge-spm\license.key
   Setze die Datei so, dass nur mein Benutzerkonto sie lesen kann. Sende den Schlüssel nirgendwohin, schreibe ihn in keine andere Datei, gib ihn in keiner Antwort aus.

6. Abschluss. Zeig mir die Ausgabe von „node -v“, den neuen Eintrag in der Konfigurationsdatei und den Pfad der Schlüsseldatei. Sag mir, dass ich Claude Desktop vollständig beenden (nicht nur das Fenster schließen) und neu starten muss.

7. Prüfung nach dem Neustart. Adobe InDesign muss laufen. Ich frage Claude Desktop: „Welche InDesign-Version läuft?“ – das Werkzeug layoutbridge-spm:get_app_version sollte die Version melden; beim ersten Aufruf wird der Schlüssel online geprüft. Antwortet das Werkzeug mit error.kind „license“, hilf mir anhand der Meldung (sie nennt den erwarteten Ort des Schlüssels), den Fehler zu finden. Antwortet es mit „app_not_available“, ist InDesign nicht gestartet.

Den Lizenzschlüssel geben Sie der KI erst, wenn sie danach fragt, und nur in Ihrer eigenen KI-Anwendung. Prüfen Sie am Ende selbst, was in der Konfigurationsdatei steht – die KI zeigt es Ihnen.