A proof of concept for Austrian legal research. Ein Proof of Concept für österreichische Rechtsrecherche.

For most people — Claude Desktop Für die meisten — Claude Desktop

This is the path if you use the Claude Desktop app on Mac or Windows and don't write code day to day. Setup is short, but the initial data import is not.

Diese Anleitung ist für Sie, wenn Sie die Claude-Desktop-App auf Mac oder Windows verwenden und im Alltag nicht programmieren. Die Einrichtung ist kurz, der erstmalige Datenimport jedoch nicht.

1. 1. Install uv (a tiny helper that launches the plug-in). 1. Installieren Sie uv (ein kleines Hilfsprogramm, das das Plug-in startet).

   Open the Terminal app (Mac) or PowerShell (Windows) and paste:

   Öffnen Sie die Terminal-App (Mac) oder PowerShell (Windows) und fügen Sie ein:

   macOS / Linux:

   curl -LsSf https://astral.sh/uv/install.sh | sh

   Windows (PowerShell):

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. 2. Tell Claude Desktop about the plug-in. 2. Claude Desktop das Plug-in bekanntmachen.

   In Claude Desktop click Settings → Developer → Edit Config. A JSON file opens in your text editor. (Claude Desktop's menu is English-only, even on a German system.)

   Klicken Sie in Claude Desktop auf Settings → Developer → Edit Config. Eine JSON-Datei öffnet sich im Texteditor. (Die Claude-Desktop-Menüs sind englisch, auch auf deutschsprachigen Systemen.)

   If the file is empty (or just shows {}), replace its contents with: Ist die Datei leer (oder zeigt nur {}), ersetzen Sie den Inhalt durch:

   {
     "mcpServers": {
       "ris": {
         "command": "uvx",
         "args": ["ris-mcp", "serve"]
       }
     }
   }

   If the file already has other plug-ins, add the "ris" entry inside mcpServers (mind the comma): Gibt es bereits andere Plug-ins, ergänzen Sie den Eintrag "ris" innerhalb von mcpServers (Komma beachten):

   {
     "mcpServers": {
       "some-other-plugin": { "command": "...", "args": [...] },
       "ris": {
         "command": "uvx",
         "args": ["ris-mcp", "serve"]
       }
     }
   }

   macOS gotchamacOS-Besonderheit Claude Desktop on macOS does not inherit your shell's PATH, so "command": "uvx" can fail to resolve even when uvx works perfectly in Terminal. Replace "uvx" with the absolute path. To find it, run uvx ris-mcp doctor in Terminal — it prints the exact path on the “uvx on PATH” line. Your config will look like: Claude Desktop auf macOS übernimmt den PATH Ihrer Shell nicht, daher kann "command": "uvx" fehlschlagen, obwohl uvx im Terminal einwandfrei funktioniert. Ersetzen Sie "uvx" durch den absoluten Pfad. Um ihn zu finden, führen Sie im Terminal uvx ris-mcp doctor aus — der Pfad erscheint in der Zeile „uvx on PATH“. Ihre Config sieht dann etwa so aus:

   "command": "/Users/YOUR-USERNAME/.local/bin/uvx"

   Save the file. Quit and re-open Claude Desktop. A 🔌 plug icon should show ris-mcp as connected.

   Speichern Sie die Datei. Beenden Sie Claude Desktop und öffnen Sie es erneut. Ein 🔌-Symbol zeigt, dass ris-mcp verbunden ist.

3. 3. Build the database (one time; about 3–4 days and ~40 GB). 3. Datenbank aufbauen (einmalig; etwa 3–4 Tage und ~40 GB).

   Back in the terminal:

   Wieder im Terminal:

   uvx --from ris-mcp ris-ingest --full

   Leave the terminal open while this runs. If interrupted, existing records are retained, but the API scan starts again from the beginning. After a completed import, use ris-ingest --delta to fetch only later changes.

   Lassen Sie das Terminal währenddessen offen. Bei einer Unterbrechung bleiben bestehende Einträge erhalten, der API-Durchlauf beginnt jedoch wieder am Anfang. Nach einem vollständigen Import ruft ris-ingest --delta nur spätere Änderungen ab.

4. 4. Verify the install. 4. Installation überprüfen.

   Run this in the terminal to confirm each piece is in place:

   Prüfen Sie im Terminal, dass alle Teile an Ort und Stelle sind:

   uvx ris-mcp doctor

   You should see a short report with green ✅ lines for Python, uvx, the database file, and the number of indexed decisions. Any ❌ or ⚠️ line tells you exactly what to fix. Then open Claude Desktop and try one of the example questions above.

   Sie erhalten einen kurzen Bericht mit grünen ✅-Zeilen für Python, uvx, die Datenbankdatei und die Anzahl indexierter Entscheidungen. Jede ❌- oder ⚠️-Zeile sagt Ihnen genau, was zu tun ist. Anschließend öffnen Sie Claude Desktop und probieren eine der Beispielfragen oben.

Don't use Claude Desktop? The same plug-in works with Claude Code, Cursor, ChatGPT (via MCP connectors) and any tool that speaks the Model Context Protocol. See the developer instructions on GitHub.

Sie nutzen nicht Claude Desktop? Das Plug-in funktioniert auch mit Claude Code, Cursor, ChatGPT (über MCP-Connectors) und jedem Tool, das das Model Context Protocol unterstützt. Details in der Entwickleranleitung auf GitHub.