Xero MCP-Server

Dies ist eine Model Context Protocol (MCP)-Serverimplementierung für Xero. Sie bildet eine Brücke zwischen dem MCP-Protokoll und der Xero-API und ermöglicht einen standardisierten Zugriff auf die Buchhaltungs- und Geschäftsfunktionen von Xero.

Merkmale

Xero OAuth2-Authentifizierung mit benutzerdefinierten Verbindungen
Kontaktverwaltung
Kontenplanverwaltung
Rechnungserstellung und -verwaltung
MCP-Protokoll-Konformität

Related MCP server: ABAP-ADT-API MCP-Server

Voraussetzungen

Node.js (v18 oder höher)
npm oder pnpm
Ein Xero-Entwicklerkonto mit API-Anmeldeinformationen

Dokumente und Links

Aufstellen

Erstellen Sie ein Xero-Konto

Wenn Sie noch kein Xero-Konto und keine Xero-Organisation haben, können Sie eines erstellen, indem Sie sich hier mit der kostenlosen Testversion anmelden.

Wir empfehlen Ihnen, zunächst eine Demo-Firma zu verwenden, da diese bereits Beispieldaten enthält. Wechseln Sie nach der Anmeldung über das Dropdown-Menü oben links dorthin und wählen Sie „Demo-Firma“. Sie können die Daten einer Demo-Firma jederzeit zurücksetzen oder das Land ändern, indem Sie über das Dropdown-Menü oben links zu „Mein Xero“ navigieren.

HINWEIS: Um gehaltsspezifische Abfragen zu verwenden, sollte die Region entweder Neuseeland oder Großbritannien sein.

Authentifizierung

Der Xero MCP-Server unterstützt zwei Authentifizierungsmodi:

1. Benutzerdefinierte Verbindungen

Dies ist die bessere Wahl für Tests und Entwicklung, da Sie Client-ID und Geheimnisse für eine bestimmte Organisation angeben können. Dies ist auch der empfohlene Ansatz, wenn Sie dies in MCP-Clients von Drittanbietern wie Claude Desktop integrieren.

Konfigurieren Ihres Xero-Entwicklerkontos

Richten Sie eine benutzerdefinierte Verbindung gemäß diesen Anweisungen ein: https://developer.xero.com/documentation/guides/oauth2/custom-connections/

Derzeit sind für alle Sitzungen folgende Bereiche erforderlich: Bereiche

Integration des MCP-Servers mit Claude Desktop

Um den MCP-Server zu Claude hinzuzufügen, gehen Sie zu Einstellungen > Entwickler > Konfiguration bearbeiten und fügen Sie Folgendes zu Ihrer Datei claude_desktop_config.json hinzu:

{ "mcpServers": { "xero": { "command": "npx", "args": ["-y", "@xeroapi/xero-mcp-server@latest"], "env": { "XERO_CLIENT_ID": "your_client_id_here", "XERO_CLIENT_SECRET": "your_client_secret_here" } } } }

HINWEIS: Wenn Sie den Abschnitt „Befehl“ des Node Version Managers verwenden "command": "npx" ändern Sie ihn in den vollständigen Pfad zur ausführbaren Datei, z. B.: your_home_directory/.nvm/versions/node/v22.14.0/bin/npx auf Mac/Linux oder "your_home_directory\\.nvm\\versions\\node\\v22.14.0\\bin\\npx" unter Windows

2. Inhaber-Token

Dies ist die bessere Wahl, wenn Sie mehrere Xero-Konten zur Laufzeit unterstützen und dem MCP-Client bei Bedarf die Ausführung eines Authentifizierungsflusses (z. B. PKCE) ermöglichen möchten. Verwenden Sie in diesem Fall die folgende Konfiguration:

{ "mcpServers": { "xero": { "command": "npx", "args": ["-y", "@xeroapi/xero-mcp-server@latest"], "env": { "XERO_CLIENT_BEARER_TOKEN": "your_bearer_token" } } } }

HINWEIS: Das XERO_CLIENT_BEARER_TOKEN hat Vorrang vor der XERO_CLIENT_ID , sofern definiert.

Verfügbare MCP-Befehle

list-accounts : Ruft eine Liste der Konten ab
list-contacts : Ruft eine Kontaktliste von Xero ab
list-credit-notes : Ruft eine Liste der Gutschriften ab
list-invoices : Ruft eine Liste der Rechnungen ab
list-items : Ruft eine Liste von Elementen ab
list-organisation-details : Details zu einer Organisation abrufen
list-profit-and-loss : Gewinn- und Verlustbericht abrufen
list-quotes : Ruft eine Liste mit Zitaten ab
list-tax-rates : Ruft eine Liste der Steuersätze ab
list-payments : Ruft eine Liste der Zahlungen ab
list-trial-balance : Rufen Sie einen Bilanzbericht ab
list-profit-and-loss : Gewinn- und Verlustbericht abrufen
list-bank-transactions : Ruft eine Liste der Bankkontotransaktionen ab
list-payroll-employees : Ruft eine Liste der Lohn- und Gehaltsabrechnungsmitarbeiter ab
list-report-balance-sheet : Einen Bilanzbericht abrufen
list-payroll-employee-leave : Abrufen der Urlaubsaufzeichnungen eines Lohnbuchhalters
list-payroll-employee-leave-balances : Urlaubsguthaben eines Lohnbuchhalters abrufen
list-payroll-employee-leave-types : Ruft eine Liste der Gehaltsabrechnungsurlaubsarten ab
list-payroll-leave-periods : Ruft eine Liste der Urlaubszeiten eines Lohnbuchhalters ab
list-payroll-leave-types : Rufen Sie eine Liste aller verfügbaren Urlaubsarten in Xero Payroll ab
list-aged-receivables-by-contact : Ruft die überfälligen Forderungen für einen Kontakt ab
list-aged-payables-by-contact : Ruft die überfälligen Verbindlichkeiten für einen Kontakt ab
list-contact-groups : Ruft eine Liste der Kontaktgruppen ab
create-contact : Einen neuen Kontakt erstellen
create-credit-note : Erstellen Sie eine neue Gutschrift
create-invoice : Eine neue Rechnung erstellen
create-payment : Eine neue Zahlung erstellen
create-quote : Neues Angebot erstellen
create-credit-note : Erstellen Sie eine neue Gutschrift
create-payroll-timesheet : Erstellen Sie ein neues Arbeitszeitblatt für die Lohn- und Gehaltsabrechnung
update-contact : Aktualisieren Sie einen vorhandenen Kontakt
update-invoice : Aktualisieren Sie einen vorhandenen Rechnungsentwurf
update-quote : Aktualisieren Sie einen vorhandenen Angebotsentwurf
update-credit-note : Aktualisieren Sie einen vorhandenen Gutschriftsentwurf
update-payroll-timesheet-line : Aktualisieren Sie eine Zeile in einem vorhandenen Lohn- und Gehaltsabrechnungs-Zeitnachweis
approve-payroll-timesheet : Genehmigen Sie einen Stundenzettel für die Gehaltsabrechnung
revert-payroll-timesheet : Setzt einen genehmigten Lohn- und Gehaltsabrechnungs-Zeitnachweis zurück
add-payroll-timesheet-line : Neue Zeile zu einem vorhandenen Lohn- und Gehaltsabrechnungs-Zeitnachweis hinzufügen
delete-payroll-timesheet : Löscht eine vorhandene Lohn- und Gehaltszeittabelle
get-payroll-timesheet : Ruft eine vorhandene Lohn- und Gehaltsabrechnung ab

Eine ausführliche API-Dokumentation finden Sie in der MCP-Protokollspezifikation .

Für Entwickler

Installation

# Using npm npm install # Using pnpm pnpm install

Ausführen eines Builds

# Using npm npm run build # Using pnpm pnpm build

Integration mit Claude Desktop

Um Ihren Xero MCP-Server in der Entwicklung mit Claude Desktop zu verknüpfen, gehen Sie zu Einstellungen > Entwickler > Konfiguration bearbeiten und fügen Sie Folgendes zu Ihrer Datei claude_desktop_config.json hinzu:

HINWEIS: Stellen Sie unter Windows sicher, dass der args das \ zwischen den Ordnern vermeidet, d. h. "C:\\projects\xero-mcp-server\\dist\\index.js"

{ "mcpServers": { "xero": { "command": "node", "args": ["insert-your-file-path-here/xero-mcp-server/dist/index.js"], "env": { "XERO_CLIENT_ID": "your_client_id_here", "XERO_CLIENT_SECRET": "your_client_secret_here" } } } }

Lizenz

MIT

Sicherheit

Bitte übergeben Sie Ihre .env Datei oder vertrauliche Anmeldeinformationen nicht der Versionskontrolle (sie sind als sicherer Standard in .gitignore enthalten).