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.
Это реализация сервера Model Context Protocol (MCP) для Xero. Она обеспечивает мост между протоколом MCP и API Xero, позволяя стандартизированный доступ к функциям учета и бизнеса Xero.
Если у вас еще нет учетной записи и организации Xero, вы можете создать их, зарегистрировавшись здесь, используя бесплатную пробную версию.
Мы рекомендуем начать с Demo Company, поскольку она поставляется с некоторыми предварительно загруженными образцами данных. После входа в систему переключитесь на нее, используя верхний левый раскрывающийся список и выбрав "Demo Company". Вы можете сбросить данные Demo Company или изменить страну в любое время, используя верхний левый раскрывающийся список и перейдя в My Xero .
ПРИМЕЧАНИЕ. Для использования запросов, связанных с расчетом заработной платы, регионом должна быть Новая Зеландия или Великобритания.
На сервере Xero MCP поддерживаются 2 режима аутентификации:
Это лучший выбор для тестирования и разработки, который позволяет вам указать идентификатор клиента и секреты для конкретной организации. Это также рекомендуемый подход, если вы интегрируете это в сторонние клиенты MCP, такие как Claude Desktop.
Настройте пользовательское соединение, следуя этим инструкциям: https://developer.xero.com/documentation/guides/oauth2/custom-connections/
В настоящее время для всех сеансов требуются следующие области: области
Чтобы добавить сервер MCP в Claude, перейдите в «Настройки» > «Разработчик» > «Изменить конфигурацию» и добавьте в файл claude_desktop_config.json следующее:
ПРИМЕЧАНИЕ: Если вы используете Node Version Manager , то в разделе "command": "npx" измените его на полный путь к исполняемому файлу, например: your_home_directory/.nvm/versions/node/v22.14.0/bin/npx на Mac / Linux или "your_home_directory\\.nvm\\versions\\node\\v22.14.0\\bin\\npx" на Windows.
Это лучший выбор, если вы хотите поддерживать несколько учетных записей Xero во время выполнения и разрешить клиенту MCP выполнять поток аутентификации (например, PKCE) по мере необходимости. В этом случае используйте следующую конфигурацию:
ПРИМЕЧАНИЕ: XERO_CLIENT_BEARER_TOKEN будет иметь приоритет над XERO_CLIENT_ID , если он определен.
list-accounts : Получить список учетных записейlist-contacts : Получить список контактов из Xerolist-credit-notes : Получить список кредитных нотlist-invoices : Получить список счетов-фактурlist-items : Получить список элементовlist-organisation-details : Получить сведения об организацииlist-profit-and-loss : Получить отчет о прибылях и убыткахlist-quotes : Получить список цитатlist-tax-rates : Получить список налоговых ставокlist-payments : Получить список платежейlist-trial-balance : Получить отчет о пробном балансеlist-profit-and-loss : Получить отчет о прибылях и убыткахlist-bank-transactions : Получить список транзакций по банковскому счетуlist-payroll-employees : Получить список сотрудников по заработной платеlist-report-balance-sheet : Получить отчет о балансеlist-payroll-employee-leave : Извлечение записей об отпусках сотрудников по расчету заработной платыlist-payroll-employee-leave-balances : Получить остатки отпусков сотрудника по расчету заработной платыlist-payroll-employee-leave-types : Получить список типов отпусков по заработной платеlist-payroll-leave-periods : Получить список периодов отпуска сотрудника по расчету заработной платыlist-payroll-leave-types : Получить список всех доступных типов отпусков в Xero Payrolllist-aged-receivables-by-contact : Извлекает просроченную дебиторскую задолженность для контактаlist-aged-payables-by-contact : Извлекает просроченную кредиторскую задолженность для контактаlist-contact-groups : Получить список групп контактовcreate-contact : Создать новый контактcreate-credit-note : Создать новую кредитную запискуcreate-invoice : Создать новый счет-фактуруcreate-payment : Создать новый платежcreate-quote : Создать новую цитатуcreate-credit-note : Создать новую кредитную запискуcreate-payroll-timesheet : Создать новый табель учета рабочего времениupdate-contact : Обновить существующий контактupdate-invoice : Обновить существующий черновик счета-фактурыupdate-quote : Обновить существующий проект цитатыupdate-credit-note : Обновить существующий проект кредитной нотыupdate-payroll-timesheet-line : Обновить строку в существующем табеле учета рабочего времениapprove-payroll-timesheet : Утвердить табель учета рабочего времениrevert-payroll-timesheet : Возврат утвержденного табеля учета рабочего времениadd-payroll-timesheet-line : Добавить новую строку в существующий табель учета рабочего времениdelete-payroll-timesheet : Удалить существующий табель учета рабочего времениget-payroll-timesheet : Получить существующий табель учета рабочего времениПодробную документацию по API можно найти в спецификации протокола MCP .
Чтобы связать разрабатываемый сервер Xero MCP с Claude Desktop, перейдите в раздел «Настройки» > «Разработчик» > «Изменить конфигурацию» и добавьте в файл claude_desktop_config.json следующее:
ПРИМЕЧАНИЕ: Для Windows убедитесь, что путь args экранирует \ между папками, например, "C:\\projects\xero-mcp-server\\dist\\index.js"
Массачусетский технологический институт
Пожалуйста, не передавайте свой файл .env или какие-либо конфиденциальные учетные данные в систему контроля версий (они включены в .gitignore как безопасное значение по умолчанию).
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.
Реализация сервера Model Context Protocol, обеспечивающая стандартизированный доступ к функциям учета и ведения бизнеса Xero, позволяя выполнять такие операции, как управление контактами, создание счетов-фактур и управление планами счетов через MCP.