← MCP-Verzeichnis

Xero MCP-Server

offiziell

Xero betreibt einen eigenen gehosteten MCP-Server, den Developer Remote MCP, der Buchhaltungsdaten lesen und schreiben kann, und pflegt zusätzlich einen Open-Source-Server, der lokal läuft und Kontakte, Rechnungen, Zahlungen, Berichte und Lohnabrechnung abdeckt. Außerdem gibt es einen Xero-Connector im Claude-Verzeichnis, der schreibgeschützt ist.

Was ein Agent tun kann

  • → GuV und Bilanz lesen
  • → Rechnungen auflisten und erstellen
  • → Kontakte und Kontenplan verwalten
  • → Zahlungen und Banktransaktionen erfassen
  • → Lohn- und Zeiterfassungsdaten lesen

Der gehostete Server ist ab dem Entwicklertarif Core enthalten, funktioniert nicht mit Custom Connections und fragt laut Xero vor Änderungen nicht nach einer Bestätigung. Der lokale Server kann ebenfalls in die Buchhaltung schreiben und benötigt pro Organisation eine Xero-App mit Custom Connection.

Über den Xero MCP-Server

Xero bietet drei Wege, auf denen ein KI-Assistent die Buchhaltung erreicht, und alle drei stammen von Xero. Der erste ist ein schreibgeschützter Connector im Claude-Verzeichnis. Der zweite ist der Developer Remote MCP, ein Server, den Xero selbst unter api.xero.com betreibt und der für eigene Agenten gedacht ist. Der dritte ist ein Open-Source-Server, den Sie lokal ausführen.

Unternehmer und Steuerkanzleien fragen über den Connector nach Gewinn, Liquidität, Rechnungen und Kunden und erhalten Antworten mit Link zum Bericht oder zur Rechnung in Xero. Xero selbst nennt wöchentliche Mandantenbriefings, Quartalsrückblicke und die Suche nach möglichen doppelten Rechnungen. Mit den Schreibwerkzeugen des Servers kann ein Agent außerdem Rechnungen, Kontakte, Angebote, Zahlungen und manuelle Buchungen anlegen.

Der Connector in Claude kann nichts anlegen, ändern, freigeben, abstimmen oder bezahlen, und er folgt Ihren Berechtigungen in Xero. Der gehostete und der lokale Server können dagegen schreiben, und Xero weist darauf hin, dass die Werkzeuge der Version 1 vor einer Änderung nicht um Bestätigung bitten. Weisen Sie den Agenten an, vorher nachzufragen. Die Aufrufe zählen gegen dieselben Tagesgrenzen wie die Xero-API.

Das können Sie fragen

  • Wie sieht die Gewinn- und Verlustrechnung der letzten vier Quartale aus, und was hat sich am stärksten verändert?
  • Wer sind unsere fünf größten Kunden nach Umsatz in den letzten zwölf Monaten?
  • Gibt es in den letzten 60 Tagen Rechnungen mit demselben Kunden und Betrag, die Dubletten sein könnten?
  • Listen Sie die offenen Forderungen pro Kontakt auf, die mehr als 30 Tage überfällig sind.
  • Legen Sie einen Rechnungsentwurf an Acme Ltd über 12 Beratungsstunden an und zeigen Sie ihn mir vor dem Speichern.

Werkzeuge des Servers

  • list-invoices
  • list-contacts
  • list-accounts
  • list-payments
  • list-bank-transactions
  • list-profit-and-loss
  • list-report-balance-sheet
  • list-trial-balance
  • list-aged-receivables-by-contact
  • list-aged-payables-by-contact
  • list-quotes
  • list-credit-notes
  • list-organisation-details
  • create-invoice
  • update-invoice
  • create-contact
  • create-payment
  • create-bank-transaction
  • create-quote
  • create-manual-journal

So verbinden Sie Xero

  1. Wenn Sie nur Antworten in Claude möchten: Fügen Sie Xero aus dem Connector-Verzeichnis von Claude hinzu, melden Sie sich mit Ihrem Xero-Login an und wählen Sie die Organisation. Der Connector ist schreibgeschützt.
  2. Wenn Sie einen eigenen Agenten bauen: Legen Sie bei Xero eine App an, die sich mit PKCE anmeldet. Der Developer Remote MCP ist ab dem Tarif Core enthalten. Im Tarif Starter funktioniert er nur mit der Demo-Organisation, und Apps mit Custom Connections können ihn nicht nutzen.
  3. Tragen Sie https://api.xero.com/mcp/v1 als Remote-Server in Claude Desktop, Claude Code, Cursor oder VS Code ein und geben Sie den Zugriff für jede Organisation frei.
  4. Wenn Sie lieber lokal arbeiten: Starten Sie das Paket @xeroapi/xero-mcp-server mit npx und tragen Sie Client-ID und Client-Secret einer Custom Connection ein. Dafür ist Node.js 18 oder neuer nötig.
  5. Beginnen Sie mit der Demo Company von Xero, die Beispieldaten enthält, bevor Sie die echte Buchhaltung anbinden.

Enthalten in diesen Paketen

Xero ist in diesen Walma-Paketen enthalten.

Fragen zu Xero MCP

Ist Xero MCP kostenlos?+

Der Connector in Claude kostet nichts extra: Xero berechnet dafür nichts, Sie brauchen aber ein aktives Xero-Abonnement, und ein kostenloses oder bezahltes Claude-Konto genügt. Der Developer Remote MCP ist für Apps ab dem Entwicklertarif Core enthalten, Starter-Apps dürfen nur die Demo-Organisation nutzen. Der lokale Server ist Open Source unter der MIT-Lizenz.

Wie lautet die URL des Xero-MCP-Servers?+

Der gehostete Server, der Developer Remote MCP, liegt unter https://api.xero.com/mcp/v1 und läuft auf der eigenen Infrastruktur von Xero. Der lokale Open-Source-Server ist als npm-Paket @xeroapi/xero-mcp-server und unter github.com/XeroAPI/xero-mcp-server verfügbar. Der Connector in Claude braucht keine URL, er wird aus dem Claude-Verzeichnis hinzugefügt.

Wie funktioniert die Anmeldung?+

Der gehostete Server nutzt Xero OAuth 2.0 mit PKCE, ein Client-Secret ist also nicht nötig, und jede Organisation wird über die übliche Zustimmung von Xero freigegeben. Apps mit Custom Connections können den gehosteten Server nicht nutzen. Der lokale Server meldet sich mit Client-ID und Client-Secret einer Custom Connection an oder mit einem fertigen Bearer-Token. Der Connector in Claude nutzt Ihr normales Xero-Login.

Ist Xero MCP schreibgeschützt?+

Das hängt vom gewählten Weg ab. Der Connector in Claude ist schreibgeschützt: Claude kann nichts anlegen, ändern, freigeben, abstimmen oder bezahlen. Der Developer Remote MCP und der lokale Server können lesen und schreiben. Xero schreibt, dass die Werkzeuge der Version 1 keine Bestätigung vor Änderungen verlangen, und rät, den Agenten anzuweisen, vorher bei Ihnen nachzufragen.

Mit welchen KI-Assistenten funktioniert Xero MCP?+

Der schreibgeschützte Connector ist für Claude gemacht. Für den gehosteten Server dokumentiert Xero Claude Desktop, Claude Code, Cursor und VS Code und schreibt, dass sich jeder Client verbinden kann, der Remote-MCP-Server unterstützt, sofern er die OAuth-Anmeldung beherrscht. Für den lokalen Server beschreibt Xero die Konfiguration in Claude Desktop.

Welche Limits gelten für die Anzahl der Aufrufe?+

Für den gehosteten Server gelten dieselben Grenzen wie für die Xero-API: 1.000 Aufrufe pro Tag und Organisation für Apps im Tarif Starter und 5.000 pro Tag und Organisation ab Core. API-Aufrufe werden unter Ihrer App im Entwicklerportal protokolliert. Werkzeugaufrufe und Eingaben protokolliert Xero dagegen nicht, führen Sie also bei Bedarf ein eigenes Protokoll.

Kann eine Verbindung mehrere Xero-Organisationen erreichen?+

Ja, mit dem gehosteten Server. Eine App kann mit mehreren Organisationen verbunden werden, wenn der Nutzer jeder einzeln zustimmt, der Agent kann sie auflisten, und jeder Werkzeugaufruf läuft gegen genau eine Organisation. Im Claude-Connector ist der Zugriff auf die verbundene Organisation begrenzt, und Daten verschiedener Organisationen werden nicht vermischt. Steuerberater und Buchhalter können zwischen Mandanten wechseln.

Fehlt Ihnen eine Anbindung?

Wir bauen und prüfen MCP-Server für Teams, die sie brauchen, und betreiben sie hinter derselben Richtlinie und demselben Protokoll wie das restliche Gateway.