First the Mac, then the NAS.

1. Unpack the package

   Double-click the zip. A folder nasindex appears. Put it in a permanent place, for example your home folder. Do not rename or move the folder afterwards.

2. Start the wizard

   In the nasindex folder, double-click Installieren.command. If macOS blocks the file, open System Settings → Privacy & Security and click «Open Anyway».

3. Answer the questions

   The wizard asks	You answer
   Läuft der Container auf dem NAS selbst?Is the container running on the NAS itself?	Enter for no
   SMB-Server (NAS-Adresse)SMB server (NAS address)	Address of the NAS, e.g. 192.168.1.20
   Freigabename des ArchivsShare name of the archive	e.g. Projekte
   SMB-Benutzer (nur Leserechte)SMB user (read-only)	the read-only user
   SMB-DomäneSMB domain	Enter
   SMB-PasswortSMB password	Password of the read-only user. It stays invisible while you type.
   Katalog von einem anderen Rechner (Seed-Pfad)Catalogue from another computer (seed path)	Enter, because the Mac indexes itself
   Tailscale-IP-AdresseTailscale IP address	Enter accepts the suggestion
   Port	Enter
   Abschnitt FeldextraktionSection «field extraction»	Enter for every question. Leave the key empty, approval no.

   The wizard checks the credentials against the NAS right away. If something is wrong, it asks again.

4. Wait until the Mac is done

   The window shows the progress, for example Schritt 5 von 7: Texte auslesen … noch ~3 h (step 5 of 7: reading texts, about 3 h left). A large archive takes a few hours. Keep the Mac awake and on the network during that time. You can close the window, the work continues. You can check at any time in Terminal, in the nasindex folder:

   docker compose logs --tail 20 nasindex

   Done whenthe window or the log shows zyklus fertig (rc=0) (cycle finished).

5. Take the catalogue off the Mac

   Open Terminal, type cd and a space, drag the nasindex folder from Finder into Terminal, press Enter. Then these five lines:

   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/

   The nasindex folder now contains nasindex-katalog with exactly four entries: two catalogue files and the folders text and meta.

1. Sign in to the NAS

   In Terminal on the Mac, with the administrator account of the NAS:

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

   The script asks once for the administrator password and then starts the same wizard.

2. Answer the questions

   The wizard asks	You answer
   Läuft der Container auf dem NAS selbst?Is the container running on the NAS itself?	j for yes
   Pfad zum Archiv auf diesem HostPath to the archive on this host	/volume1/Projekte, i.e. /volume1/ plus the same share name as on the Mac
   Katalog von einem anderen Rechner (Seed-Pfad)Catalogue from another computer (seed path)	/volume1/docker/nasindex-katalog
   Tailscale-IP-AdresseTailscale IP address	Enter accepts the suggestion, now the address of the NAS
   Port	Enter
   Abschnitt FeldextraktionSection «field extraction»	same as on the Mac: Enter, leave empty, no

   ImportantThe archive path must be exactly the share the Mac read. A different folder does not match the catalogue, and the NAS would read everything again.

3. Wait briefly

   The NAS first loads the catalogue and then compares it with the archive. This usually takes only minutes. Files added or changed since stage A are read along the way.

   Done whenzyklus fertig (rc=0) appears. From now on the NAS checks the archive every hour by itself and starts on its own after every restart.

4. Shut down the Mac side

   On the Mac, in the nasindex folder:

   docker compose down

   The Mac is no longer needed. You can keep or delete the nasindex-katalog folder on the NAS, the NAS does not need it any more.

1. Read the key

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

   Treat it like a password. It opens the whole archive. Do not send it by email or chat.

2. Enter it on every workstation

   Claude Desktop needs Node.js. Add this to claude_desktop_config.json, then quit Claude Desktop completely and restart it:

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

   Claude Code:

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

3. Upload the skill and test

   In Claude under Settings → Capabilities, upload the file claude/archiv-skill.zip from the package. Then ask: «What is the status of the archive?» Claude reports «erreichbar» (reachable) and the list of projects.

If you have questions, send us the output of docker compose logs --tail 200 nasindex, on the NAS with sudo in front. It contains no credentials.