# dxGarden im KI-Assistenten (MCP)

> Jede dxGarden-Instanz bringt einen MCP-Endpunkt mit. Claude, ChatGPT und andere Assistenten arbeiten damit in der eigenen Instanz, mit den Rechten des angemeldeten Benutzers.

## Verbinden

- Adresse der eigenen Instanz: `https://<betrieb>.dxgarden.ch/api/mcp`
- Beispiel mit der Demo: `https://demo.dxgarden.ch/api/mcp` (Anmeldung nötig, Zugangsdaten auf Anfrage)
- Claude: Einstellungen, Connectors, eigenen Connector mit dieser Adresse hinzufügen, mit dem dxGarden-Konto anmelden (OAuth 2.1).
- ChatGPT: im Entwicklermodus einen eigenen Connector mit derselben Adresse anlegen.
- Alternativ ein API-Schlüssel aus dxGarden als Bearer-Token.
- Protokoll: JSON-RPC 2.0 über Streamable HTTP, MCP 2025-06-18; Selbstauskunft unter `/api/mcp/info` der Instanz.

## Was der Assistent kann

- Fragen beantworten, etwa zu offenen Rechnungen oder Stunden je Auftrag.
- Adressen, Aufträge und Positionen pflegen, Lieferantenrechnungen buchen, Belege freigeben.

### Beispielfragen

- «Welche Rechnungen sind über 30 Tage offen, und wer wurde schon gemahnt?»
- «Wie viele Stunden liefen letzten Monat auf den Auftrag «Gartenumbau Müller», und wie weit liegt die Nachkalkulation über der Offerte?»
- «Wer ist nächste Woche auf welcher Baustelle eingeplant, und wo ist noch Kapazität frei?»
- «Welche Maschinen haben in den nächsten 30 Tagen einen Service fällig?»
- «Wie steht die Liquidität, und welche Kreditoren werden diese Woche fällig?»

### Beispielaufgaben

- Einen Auftrag mit Positionen aus dem Leistungskatalog anlegen oder einen bestehenden duplizieren.
- Einen Rapport mit Stunden, Material und Fotos erfassen, wenn jemand unterwegs nur diktiert hat.
- Lieferantenrechnungen aufnehmen, einen Kontovorschlag machen und zur Freigabe bereitlegen.
- Absenzen prüfen und den Lohnlauf vorab durchrechnen, bevor er gebucht wird.

- 319 Werkzeuge in der Demo, davon 159 lesend; sichtbar je nach Edition, Modulen und Rechten.

## Sicherheit

- Eigene Schlüssel je Instanz, jederzeit widerrufbar.
- Rechte entscheiden, welche Werkzeuge sichtbar sind.
- Schreibende Werkzeuge laufen als Testlauf, bis ausdrücklich gebucht wird.
- Schreibende Aufrufe im Audit-Log, Aufrufe je Schlüssel und Adresse begrenzt.
- Eine Datenbank und ein Container je Betrieb, Server in der Schweiz.

## Produktangaben per MCP

- Öffentlich und nur lesend: `https://dxgarden.ch/ki/mcp` mit den Werkzeugen produkt_info, funktionen, preise, testinstanz, demo_link, haeufige_fragen.

Kontakt: info@dxb.ch

Stand 2026-10-22