Claude Desktop (mit Datei) und Claude Code einrichten

Hier richtest du den Assistenten mit einem kleinen Programm auf deinem Rechner ein. Das ist der Weg für Claude Code und für Claude Desktop ohne Konnektor. Er ist etwas mehr Arbeit als der Weg im Browser.

Willst du nichts installieren? Dann nimm Claude verbinden. Das geht auch in Claude Desktop.

Welcher Weg passt?

Das brauchst du

• Claude Desktop oder Claude Code auf deinem Rechner.
• Node.js, ab Version 20. Das ist ein kostenloses Hilfsprogramm, das das Paket ausführt.
• Einen Zugang in PetWorkers. Siehe Zugang einrichten.
• Eine Internetverbindung beim Einrichten.

Schritt 1: Node.js installieren

1. Öffne nodejs.org.
2. Lade die Fassung mit „LTS“ herunter.

1. Öffne die heruntergeladene Datei und klicke dich durch die Installation. Die Vorgaben passen.
2. Prüfe die Installation: Öffne das Terminal (Mac) bzw. die Eingabeaufforderung (Windows). Tippe node --version und drücke Enter.

Geklappt? Es erscheint eine Zahl wie v22.11.0. Die erste Zahl muss 20 oder größer sein.

Schritt 2: 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. Am Mac: Doppelklick. Unter Windows: rechte Maustaste, Alle extrahieren. Es entsteht ein Ordner petworkers-mcp mit drei Dateien: server.js, package.json, README.md.
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 3: 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 4: 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 5a: 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 4. 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. Am Mac: Claude → Claude beenden. Das Fenster zu schließen reicht nicht.

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

Steht in der Datei von Claude schon etwas, frag deinen Administrator. Dann müssen beide Teile zusammengeführt werden. Wie das geht, steht unten unter „Für Fortgeschrittene“.

Die Datei liegt am Mac unter ~/Library/Application Support/Claude/, unter Windows unter %APPDATA%\Claude\.

Schritt 5b: 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. Oder lade ihn mit als Datei herunter.

   

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 4.
4. Kopiere den geänderten Befehl ins Terminal und drücke Enter.

Geklappt? Tippe claude mcp list. Dort steht petworkers. 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“ oder „node“ wird nicht gefunden — Node.js fehlt. Installiere es (Schritt 1). 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.
• „Kein oder ungültiger API-Schlüssel.“ — Der Zugang wurde entfernt, neu eingerichtet oder ein Schlüssel neu vergeben. Lade die Datei bzw. den Befehl 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. Beispiel:

Verbindung ok: https://deine-instanz.petworkers.app
Leseschlüssel: MCP: Anna Beispiel (lesen) — Stufe …, Kontakt: Anna Beispiel, Schreibrecht: nein
Schreibschlüssel: MCP: Anna Beispiel (schreiben) — Stufe …, Schreibrecht: ja
Tagesüberblick: 4 Termine heute, 2 offene Anfragen.

So sieht die Datei aus. Der Zugang besteht aus zwei Schlüsseln: einem zum Lesen, einem zum Anlegen. Ohne Schreibschlüssel bietet das Paket nur die Lese-Werkzeuge an.

{
  "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>"
      }
    }
  }
}

Mit anderen Einträgen zusammenführen. Hast du schon andere MCP-Server in der Datei, setze den Block "petworkers": { … } mit einem Komma als weiteren Eintrag in das vorhandene "mcpServers". Es darf nur ein "mcpServers" in der Datei geben.

Claude Code ohne Paket. Claude Code kann auch den Konnektor-Weg nutzen: claude mcp add --transport http -s user petworkers https://deine-instanz.petworkers.app/mcp. Danach in Claude Code /mcp eingeben und die Anmeldung im Browser abschließen. Mehr dazu: Technik für Fortgeschrittene.

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.