Erst der Mac, dann das NAS.

1. Paket entpacken

   Doppelklick auf das Zip. Es entsteht ein Ordner nasindex. Legen Sie ihn an einen festen Ort, zum Beispiel in Ihren Benutzerordner. Den Ordner danach nicht umbenennen und nicht verschieben.

2. Assistent starten

   Im Ordner nasindex doppelt auf Installieren.command klicken. Blockiert macOS die Datei, in den Systemeinstellungen unter «Datenschutz & Sicherheit» auf «Trotzdem öffnen» klicken.

3. Fragen beantworten

   Der Assistent fragt	Sie antworten
   Läuft der Container auf dem NAS selbst?	Enter für nein
   SMB-Server (NAS-Adresse)	Adresse des NAS, z. B. 192.168.1.20
   Freigabename des Archivs	z. B. Projekte
   SMB-Benutzer (nur Leserechte)	der Lese-Benutzer
   SMB-Domäne	Enter
   SMB-Passwort	Passwort des Lese-Benutzers. Es bleibt unsichtbar beim Tippen.
   Katalog von einem anderen Rechner (Seed-Pfad)	Enter, denn der Mac indexiert selbst
   Tailscale-IP-Adresse	Enter übernimmt den Vorschlag
   Port	Enter
   Abschnitt Feldextraktion	Enter bei jeder Frage. Schlüssel leer lassen, Freigabe nein.

   Der Assistent prüft die Zugangsdaten sofort am NAS. Stimmt etwas nicht, fragt er erneut.

4. Warten, bis der Mac fertig ist

   Das Fenster zeigt den Fortschritt, etwa Schritt 5 von 7: Texte auslesen … noch ~3 h. Ein grosses Archiv braucht einige Stunden. Lassen Sie den Mac in dieser Zeit wach und am Netz. Schliessen Sie das Fenster ruhig, die Arbeit läuft weiter. Nachsehen geht jederzeit im Terminal, im Ordner nasindex:

   docker compose logs --tail 20 nasindex

   Fertig, wennim Fenster oder im Log zyklus fertig (rc=0) steht.

5. Katalog vom Mac holen

   Terminal öffnen, cd und ein Leerzeichen tippen, den Ordner nasindex aus dem Finder ins Terminal ziehen, Enter. Dann diese fünf Zeilen:

   mkdir nasindex-katalog
   docker cp nasindex:/daten/catalog.jsonl.gz nasindex-katalog/
   docker cp nasindex:/daten/catalog.json nasindex-katalog/
   docker cp nasindex:/daten/text nasindex-katalog/
   docker cp nasindex:/daten/meta nasindex-katalog/

   Im Ordner nasindex liegt jetzt nasindex-katalog mit genau vier Einträgen: zwei Katalogdateien und die Ordner text und meta.

1. Am NAS anmelden

   Im Terminal des Mac, mit dem Administrator-Konto des NAS:

   ssh <admin>@<NAS-Adresse>
   cd /volume1/docker/nasindex
   sh installieren.sh

   Das Skript fragt einmal nach dem Passwort des Administrators und startet dann denselben Assistenten.

2. Fragen beantworten

   Der Assistent fragt	Sie antworten
   Läuft der Container auf dem NAS selbst?	j für ja
   Pfad zum Archiv auf diesem Host	/volume1/Projekte, also /volume1/ und derselbe Freigabename wie auf dem Mac
   Katalog von einem anderen Rechner (Seed-Pfad)	/volume1/docker/nasindex-katalog
   Tailscale-IP-Adresse	Enter übernimmt den Vorschlag, jetzt die Adresse des NAS
   Port	Enter
   Abschnitt Feldextraktion	wie auf dem Mac: Enter, leer lassen, nein

   WichtigDer Archivpfad muss genau die Freigabe sein, die der Mac gelesen hat. Ein anderer Ordner passt nicht zum Katalog, und das NAS würde alles neu auslesen.

3. Kurz warten

   Das NAS spielt zuerst den Katalog ein und gleicht dann das Archiv ab. Das dauert meist nur Minuten. Neue oder geänderte Dateien seit Etappe A liest es dabei nach.

   Fertig, wennzyklus fertig (rc=0) erscheint. Ab jetzt prüft das NAS das Archiv jede Stunde selbst und startet nach jedem Neustart von allein.

4. Den Mac abschalten

   Auf dem Mac im Ordner nasindex:

   docker compose down

   Der Mac wird danach nicht mehr gebraucht. Den Ordner nasindex-katalog auf dem NAS können Sie behalten oder löschen, das NAS braucht ihn nicht mehr.

1. Schlüssel ablesen

   cat /volume1/docker/nasindex/docker/mcp.token

   Behandeln Sie ihn wie ein Passwort. Er öffnet das ganze Archiv. Nicht per Mail oder Chat verschicken.

2. Auf jedem Arbeitsplatz eintragen

   Claude Desktop braucht Node.js. In der Datei claude_desktop_config.json ergänzen, danach Claude Desktop ganz beenden und neu starten:

   {
     "mcpServers": {
       "archiv": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "http://<NAS-Tailscale-IP>:8765/mcp", "--allow-http",
                  "--header", "Authorization: Bearer <schluessel>"]
       }
     }
   }

   Claude Code:

   claude mcp add --transport http archiv http://<NAS-Tailscale-IP>:8765/mcp --header "Authorization: Bearer <schluessel>"

3. Skill hochladen und testen

   In Claude unter Einstellungen → Fähigkeiten die Datei claude/archiv-skill.zip aus dem Paket hochladen. Dann fragen: «Wie ist der Stand des Archivs?» Claude meldet «erreichbar» und die Liste der Projekte.

Bei Fragen schicken Sie uns die Ausgabe von docker compose logs --tail 200 nasindex, auf dem NAS mit sudo davor. Sie enthält keine Zugangsdaten.