Sprachassistent: PetWorkers mit Claude bedienen (MCP)

Mit einem Sprachassistenten kannst du Termine und Kunden in PetWorkers abfragen. Dafür verbindest du Claude Desktop oder Claude Code mit PetWorkers.

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.

MCP („Model Context Protocol“) ist der offene Standard, über den solche Assistenten Werkzeuge nutzen. 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).

So richtest du Claude ein

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

1. Öffne als Administrator System → MCP.
2. Klicke auf Paket herunterladen.
3. Entpacke das Paket in einen dauerhaften Ordner, zum Beispiel ~/petworkers-mcp.
4. Führe im entpackten Ordner einmal npm install aus. Das installiert die benötigten Programmbestandteile.
5. Wähle auf der MCP-Seite den Mitarbeiter aus.
6. Aktiviere bei Bedarf Auch anlegen dürfen (Termine, Kunden, Tiere, Vermerke, Aufgaben).
7. Klicke auf Zugang einrichten. PetWorkers legt die passenden API-Schlüssel an.
8. Klicke beim Mitarbeiter unter Eingerichtete Zugänge auf Claude Desktop.
9. Ersetze in der heruntergeladenen Datei claude_desktop_config.json den Platzhalter /PFAD/ZUM/ENTPACKTEN/ORDNER/petworkers-mcp/server.js durch den vollständigen Pfad zur entpackten server.js.
10. Öffne in Claude Desktop Einstellungen → Entwickler → Konfiguration bearbeiten.
11. Füge die Konfiguration dort ein.
12. Starte Claude Desktop neu. Prüfe, ob PetWorkers als Werkzeug verfügbar ist.

Für Claude Code zeigt Claude Code einen fertigen Befehl zum Kopieren. Ersetze auch dort den Programmpfad und führe den Befehl im Terminal aus. Die Schlüssel findest du unter System → API-Schlüssel; auf der MCP-Seite kannst du den Zugang entfernen.

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

Was macht das? Dieser Terminalbefehl prüft die Verbindung und liest den Tagesüberblick. Ersetze die Platzhalter durch deine Konfigurationswerte.

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 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 einem aktiven Mitarbeiter als Kontakt zugeordnet, mindestens Stufe Beratung, Training & Betreuung. Rechnungen sieht der Assistent nur, wenn der Mitarbeiter mindestens die Stufe BackOffice (Büro & Buchhaltung) hat. Die Konfiguration sieht dann so aus:

Was macht das? Diese Konfiguration verbindet Claude mit dem lokalen PetWorkers-Programm und den beiden Schlüsseln.

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

Was macht das? Dieses erfundene Gespräch zeigt Auskunft, Vorschau und anschließende Termin-Anlage.

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.

Arbeite bei Änderungen zweistufig: Der Assistent zeigt dir erst, was er anlegen würde — mit Wochentag, Uhrzeit, Leistung, Kunde, Tier, Mitarbeiter, Zahlweg und möglichen Überschneidungen. Der Assistent soll erst nach deiner Zustimmung ausführen. Technisch speichert ein Aufruf mit ausfuehren=true; eine vorherige Vorschau wird nicht als Freigabe gespeichert. Ein identischer Einzeltermin wird als Dublette erkannt. Das ersetzt keine sorgfältige Prüfung anderer Schreibaktionen.

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?"
Leistungen	„Welche Leistungen kann ich für Termine buchen?" — „Was kostet die 10er-Karte?" — „Welche Digitalprodukte gibt es im Shop?"
Shop-Verkäufe	„Was hat Meyer im Shop gekauft?" — „Welche Downloads sind noch nicht zugestellt?" (nur mit Stufe BackOffice (Büro & Buchhaltung))
Rechnungen und Gutschriften	„Hat Koch die Rechnung bezahlt?" — „Wer ist überfällig?" — „Welche Gutschriften hat Koch bekommen?"
Angebote	„Welche Angebote sind noch offen?" — „Hat Koch das Angebot angenommen?" (nur lesen, nur mit Stufe BackOffice (Büro & Buchhaltung))
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. Die Protokollierung richtet sich nach „Was wird mitgeschrieben“ im verwendeten Schlüssel. Protokollierte Aufrufe stehen unter (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.

Weitere Fehler gezielt prüfen

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 BackOffice (Büro & 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.