Sprachassistent: PetWorkers mit Claude bedienen (MCP)

Du kannst PetWorkers per Sprache bedienen: „Wie sieht mein Tag aus?", „Hat Frau Koch die Rechnung schon bezahlt?", „Leg Dienstag um 10 eine Einzelstunde mit Meyer für Rocky an." Dafür gibt es den PetWorkers MCP-Server — ein kleines Programm, das einen Sprachassistenten wie Claude Desktop oder Claude Code mit deiner Instanz verbindet. MCP („Model Context Protocol") ist der offene Standard, über den solche Assistenten Werkzeuge nutzen.

Du nutzt ChatGPT oder Claude im Browser? Dann brauchst du diesen lokalen Server nicht — dafür gibt es den eingebauten Connector, siehe ChatGPT: PetWorkers als Connector verbinden. Diese Seite beschreibt den lokalen Weg für Claude Desktop und Claude Code.

Der Server ist eine dünne Brücke zur Schnittstelle deiner Instanz. Er hat keine eigene Datenbank und keine eigene Logik. Was er anlegt, läuft über dieselben Regeln wie die Oberfläche: Terminart und Dauer aus der Leistung, Zahlweg über Abo, Stempelkarte oder Rechnungsposition, Überschneidungsprüfung.

Das brauchst du

Node.js ab Version 20 auf deinem Rechner (nodejs.org, die LTS-Fassung genügt).
Claude Desktop oder Claude Code — oder einen anderen Assistenten, der MCP-Server über stdio anbinden kann.
Administrator-Rechte in PetWorkers für die Einrichtung (System → MCP).

Einrichten in drei Schritten

Alles Nötige findest du in PetWorkers unter System → MCP. Die Seite erklärt kurz, was der Assistent tut, und führt dich durch:

Paket herunterladen und entpacken. Der Knopf „Paket herunterladen" liefert drei Dateien (auch hier: petworkers-mcp.zip). Entpacke sie in einen Ordner, der bleiben darf, zum Beispiel ~/petworkers-mcp, und führe dort einmal npm install aus.
Zugang einrichten. Wähle den Mitarbeiter, der den Assistenten benutzt, und drücke „Zugang einrichten". Das Häkchen „Auch anlegen dürfen" entscheidet, ob der Assistent nur Auskunft gibt oder auch Termine, Kunden, Tiere, Vermerke und Aufgaben anlegen darf. Im Hintergrund entstehen dabei die passenden API-Schlüssel — du musst dich um nichts kümmern; sie stehen unter System → API-Schlüssel und lassen sich auf der MCP-Seite jederzeit wieder entfernen.
Konfiguration herunterladen und eintragen. In der Liste „Eingerichtete Zugänge" lädst du mit „Claude Desktop" die fertige Datei claude_desktop_config.json. Darin ist nur noch eines zu tun: den Platzhalter /PFAD/ZUM/ENTPACKTEN/ORDNER/petworkers-mcp/server.js durch den echten Pfad zur entpackten server.js ersetzen. Dann den Inhalt in Claude Desktop unter Einstellungen → Entwickler → Konfiguration bearbeiten einfügen und Claude Desktop neu starten. Unten im Eingabefeld erscheint das Werkzeug-Symbol mit „petworkers".
Für Claude Code zeigt „Claude Code" einen fertigen Befehl zum Kopieren — auch dort nur den Pfad einsetzen und im Terminal ausführen.

Ob alles stimmt, siehst du im entpackten Ordner mit einem Aufruf (die Werte stehen in der heruntergeladenen Datei):

PETWORKERS_URL=https://deine-instanz.petworkers.app \
PETWORKERS_API_KEY=<Leseschlüssel> \
PETWORKERS_API_KEY_WRITE=<Schreibschlüssel> \
node server.js --pruefen

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

Du kannst die Schlüssel auch von Hand anlegen (System → API-Schlüssel): einen zum Lesen mit „Schreiben erlauben" aus, einen zum Schreiben mit „Schreiben erlauben" an, beide dem Mitarbeiter als Kontakt zugeordnet, Stufe Mitarbeiter oder höher. Rechnungen sieht der Assistent nur, wenn der Mitarbeiter mindestens die Stufe Buchhaltung hat. Die Konfiguration sieht dann so aus:

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

So läuft ein Gespräch

Der Assistent holt sich zuerst den Tagesüberblick — mit dem heutigen Datum, damit „nächsten Dienstag" richtig aufgelöst wird. Antworten sind kurz und lesbar, so wie eine Auskunft am Telefon:

Du:      Wie sieht mein Tag aus?
Claude:  Mittwoch, 09.09.2026. Zwei Termine: 17:00 Alltagsgruppe (2/8 belegt, Tom),
         18:00 Mantrailing für Anfänger (Tom). Pension 0 von 3. Offen: 3 Terminanfragen,
         4 Pensionsanfragen, 1 Freischaltung. 3 Aufgaben überfällig, u. a. „Impfpässe der
         Neukunden prüfen". Rechnungen: 3 offen, alle überfällig (146,29 €).

Du:      Hat Koch die Rechnung R26080028 bezahlt?
Claude:  Nein. 95,00 €, seit 8 Tagen überfällig, fällig war der 01.09.

Du:      Leg Dienstag um 12 eine Einzelstunde mit Julia Meyer für Rocky an.
Claude:  Dienstag, 22.09.2026, 12:00–13:00, Einzelstunde mit Julia Meyer und Rocky,
         bei dir auf der Hundewiese. Läuft über die 5er-Karte (noch 1 von 5, danach 0).
         Keine Überschneidung. Soll ich den Termin anlegen?
Du:      Ja.
Claude:  Angelegt, Termin Nr. 360.

Jede Änderung läuft zweistufig: Der Assistent zeigt dir erst, was er anlegen würde — mit Wochentag, Uhrzeit, Leistung, Kunde, Tier, Mitarbeiter, Zahlweg und möglichen Überschneidungen. Gespeichert wird erst, wenn du zustimmst. Ein zweites „Leg das an" legt keinen zweiten Termin an, sondern meldet den vorhandenen.

Was der Assistent kann

Auskunft (Leseschlüssel)	Beispielsatz
Tagesüberblick	„Wie sieht mein Tag aus?" — „Was steht morgen an?"
Termine	„Welche Termine hat Meyer nächste Woche?"
Freie Zeiten	„Wann hat Anna am Donnerstag noch eine Stunde Zeit?"
Belegung	„Wie voll ist die Pension am Wochenende? Wer reist an?"
Anfragen	„Welche Anfragen sind offen?"
Kunden	„Such mir Frau Meyer aus Hamburg" — „Wer hat die Nummer 0171 …?" — „Was hat Meyer für ein Abo?"
Rechnungen	„Hat Koch die Rechnung bezahlt?" — „Wer ist überfällig?"
Aufgaben	„Was ist heute fällig?"

Anlegen und ändern (Schreibschlüssel)	Beispielsatz
Einzeltermin anlegen, verschieben, wiederholen	„Leg Dienstag 10 Uhr eine Einzelstunde mit Meyer für Rocky an" — „Verschieb den Termin auf 12:30" — „Wiederhol ihn wöchentlich, fünfmal"
Gruppentermin	„Neuer Welpengruppen-Termin am Mittwoch um 17 Uhr"
Kunde und Tier	„Neuer Kunde Jonas Weber, Telefon 0171 …, Hund Kalle, Labrador"
Vermerk	„Notier bei Rocky, dass er morgens Tabletten bekommt"
Aufgaben	„Erinner mich, Frau Meyer morgen zurückzurufen" — „Die Aufgabe mit den Impfpässen ist erledigt"

Was er bewusst nicht kann

Keine E-Mails an Kunden. Auch keine Terminbestätigung — die schickst du aus der Software, wenn du eine willst.
Keine Termine absagen oder löschen, keine Rechnungen stellen, keine Zahlungen buchen, keine Abos beenden.
Keine Stammdaten ändern (nur anlegen), keine Einstellungen, keine Preise.
Texte, die Kunden selbst geschrieben haben (Anfragetexte, Kommentare), bekommt der Assistent nicht zu sehen. Die liest du in der Software.

Das ist Absicht: Alles, was Geld bewegt oder einen Kunden anschreibt, bleibt eine bewusste Handlung in der Oberfläche.

Gut zu wissen

Der Server merkt sich nichts und schreibt nichts auf die Platte. Jeder Aufruf steht im Zugriffsprotokoll deiner Instanz (System → API-Schlüssel → Zugriffsprotokoll) mit dem Kennzeichen PetWorkers-MCP.
Die Schlüssel stehen in der Konfigurationsdatei deines Assistenten. Behandle sie wie ein Kennwort: nicht weitergeben, bei Verdacht in der Software neu vergeben.
Wenn du den Assistenten auf einem Rechner mit fester Adresse nutzt, kannst du die Schlüssel in der Software auf diese Absender-Adresse beschränken.
Die Firewall der Schnittstelle gilt unverändert: Tempo-Bremse, Absender-Sperre, Notaus. Ein normales Gespräch bleibt weit unter dem Kontingent.

Wenn etwas nicht geht

Meldung	Abhilfe
„fehlende Umgebungsvariablen"	`PETWORKERS_URL` und `PETWORKERS_API_KEY` müssen in der Konfiguration stehen.
„nur über HTTPS erreichbar"	Die Adresse muss mit `https://` beginnen.
„Kein oder ungültiger API-Schlüssel"	Schlüssel unter System → API-Schlüssel prüfen: aktiv, nicht abgelaufen, Absender-Adresse erlaubt?
Rechnungen fehlen im Tagesüberblick	Der Leseschlüssel braucht die Stufe Buchhaltung.
Der Assistent kann nur lesen	`PETWORKERS_API_KEY_WRITE` fehlt, oder der Schlüssel hat „Schreiben erlauben" nicht gesetzt.
„Der Schlüssel hat keinen Kontakt"	Zugang unter System → MCP einrichten (dort sind die Schlüssel immer einem Mitarbeiter zugeordnet) oder dem Schlüssel unter System → API-Schlüssel einen Kontakt zuordnen.
Ein Mitarbeiter soll keinen Zugriff mehr haben	Unter System → MCP den Zugang entfernen — die Datei auf seinem Rechner ist damit wertlos.
Claude Desktop zeigt kein Werkzeug	Pfad in `args` prüfen (voller Pfad zur `server.js`), Claude Desktop neu starten; `node server.js --pruefen` im Terminal zeigt den genauen Fehler.

Die Werkzeuge des Assistenten sind dieselben Aufrufe, die auf der Seite Assistent: Tagesüberblick, Termine anlegen, Kundenakte beschrieben sind — wer eigene Programme anbinden will, findet dort die Pfade.

Sprachassistent: PetWorkers mit Claude bedienen (MCP)