Haufe X360 über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Haufe X360 klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Haufe X360 + Gemini

Haufe X360 Cloud-ERP (die deutsche Acumatica-Edition): Kunden, Lieferanten, Lagerartikel, Kundenaufträge, Ausgangsrechnungen und Lieferungen über die vertragsbasierte REST API. Sitzungsanmeldung mit einem X360-Benutzer. Nur lesend.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

X360_URL, X360_TENANT, X360_ENDPOINT_VERSION, X360_USERNAME, X360_PASSWORD

Schritt 1 — Zugangsdaten holen

1. Bitte deinen X360-Administrator oder deinen Haufe-Partner um einen eigenen Integrationsbenutzer mit den Rollen für die Masken, die er lesen soll: Kunden, Lieferanten, Lagerartikel, Kundenaufträge, Rechnungen und Lieferungen. X360 prüft dieselben Zugriffsrechte wie im Browser, die KI sieht also nur, was dieser Benutzer sehen darf.
2. Setze X360_URL auf die Adresse, mit der du X360 im Browser öffnest, bis ausschließlich /Main bzw. /Frames und ohne abschließenden Schrägstrich.
3. Setze X360_TENANT auf den Mandanten (Firmennamen), den du auf dem X360-Anmeldebildschirm auswählst.
4. Setze X360_ENDPOINT_VERSION auf eine Version des Default-Endpunkts, die in der Maske Web Service Endpoints (SM207060) aufgeführt ist, zum Beispiel 24.200.001. Ältere Versionen wie 20.200.001 oder 23.200.001 funktionieren auch: Die Felder, die die Tools nutzen, sind in allen gleich.
5. Trage in X360_USERNAME und X360_PASSWORD die Anmeldedaten des Integrationsbenutzers ein.
6. Installiere den Connector und führe haufe_x360_list_customers mit wenigen Datensätzen aus, um die Verbindung zu prüfen.

Basiert auf Acumatica: Haufe X360 ist die deutsche Acumatica-Edition, und jeder X360-Mandant bringt den vordefinierten Default-Webservice-Endpunkt von Acumatica mit. Genau diesen Endpunkt liest der Connector.

Bewusst nur lesend: Die KI liest Kunden, Lieferanten, Lagerartikel, Kundenaufträge, Ausgangsrechnungen mit Gutschriften und Lieferungen. Kein Tool legt einen Beleg an, ändert ihn oder gibt ihn frei.

Sitzungen und Lizenz: Deine X360-Lizenz begrenzt, wie viele API-Sitzungen gleichzeitig offen sein dürfen. Der Connector hält eine Sitzung, nutzt sie für jeden Aufruf und meldet sich neu an, wenn sie abläuft.

Erst wenige Datensätze abrufen: Ohne Begrenzung liefert die API alle Datensätze, deshalb fragt die KI beim ersten Aufruf immer eine begrenzte Anzahl ab. Positionen von Aufträgen und Rechnungen kommen nur, wenn sie Details erweitert; sonst liest sie nur den Kopf.

Darauf antwortet sie gut: welche Ausgangsrechnungen noch offen sind und mit welchem Betrag (haufe_x360_list_invoices), Kundenaufträge nach Status mit ihren Positionen (haufe_x360_list_sales_orders), welche Kundenaufträge eine Lieferung erfüllt (haufe_x360_list_shipments) sowie Zahlungsbedingungen und Einstellungen zur Kreditprüfung eines Kunden (haufe_x360_get_customer).

Belege anlegen, ändern oder freigeben gehört nicht dazu, ebenso wenig alles außer Kunden, Lieferanten, Lagerartikeln, Kundenaufträgen, Ausgangsrechnungen und Lieferungen.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Haufe X360-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Ausgangsrechnungen sind überfällig, und wie viel ist pro Kunde noch offen?“
• „Zeig mir die offenen Kundenaufträge des Kunden C000123 mit Positionen und Auftragssumme.“
• „Welche Lieferungen sind letzte Woche rausgegangen, und welche Kundenaufträge hat jede davon erfüllt?“
• „Liste unsere aktiven Lieferanten mit Lieferantenklasse und Zahlungsbedingungen auf.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden