Start KI-Anbindung
dxAnimal im KI-Assistenten
Jede dxAnimal-Instanz bringt einen MCP-Endpunkt mit. MCP (Model Context Protocol) ist der offene Standard, über den Claude, ChatGPT und andere Assistenten mit einer Anwendung arbeiten. Einmal verbunden, fragt der Assistent Ihre Daten ab und erledigt Arbeit in Ihrem Namen, mit Ihren Rechten.
Adresse des Endpunkts
Jeder Betrieb hat seine eigene Instanz und damit seine eigene Adresse:
https://<praxis>.dxanimal.ch/api/mcp
Beispiel mit der Demo: https://demo.dxanimal.ch/api/mcp. Die Demo verlangt wie jede Instanz eine Anmeldung; die Zugangsdaten schicken wir Ihnen auf Anfrage.
Claude verbinden
- In Claude (claude.ai oder Claude Desktop) unter Einstellungen, Connectors einen eigenen Connector hinzufügen.
- Die Adresse Ihrer Instanz eintragen, siehe oben.
- Claude öffnet die Anmeldung von dxAnimal. Mit dem gewohnten Konto anmelden und den Zugriff bestätigen (OAuth).
ChatGPT und andere Assistenten
ChatGPT verbindet sich im Entwicklermodus über einen eigenen Connector mit derselben Adresse und derselben Anmeldung. Jeder andere Assistent, der MCP über Streamable HTTP spricht, lässt sich ebenso anbinden, auch ein eigenes Modell im Haus. Statt der Anmeldung geht auch ein API-Schlüssel aus dxAnimal als Bearer-Token.
Was der Assistent damit kann
- Fragen in normaler Sprache beantworten, etwa «Welche Rechnungen sind über 30 Tage offen?» oder «Wie viele Stunden liefen letzten Monat auf diesen Auftrag?».
- Arbeit abgeben: Adressen anlegen und pflegen, Aufträge und Positionen setzen, Lieferantenrechnungen buchen, Belege freigeben.
- 247 Werkzeuge in der Demo, davon 127 lesend; welche sichtbar sind, hängt von der Edition, den eingeschalteten Modulen und den Rechten des Zugangs ab.
Sicherheit
- Eigene Schlüssel: Der Zugang hängt an Ihrem Konto oder an einem eigenen API-Schlüssel, der nur für Ihre Instanz gilt. Sie ziehen ihn jederzeit zurück.
- Rechte: Der Assistent sieht nur die Werkzeuge, die seine Rechte hergeben. Ein Lesezugang sieht die schreibenden Werkzeuge nicht.
- Erst prüfen, dann buchen: Jedes schreibende Werkzeug läuft als Testlauf, bis ausdrücklich gebucht wird. Periodensperre, Belegnummern und festgeschriebene Belege gelten unverändert.
- Protokoll: Schreibende Aufrufe stehen im Audit-Log. Aufrufe sind je Schlüssel und Adresse begrenzt, wiederholte Fehlversuche werden gesperrt und gemeldet.
- Daten in der Schweiz: Eine Datenbank und ein Container je Betrieb, Server in der Schweiz. Welchen Assistenten Sie anbinden, entscheiden Sie.
Für Entwicklerinnen und Entwickler
- JSON-RPC 2.0 über Streamable HTTP, MCP 2025-06-18:
initialize,tools/list,tools/call,ping. - OAuth 2.1 mit Discovery unter
/.well-known/oauth-protected-resourceder Instanz. - Selbstauskunft ohne Anmeldung:
GET /api/mcp/infoder Instanz. - Produktangaben zu dxAnimal ohne Anmeldung, nur lesend:
https://dxanimal.ch/ki/mcp(Werkzeugeprodukt_info,funktionen,preise,testinstanz,demo_link,haeufige_fragen).