> For the complete documentation index, see [llms.txt](https://help.vario-software.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.vario-software.de/vario-cloud-handbuch/kuenstliche-intelligenz/mcp-server.md). # Eigene KI verbinden – MCP-Server Verbinde Claude, ChatGPT, Cursor, VS Code, Gemini oder n8n mit VARIO Cloud. Dein KI-Assistent sucht, wertet aus, legt Belege an und pflegt Stammdaten mit Deinen Rechten. Die **MCP-Server-App** macht VARIO Cloud zu einem ERP, mit dem KI-Assistenten direkt arbeiten können. Du verbindest ein KI-Tool wie Claude, ChatGPT, Cursor oder VS Code mit Deiner VARIO Cloud, und der Assistent sucht, wertet aus, legt Belege an, pflegt Stammdaten und passt Druckvorlagen an – mit Deinen Rechten und auf Wunsch erst nach Deiner Freigabe. MCP steht für **Model Context Protocol**, einen offenen Standard, über den KI-Tools mit fremden Systemen sprechen. Statt Daten zu exportieren und in einen Chat zu kopieren, fragt der Assistent die VARIO Cloud live ab und arbeitet mit den aktuellen Zahlen aus Deinem ERP. {% hint style="warning" %} **Achtung: MCP-Zugänge ermöglichen weitreichende Eingriffe in deine Unternehmensdaten** Über den MCP-Server können verbundene KI-Assistenten und Anwendungen – abhängig von den vergebenen Zugriffs- und Benutzerrechten – Daten lesen, anlegen, verändern oder löschen sowie Geschäftsprozesse auslösen. Diese Aktionen betreffen deinen tatsächlichen Datenbestand in VARIO Cloud. Fehlerhafte oder missverstandene Anweisungen können unbeabsichtigte Änderungen, Datenverluste und unerwünschte Folgeaktionen verursachen. **Nicht alle Aktionen und deren Auswirkungen lassen sich rückgängig machen. Eine vollständige Wiederherstellung ist nicht für jeden Vorgang möglich.** Bei **„Autonom schreiben“** können auch weitreichende Änderungen **ohne zusätzlichen Bestätigungsschritt** ausgeführt werden. Auch bei „Schreiben mit Bestätigung“ wird nicht jede einzelne Änderung vorab zur Bestätigung vorgelegt. Vergib deshalb nur die tatsächlich benötigten Rechte, schütze die Zugangsdaten und verbinde ausschließlich vertrauenswürdige Anwendungen. Prüfe geplante Änderungen sorgfältig und überwache automatisierte Abläufe. {% endhint %} ## Überblick Nach der Installation der App im Admin-Center findest Du in den **Benutzereinstellungen** den neuen Reiter **MCP-Server**. Dort legst Du je KI-Tool einen **Zugang** an: Du wählst das Tool, die Zugriffsstufe und den Wiki-Umfang und bekommst einen **API-Key** sowie die fertige Konfiguration zum Einfügen. Jeder Zugang gehört Dir persönlich. Der Assistent sieht und darf nur das, was Du selbst sehen und darfst – ein Zugang kann Deine Rechte nie erweitern. ## Voraussetzungen * Die **MCP-Server-App** ist im Admin-Center installiert. * Für **Schreiben mit Bestätigung** und **Autonom schreiben** brauchst Du mindestens den Plan **Plus**. Mit einem kleineren Plan stehen nur die lesenden Werkzeuge zur Verfügung. * Ein KI-Tool, das MCP über HTTP unterstützt. {% hint style="info" %} Wie Apps installiert werden und wo Du Protokolle, Migrationen und Berechtigungen einer App findest, steht unter [Apps](/vario-cloud-handbuch/system/apps.md). {% endhint %} ## Was zeichnet den MCP-Server von VARIO Cloud aus? Der MCP-Server ist kein reiner Datenleser. Er unterstützt Dich von der Auskunft bis zur Beleg- und Stammdatenbearbeitung und bringt dafür eigene Schutzmechanismen mit. | Merkmal | Was es für Dich bedeutet | | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Werkzeugkatalog nach Aufgaben** | Der [Werkzeugkatalog](/vario-cloud-handbuch/kuenstliche-intelligenz/mcp-server/werkzeugkatalog.md) beschreibt die verfügbaren Werkzeuge einzeln: Zweck, benötigter Zugriff und Beispiele – von Abfragen bis zu Dashboards, Preis- und Lagerpflege. | | **Zugriff auf die REST-API** | Wofür es kein eigenes Werkzeug gibt, erreicht der Assistent über die REST-API Deiner VARIO Cloud – geprüft gegen deren Beschreibung und abhängig von der Zugriffsstufe mit Vorschau vor Änderungen. | | **Druckvorlagen mit Prüfung** | Der Assistent liest und ändert Drucklayouts, prüft sie gegen echte Daten und nennt die Ursache, wenn ein Druck scheitert. | | **Deine Rechte** | Jeder Zugang arbeitet mit den Rechten Deines Benutzers. Was Du nicht sehen darfst, sieht auch der Assistent nicht. | | **Drei Zugriffsstufen** | Von **Nur lesen** über **Schreiben mit Bestätigung** bis **Autonom schreiben** legst Du fest, wie weit ein Zugang reicht. | | **Vorschau vor dem Schreiben** | Im Modus **Schreiben mit Bestätigung** verlangen heikle Änderungen eine Vorschau und Freigabe. Einfache Neuanlagen können unmittelbar erfolgen. | | **Fertige Abläufe (Agenten)** | Stammdaten-Prüfung, Buchhaltungs-Check und Dispo-Lauf arbeiten mehrere Schritte ab. Mit **Schreiben mit Bestätigung** warten sie vor Änderungen auf Deine Freigabe; mit **Autonom schreiben** können sie diese direkt ausführen. | | **Interaktive Ansichten** | Tagesbriefing, Belegvorschau und Freigaben erscheinen in geeigneten KI-Tools als klickbare Karte statt als reiner Text. | | **Eingebautes Fachwissen** | Der Assistent kennt die Abfragesprache [VQL](/vario-cloud-handbuch/auswertungen/freie-vql.md), den Belegablauf, die Stapelverarbeitung und die Ausgabe-Module und schlägt bei Bedarf selbst nach. | | **Viele KI-Tools** | Claude, ChatGPT, Cursor, VS Code, Windsurf, Gemini CLI, LM Studio, n8n und jedes weitere Tool, das MCP über HTTP spricht. | | **Protokoll** | Jede Aktion landet im Protokoll der App und ist Deinem Zugang zugeordnet. | ## Begriffe | Begriff | Bedeutung | | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | MCP | Offener Standard, über den ein KI-Tool Werkzeuge eines anderen Systems aufruft. | | Zugang | Ein von Dir erzeugter API-Key mit fester Zugriffsstufe und festem Wiki-Umfang. | | Werkzeug (Tool) | Eine einzelne Funktion, die der Assistent aufrufen kann – z. B. „Beleg anlegen“. | | Bestätigung (Preview → Confirm) | Der Assistent zeigt erst, was passieren würde, und führt es erst nach Deiner Freigabe aus. | | Agent | Ein fertiger Ablauf aus mehreren Schritten, der analysiert und konkrete Änderungen vorschlägt. Ob er vor dem Schreiben wartet, hängt von der Zugriffsstufe ab. | | Interaktive Ansicht | Eine Karte mit Kennzahlen, Tabellen oder Knöpfen, die das KI-Tool direkt im Chat anzeigt. | | Druckvorlage | Ein Drucklayout (JRXML) in einem Ausgabe-Modul, z. B. für den Belegdruck oder Artikeletiketten. | | Rückgängig | Ausgewählte Schreibaktionen des Assistenten lassen sich zurücknehmen. | | Wiki-Seite | Ein Markdown-Dokument im DMS, das an einer Adresse, einem Deal, einem Projekt oder einem Artikel hängt – oder global gilt. | ## Felder beim Verbinden Die Karte **„KI-Assistent verbinden“** führt Dich durch drei Auswahlfelder. ### KI-Tool wählen | Feld | Bedeutung | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **KI-Tool wählen** | Bestimmt, welche Konfiguration Du am Ende bekommst. Zur Auswahl stehen unter anderem Claude Desktop, Claude Code, ChatGPT, Cursor, VS Code, Windsurf, Gemini CLI, LM Studio und n8n. Für alles andere nimmst Du **Generisch (HTTP)** oder **Anderes**. | ### Zugriffsrechte | Option | Bedeutung | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | **Nur lesen** | Suchen und Daten abfragen. Keine ERP-Änderungen möglich. | | **Schreiben mit Bestätigung** | Anlegen und Ändern erlaubt; destruktive Aktionen erfordern eine Bestätigung. | | **Autonom schreiben** | Darf auch weitreichende Änderungen ohne zusätzliche Freigabe ausführen. Einzelne Werkzeuge verlangen weiterhin eine Bestätigung. | Ohne den Plan **Plus** sind beide Schreibstufen ausgegraut; der Tooltip lautet dann „Schreibzugriff ist erst ab dem Plan Plus möglich.“ ### Wiki | Option | Bedeutung | | --------------------- | -------------------------------------------------------------------------------------------------------------- | | **Kein Wiki-Zugriff** | Die Wiki-Werkzeuge sind für diesen Zugang nicht sichtbar. | | **Wiki zusätzlich** | Wiki-Seiten lesen, anlegen, ändern und löschen – zusätzlich zu den ERP-Werkzeugen der gewählten Zugriffsstufe. | | **Nur Wiki** | Ausschließlich Wiki-Seiten und zugehörige Hilfswerkzeuge; keine ERP-Daten, auch nicht lesend. | Wiki-Rechte werden getrennt von ERP-Schreibrechten vergeben. Mit **Wiki zusätzlich** oder **Nur Wiki** kannst Du bei passendem Plan und Benutzerrechten auch Wiki-Seiten pflegen, ohne ERP-Schreibzugriff zu erteilen. Im Plan **Core** bleibt auch das Wiki lesend. {% hint style="info" %} Eine Option, die Du selbst nicht besitzt, ist ausgegraut. Der Tooltip dazu lautet „Du darfst dieses Recht nicht vergeben.“ Wende Dich in dem Fall an Deinen Administrator. {% endhint %} ## So gehst Du vor {% stepper %} {% step %} ### Reiter öffnen Öffne die **Benutzereinstellungen** und wechsle in den Reiter **MCP-Server**. {% endstep %} {% step %} ### KI-Tool wählen Wähle unter **„KI-Tool wählen“** das Programm, mit dem Du arbeitest. {% endstep %} {% step %} ### Zugriffsstufe und Wiki festlegen Entscheide unter **Zugriffsrechte**, ob der Assistent nur lesen oder auch schreiben darf, und lege unter **Wiki** fest, ob er Wiki-Seiten sehen und pflegen darf. Fang im Zweifel mit **Nur lesen** an. Du kannst jederzeit einen zweiten Zugang mit mehr Rechten anlegen. {% endstep %} {% step %} ### Verbinden Klicke auf **„Verbinden“**. VARIO erzeugt den Zugang und zeigt die Karte **„Deine Verbindung zu …“**. {% endstep %} {% step %} ### API-Key übernehmen Kopiere den **API-Key** oder die fertige **Konfiguration** in Dein KI-Tool. Bei einigen Tools genügt der angebotene Installations-Link. {% hint style="warning" %} Der API-Key ist mit **„Nur einmal sichtbar“** gekennzeichnet: Er wird genau einmal angezeigt und ist später nicht mehr abrufbar. Hast Du ihn verloren, lege einen neuen Zugang an und lösche den alten. {% endhint %} {% endstep %} {% step %} ### Verbindung prüfen Stelle Deinem Assistenten eine einfache Frage zu Deinen Daten – etwa nach einem Kunden oder einem Artikel. Antwortet er mit echten Werten aus Deiner VARIO Cloud, steht die Verbindung. {% endstep %} {% endstepper %} ## Weiterführende Anleitungen * [Funktionen und Beispiele](/vario-cloud-handbuch/kuenstliche-intelligenz/mcp-server/funktionen-und-beispiele.md): Werkzeuge, Agenten, interaktive Ansichten und Beispiele für Deine Arbeit mit dem Assistenten. * [Werkzeugkatalog](/vario-cloud-handbuch/kuenstliche-intelligenz/mcp-server/werkzeugkatalog.md): alle Werkzeuge nach Aufgaben, mit Zweck, Zugriff und konkreten Grenzen. * [Zugänge und Sicherheit](/vario-cloud-handbuch/kuenstliche-intelligenz/mcp-server/zugaenge-und-sicherheit.md): Benutzerrechte, Schutzmechanismen und Verwaltung Deiner Zugänge. ## Häufige Fragen ### Kann ich VARIO Cloud mit ChatGPT, Claude oder Gemini verbinden? Ja. Über die MCP-Server-App verbindest Du VARIO Cloud mit Claude, ChatGPT, Gemini CLI, Cursor, VS Code, Windsurf, LM Studio und n8n. Jedes weitere KI-Tool, das MCP über HTTP unterstützt, bindest Du über **Generisch (HTTP)** an. ### Brauche ich dafür eine eigene KI oder Programmierkenntnisse? Nein. Du nutzt das KI-Tool, mit dem Du ohnehin arbeitest, und fügst dort die fertige Konfiguration aus dem Reiter **MCP-Server** ein. Die Abfragen formuliert der Assistent selbst. ### Warum kann ich „Autonom schreiben“ nicht auswählen? Sind beide Schreibstufen ausgegraut, fehlt Deiner VARIO Cloud der Plan **Plus**. Ist nur **Autonom schreiben** gesperrt, fehlt Dir das Recht dafür. Die Option zeigt dann den Hinweis „Du darfst dieses Recht nicht vergeben.“ Dein Administrator kann Dir das Recht über Deine Benutzerrolle geben. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.vario-software.de/vario-cloud-handbuch/kuenstliche-intelligenz/mcp-server.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.