Claude Desktop und Claude Code einrichten

Hier richtest du den Assistenten im Programm Claude Desktop oder in Claude Code ein. Dafür lädst du ein kleines Paket auf deinen Rechner. Das ist etwas mehr Arbeit als im Browser.

Willst du nichts installieren? Dann nimm Claude im Browser.

Das brauchst du

• Claude Desktop oder Claude Code auf deinem Rechner.
• Node.js, ab Version 20. Das ist ein kostenloses Hilfsprogramm. Du bekommst es auf nodejs.org. Nimm die Fassung mit „LTS“.
• Einen Zugang in PetWorkers. Siehe Zugang einrichten.

Schritt 1: Paket herunterladen und auspacken

1. Öffne in PetWorkers System → MCP.
2. Klicke oben auf Paket herunterladen. Du bekommst die Datei petworkers-mcp.zip.

   

3. Pack die Datei aus (Doppelklick). Es entsteht ein Ordner petworkers-mcp.
4. Schiebe den Ordner an einen festen Platz. Gut ist dein Benutzerordner. Nicht im Download-Ordner lassen — wird er gelöscht, geht der Assistent nicht mehr.

Schritt 2: Paket einmal vorbereiten

Das machst du nur einmal. Du brauchst dafür das Terminal (ein Fenster für Befehle).

Am Mac:

1. Öffne das Programm Terminal (Programme → Dienstprogramme).
2. Tippe cd und ein Leerzeichen. Drücke noch nicht Enter.
3. Zieh den Ordner petworkers-mcp mit der Maus ins Terminal-Fenster. Drücke Enter.
4. Tippe npm install und drücke Enter. Warte, bis die Eingabe wieder erscheint.

Unter Windows:

1. Öffne den Ordner petworkers-mcp im Explorer.
2. Klicke oben in die Adresszeile. Tippe cmd und drücke Enter. Ein schwarzes Fenster geht auf.
3. Tippe npm install und drücke Enter. Warte, bis die Eingabe wieder erscheint.

Geklappt? Im Ordner gibt es jetzt einen Unterordner node_modules.

Schritt 3: Den Pfad zur Datei server.js merken

Claude muss wissen, wo das Paket liegt. Dafür brauchst du den vollständigen Pfad zur Datei server.js im Ordner.

• Am Mac: Klicke mit der rechten Maustaste auf server.js. Halte die Wahltaste (⌥) gedrückt. Klicke auf „server.js“ als Pfadname kopieren. Er sieht so aus: /Users/anna/petworkers-mcp/server.js
• Unter Windows: Halte die Umschalttaste gedrückt und klicke mit der rechten Maustaste auf server.js. Klicke auf Als Pfad kopieren. Er sieht so aus: "C:\Users\anna\petworkers-mcp\server.js"

Schritt 4a: Claude Desktop einrichten

1. Klicke in PetWorkers unter Eingerichtete Zugänge in deiner Zeile auf Claude Desktop. Du bekommst die Datei claude_desktop_config.json.

   

2. Öffne die Datei mit einem einfachen Texteditor (Mac: TextEdit, Windows: Editor).
3. Suche die Stelle /PFAD/ZUM/ENTPACKTEN/ORDNER/petworkers-mcp/server.js.
4. Ersetze sie durch deinen Pfad aus Schritt 3. Die Anführungszeichen drumherum bleiben stehen.
5. Markiere den ganzen Text der Datei und kopiere ihn.
6. Öffne Claude Desktop. Öffne Einstellungen → Entwickler. Klicke auf Konfiguration bearbeiten. Claude zeigt dir die Datei claude_desktop_config.json.
7. Öffne diese Datei mit dem Texteditor. Ist sie leer, füge deinen kopierten Text ein und speichere.
8. Beende Claude Desktop ganz und starte es neu.

Geklappt? In einer neuen Unterhaltung kennt Claude jetzt PetWorkers. Frag: „Wie sieht mein Tag in PetWorkers aus?“

Schritt 4b: Claude Code einrichten

1. Klicke in PetWorkers unter Eingerichtete Zugänge in deiner Zeile auf Claude Code. Darunter erscheint ein fertiger Befehl.
2. Klicke auf Befehl kopieren.

   

3. Füge den Befehl in einen Texteditor ein. Ersetze am Ende /PFAD/ZUM/ENTPACKTEN/ORDNER/petworkers-mcp/server.js durch deinen Pfad aus Schritt 3.
4. Kopiere den geänderten Befehl ins Terminal und drücke Enter.

Geklappt? Starte Claude Code neu und frag: „Wie sieht mein Tag in PetWorkers aus?“

Wenn etwas nicht klappt

• Claude zeigt PetWorkers nicht an — Meist stimmt der Pfad nicht. Prüfe ihn Zeichen für Zeichen. Unter Windows: / statt \. Danach Claude ganz beenden und neu starten.
• „npm“ wird nicht gefunden — Node.js fehlt. Installiere es von nodejs.org. Danach das Terminal neu öffnen.
• Der Assistent kann nur lesen — Dein Zugang hat keinen Haken bei Auch anlegen dürfen. Siehe Zugang ändern. Lade danach die Datei neu herunter.
• Weitere Meldungen — siehe Wenn etwas nicht klappt.

Für Fortgeschrittene

Verbindung prüfen. Im Ordner petworkers-mcp kannst du die Verbindung testen. Die drei Werte stehen in deiner Datei claude_desktop_config.json:

PETWORKERS_URL=https://deine-instanz.petworkers.app \
PETWORKERS_API_KEY="DEIN-LESESCHLUESSEL" \
PETWORKERS_API_KEY_WRITE="DEIN-SCHREIBSCHLUESSEL" \
node server.js --pruefen

Die Prüfung meldet, welche Schlüssel erkannt wurden, wer der Mitarbeiter ist und wie viele Termine heute anstehen.

So sieht die Datei aus. Der Zugang besteht aus zwei Schlüsseln: einem zum Lesen, einem zum Anlegen. Ohne Schreibschlüssel kann der Assistent nur lesen.

{
  "mcpServers": {
    "petworkers": {
      "command": "node",
      "args": ["/voller/pfad/zu/petworkers-mcp/server.js"],
      "env": {
        "PETWORKERS_URL": "https://deine-instanz.petworkers.app",
        "PETWORKERS_API_KEY": "<Leseschlüssel>",
        "PETWORKERS_API_KEY_WRITE": "<Schreibschlüssel>"
      }
    }
  }
}

Schlüssel von Hand anlegen. Das geht auch unter System → API-Schlüssel: ein Schlüssel ohne und einer mit „Schreiben erlauben“, beide einem aktiven Mitarbeiter zugeordnet. Einfacher ist System → MCP. Wie Schlüssel funktionieren, steht im Kapitel Schnittstelle (API).

Für Programmierer. Die Werkzeuge des Assistenten sind normale Aufrufe der Schnittstelle. Sie stehen auf der Seite Assistent: Tagesüberblick, Termine anlegen, Kundenakte.