Zum Inhalt
Novadesko Dokumentation
Handbuch Demo
Deutsch
App öffnen

Überblick über den MCP-Connector

Was der offizielle Novadesko-Connector für Claude, ChatGPT und Gemini macht, seine Adresse, kompatible Clients und der Ablauf einer Verbindung.

Aktualisiert am 23.10.2026 Diese Seite bearbeiten In der vollständigen Dokumentation öffnen

Novadesko stellt einen offiziellen MCP-Server (Model Context Protocol) bereit. Damit kann ein KI-Assistent die Daten eines Novadesko-Unternehmens lesen und Aktionen vorbereiten (Angebote, Rechnungen, Kunden, Mahnungen...), immer mit der ausdrücklichen Zustimmung des Nutzers. Dieselben Werkzeuge und Regeln gelten auch für Nova AI, den integrierten Assistenten.

Serveradresse

Offizielle Adresse für Ihren KI-Client: https://mcp.novadesko.com.

  • https://mcp.novadesko.com/mcp wird ebenfalls akzeptiert.
  • Die frühere Adresse https://web.novadesko.com/mcp funktioniert für bestehende Verbindungen weiter.
  • Ein Zugriffstoken gilt für alle drei Adressen.

HTTP-Transport: JSON-RPC-2.0-Nachrichten per POST. Akzeptierte Protokollversionen: 2025-06-18, 2025-03-26, 2024-11-05. Die Domain mcp.novadesko.com bedient nur MCP und OAuth: der Rest der Anwendung ist dort nicht erreichbar.

Kompatible Clients

ClientStatusHinweis
Claude (claude.ai, Desktop-App, Mobile App)verfügbarBenutzerdefinierter Connector; abhängig von Ihrem Claude-Tarif
Claude Codeverfügbarclaude mcp add --transport http
ChatGPTverfügbarConnectoren im Entwicklermodus
Gemini CLIverfügbargemini mcp add --transport http
Gemini EnterpriseGoogle-VorschauClient-ID wird vom Administrator in Novadesko erstellt
Gemini-App für Verbraucherin Belgien nicht verfügbarVon Google nur in den USA angekündigt, private Konten mit kostenpflichtigem Abo

Jeder andere MCP-Client mit OAuth 2.1 und dynamischer Registrierung kann sich verbinden. Seine Verbindungen erscheinen in Novadesko auf der Seite Integrationen, Claude, damit sie widerrufbar bleiben.

Ablauf einer Verbindung

  1. Der Client ruft https://mcp.novadesko.com ohne Token auf: Antwort 401 mit einem WWW-Authenticate-Header, der auf die OAuth-Metadaten verweist.
  2. Der Client liest die Metadaten, registriert sich automatisch (dynamische Registrierung) und öffnet die Novadesko-Autorisierungsseite.
  3. Der Nutzer meldet sich bei Bedarf bei Novadesko an, wählt ein Unternehmen und die Rechte und klickt auf Autorisieren.
  4. Der Client tauscht den Code gegen ein Zugriffstoken (PKCE S256) und ruft initialize und dann tools/list auf.
  5. Lesezugriffe laufen direkt. Jede Schreib- oder Sendeaktion läuft über ein Werkzeug prepare_*, das eine Vorschau und ein Bestätigungstoken liefert, und dann über confirm_action nach Zustimmung des Nutzers.
Novadesko-Autorisierungsbildschirm
Der Autorisierungsbildschirm (auf Französisch): ein Unternehmen, Rechte Lesen, Erstellen und Ändern, E-Mails und SMS senden.

Was der Server nicht anbietet

  • kein Versand von Dokumenten über Peppol (Peppol-Versand bleibt manuell in Novadesko);
  • kein Zugriff auf Dateien, das System, die Datenbank oder die Novadesko-Administration;
  • kein anderes Unternehmen als das bei der Autorisierung gewählte;
  • keine Kontolöschung und keine Passwortänderung.
Hinweis

Das Unternehmen stammt immer aus der OAuth-Verbindung, nie aus Argumenten. Parameter shop_id, company_id, user_id und ähnliche werden stillschweigend entfernt.

Siehe auch