Haufe X360 über MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Haufe X360-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden