Xero über MCP mit Microsoft Copilot verbinden

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

Xero + Microsoft Copilot

Lass deine KI deine Xero-Buchhaltung lesen: Ausgangs- und Eingangsrechnungen, Kunden- und Lieferantenkontakte, den Kontenplan, die Summen- und Saldenliste (Trial Balance) und die Gewinn- und Verlustrechnung mit Periodenvergleich, periodengerecht oder auf Zahlungsbasis. Nur lesend, mit deiner eigenen Xero-OAuth2-App und einer Anmeldung über Authorize with Provider.

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:

XERO_CLIENT_ID, XERO_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

1. Melde dich unter developer.xero.com/app/manage (My Apps) an und lege eine OAuth2-App vom Typ Web app an (Authorization-Code-Flow).
2. Trage als Redirect-URI https://cloud.anythingmcp.com/api/mcp-oauth/callback für AnythingMCP Cloud ein, oder <deine AnythingMCP-URL>/api/mcp-oauth/callback, wenn du AnythingMCP selbst betreibst. Die URI muss exakt übereinstimmen.
3. Kopiere auf der Seite Configuration der App die Client ID in XERO_CLIENT_ID, erzeuge dann ein Client Secret und trage es in XERO_CLIENT_SECRET ein.
4. Lass XERO_TENANT_ID und XERO_REFRESH_TOKEN leer und installiere den Connector. Klicke auf der Connector-Seite auf Authorize with Provider, melde dich bei Xero an und verbinde die Organisation, die die KI lesen soll.
5. Führe xero_list_connections aus. Wähle den Eintrag mit dem richtigen tenantName und dem tenantType ORGANISATION und kopiere seine tenantId in XERO_TENANT_ID. Nimm nicht die id oder authEventId der Verbindung: Das sind andere Werte. Solange XERO_TENANT_ID fehlt, brechen die übrigen Tools vor dem Aufruf bei Xero ab und nennen die fehlende Variable.
6. Führe xero_get_organisation aus und prüfe den Namen der Organisation, bevor die KI Zahlen liest. Ein Connector liest genau eine Organisation; für eine zweite installierst du ihn erneut.

Angemeldet bleiben: Access-Tokens gelten 30 Minuten und werden automatisch erneuert, und AnythingMCP speichert jeden neuen Refresh-Token, den Xero ausgibt. Ein Refresh-Token, der 60 Tage lang nicht erneuert wird, läuft ab; dann klickst du erneut auf Authorize with Provider. Trag XERO_REFRESH_TOKEN nur ein, wenn du schon einen gültigen Refresh-Token für dieselbe App mit derselben Nur-lesen-Zustimmung hast, und teile einen Refresh-Token nicht mit einer anderen Integration: Xero ersetzt ihn bei jeder Erneuerung, und eine der beiden bliebe mit einem ungültigen Token zurück.

Von Haus aus nur lesend: Alle zehn Tools lesen nur (GET); keines legt Buchhaltungsdaten an, ändert oder löscht sie. Der Connector fordert die Lese-Scopes openid offline_access accounting.invoices.read accounting.contacts.read accounting.settings.read accounting.reports.trialbalance.read accounting.reports.profitandloss.read an. Xero erweitert eine Zustimmung, statt sie zu ersetzen: Wurde die App früher mit Schreibrechten autorisiert, behält der Token diese Rechte. Um das einzuschränken, widerrufst du die alte Verbindung in Xero und klickst erneut auf Authorize with Provider. Die KI sieht außerdem nur, was der Xero-Benutzer sehen darf, der sich anmeldet; für die Berichte braucht er Zugriff auf Reports.

Rechnungen, Kontakte und Konten: xero_list_invoices liefert Ausgangsrechnungen (ACCREC) und Eingangsrechnungen (ACCPAY) zusammen. Filtere mit where, zum Beispiel Type=="ACCREC", und sortiere mit order, zum Beispiel InvoiceNumber ASC. Rechnungen und Kontakte kommen in Seiten zu höchstens 100 Einträgen; die KI blättert weiter, bis eine Seite leer oder unvollständig zurückkommt. xero_list_contacts sucht in Namen, Kontaktnummern und E-Mail-Adressen und zeigt auf Wunsch auch archivierte Kontakte. Der Kontenplan kommt in einem Stück. xero_get_invoice, xero_get_contact und xero_get_account brauchen die UUID aus der passenden Liste, keine Rechnungsnummer, keinen Kontaktnamen und keine Kontonummer.

Berichte: xero_get_trial_balance nimmt ein date, xero_get_profit_and_loss ein fromDate und ein toDate (Format YYYY-MM-DD). Beide rechnen periodengerecht, außer du verlangst die Zahlungsbasis (paymentsOnly). Die Gewinn- und Verlustrechnung kann 1 bis 12 Perioden nach Monat, Quartal oder Jahr vergleichen (periods und timeframe).

Häufige Fehler: 401 oder 403 heißt fehlende Zustimmung, abgelaufene Autorisierung, ein Xero-Benutzer ohne die nötigen Rechte oder eine Organisation, die nicht mit dieser App verbunden ist: Vergleiche XERO_TENANT_ID mit xero_list_connections und klicke dann erneut auf Authorize with Provider. 429 heißt, dass das Rate Limit von Xero für die Organisation erreicht ist: Die KI wartet die in Retry-After genannten Sekunden, bevor sie es erneut versucht, und der Header X-Rate-Limit-Problem nennt das betroffene Limit. Die Limits hängen von der Stufe deiner App ab, siehe Xeros API-Limits.

Der Connector legt in Xero nichts an, ändert und löscht nichts, und er liest keine Banktransaktionen, keine Bilanz, keine Lohnabrechnung und keine Dateien oder Anhänge.

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 Xero-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 noch offen, und wie viel schuldet uns jeder Kunde insgesamt?“
• „Zeig mir die Gewinn- und Verlustrechnung für das letzte Quartal im Vergleich zu den drei Quartalen davor.“
• „Welche Lieferantenrechnungen werden in den nächsten 14 Tagen fällig, und über welche Beträge?“
• „Such Acme GmbH in unseren Kontakten und zeig mir E-Mail-Adresse, Rechnungsadresse und offenen Saldo.“

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