# dxMarine im KI-Assistenten (MCP)

> Jede dxMarine-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://<werft>.dxmarine.ch/api/mcp`
- Beispiel mit der Demo: `https://demo.dxmarine.ch/api/mcp` (Anmeldung nötig, Zugangsdaten auf Anfrage)
- Claude: Einstellungen, Connectors, eigenen Connector mit dieser Adresse hinzufügen, mit dem dxMarine-Konto anmelden (OAuth 2.1).
- ChatGPT: im Entwicklermodus einen eigenen Connector mit derselben Adresse anlegen.
- Alternativ ein API-Schlüssel aus dxMarine 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 Boote haben diese Saison eine Wartung fällig, und welche Kunden sind betroffen?»
- «Wie ist die Auslastung der Liegeplätze, und welche Plätze werden nächsten Monat frei?»
- «Was steht morgen im Kranplan?»
- «Bei welchen Booten läuft die Gewährleistung in den nächsten 90 Tagen ab?»
- «Welche Rechnungen sind über 30 Tage offen, und wie viele Stunden liefen letzten Monat auf den Auftrag «Winterlager Segelyacht»?»

### Beispielaufgaben

- Einen Auftrag mit Positionen aus dem Leistungskatalog für ein bestimmtes Boot anlegen.
- Zeiten und Material auf einen Werftauftrag erfassen.
- Lieferantenrechnungen aufnehmen, einen Kontovorschlag machen und zur Freigabe bereitlegen.
- Die Serviceheft-Einträge eines Boots durchsehen und die nächste Wartung vorbereiten.

- 299 Werkzeuge in der Demo, davon 151 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://dxmarine.ch/ki/mcp` mit den Werkzeugen produkt_info, funktionen, preise, testinstanz, demo_link, haeufige_fragen.

Kontakt: info@dxb.ch

Stand 2026-10-22