Integrations
Provides a bridge to Xero's accounting and business features, including contact management, chart of accounts management, and invoice creation and management, using OAuth2 authentication.
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
Voraussetzungen
- Node.js (v18 oder höher)
- npm oder pnpm
- Ein Xero-Entwicklerkonto mit API-Anmeldeinformationen
Dokumente und Links
- Xero Public API-Dokumentation
- Xero API Explorer
- Xero OpenAPI-Spezifikationen
- Xero-Node Public API SDK-Dokumente
- Entwicklerdokumentation
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:
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:
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 ablist-contacts
: Ruft eine Kontaktliste von Xero ablist-credit-notes
: Ruft eine Liste der Gutschriften ablist-invoices
: Ruft eine Liste der Rechnungen ablist-items
: Ruft eine Liste von Elementen ablist-organisation-details
: Details zu einer Organisation abrufenlist-profit-and-loss
: Gewinn- und Verlustbericht abrufenlist-quotes
: Ruft eine Liste mit Zitaten ablist-tax-rates
: Ruft eine Liste der Steuersätze ablist-payments
: Ruft eine Liste der Zahlungen ablist-trial-balance
: Rufen Sie einen Bilanzbericht ablist-profit-and-loss
: Gewinn- und Verlustbericht abrufenlist-bank-transactions
: Ruft eine Liste der Bankkontotransaktionen ablist-payroll-employees
: Ruft eine Liste der Lohn- und Gehaltsabrechnungsmitarbeiter ablist-report-balance-sheet
: Einen Bilanzbericht abrufenlist-payroll-employee-leave
: Abrufen der Urlaubsaufzeichnungen eines Lohnbuchhalterslist-payroll-employee-leave-balances
: Urlaubsguthaben eines Lohnbuchhalters abrufenlist-payroll-employee-leave-types
: Ruft eine Liste der Gehaltsabrechnungsurlaubsarten ablist-payroll-leave-periods
: Ruft eine Liste der Urlaubszeiten eines Lohnbuchhalters ablist-payroll-leave-types
: Rufen Sie eine Liste aller verfügbaren Urlaubsarten in Xero Payroll ablist-aged-receivables-by-contact
: Ruft die überfälligen Forderungen für einen Kontakt ablist-aged-payables-by-contact
: Ruft die überfälligen Verbindlichkeiten für einen Kontakt ablist-contact-groups
: Ruft eine Liste der Kontaktgruppen abcreate-contact
: Einen neuen Kontakt erstellencreate-credit-note
: Erstellen Sie eine neue Gutschriftcreate-invoice
: Eine neue Rechnung erstellencreate-payment
: Eine neue Zahlung erstellencreate-quote
: Neues Angebot erstellencreate-credit-note
: Erstellen Sie eine neue Gutschriftcreate-payroll-timesheet
: Erstellen Sie ein neues Arbeitszeitblatt für die Lohn- und Gehaltsabrechnungupdate-contact
: Aktualisieren Sie einen vorhandenen Kontaktupdate-invoice
: Aktualisieren Sie einen vorhandenen Rechnungsentwurfupdate-quote
: Aktualisieren Sie einen vorhandenen Angebotsentwurfupdate-credit-note
: Aktualisieren Sie einen vorhandenen Gutschriftsentwurfupdate-payroll-timesheet-line
: Aktualisieren Sie eine Zeile in einem vorhandenen Lohn- und Gehaltsabrechnungs-Zeitnachweisapprove-payroll-timesheet
: Genehmigen Sie einen Stundenzettel für die Gehaltsabrechnungrevert-payroll-timesheet
: Setzt einen genehmigten Lohn- und Gehaltsabrechnungs-Zeitnachweis zurückadd-payroll-timesheet-line
: Neue Zeile zu einem vorhandenen Lohn- und Gehaltsabrechnungs-Zeitnachweis hinzufügendelete-payroll-timesheet
: Löscht eine vorhandene Lohn- und Gehaltszeittabelleget-payroll-timesheet
: Ruft eine vorhandene Lohn- und Gehaltsabrechnung ab
Eine ausführliche API-Dokumentation finden Sie in der MCP-Protokollspezifikation .
Für Entwickler
Installation
Ausführen eines Builds
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"
Lizenz
MIT
Sicherheit
Bitte übergeben Sie Ihre .env
Datei oder vertrauliche Anmeldeinformationen nicht der Versionskontrolle (sie sind als sicherer Standard in .gitignore
enthalten).
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Eine Model Context Protocol-Serverimplementierung, die standardisierten Zugriff auf die Buchhaltungs- und Geschäftsfunktionen von Xero bietet und Vorgänge wie Kontaktverwaltung, Rechnungserstellung und Kontenplanverwaltung über MCP ermöglicht.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server implementation that provides database interaction and business intelligence capabilities through SQLite. This server enables running SQL queries, analyzing business data, and automatically generating business insight memos.Last updated -645,669JavaScriptMIT License
- AsecurityAlicenseAqualityA beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.Last updated -3936JavaScriptApache 2.0
- -securityAlicense-qualityMCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.Last updated -43TypeScriptMIT License
- -securityFlicense-qualityAn MCP server that exposes the XTB trading API, allowing users to interact with their XTB trading accounts through the Model Context Protocol to perform operations like account management, market data retrieval, and trade execution.Last updated -6TypeScript