> 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 deckt den Alltag im ERP von der Frage bis zur Buchung ab und bringt dafür eigene Schutzmechanismen mit. | Merkmal | Was es für Dich bedeutet | | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Über 50 Werkzeuge** | Suchen, Auswerten, Verkauf und Einkauf, Stammdaten, CRM, Druckvorlagen, Wiki und Stapelverarbeitung – lesend und schreibend. | | **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** | Bei heiklen Änderungen zeigt der Assistent zuerst, was passieren würde, und führt es erst nach Deiner Freigabe aus. | | **Fertige Abläufe (Agenten)** | Stammdaten-Prüfung, Buchhaltungs-Check und Dispo-Lauf arbeiten mehrere Schritte ab und halten vor dem Schreiben für Deine Freigabe an. | | **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 erst analysiert und vor dem Schreiben auf Deine Freigabe wartet. | | 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 Änderungen möglich. | | **Schreiben mit Bestätigung** | Anlegen und Ändern erlaubt; destruktive Aktionen erfordern eine Bestätigung. | | **Autonom schreiben** | Schreibt auch destruktive Aktionen **ohne** Bestätigung. Nur für vertrauenswürdige, überwachte Automationen. | 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 die Wiki-Werkzeuge, keine ERP-Daten, auch nicht lesend. Die Zugriffsstufe darüber spielt dann keine Rolle. | {% 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. * [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.