Xero MCP Server

Сервер Xero MCP

Это реализация сервера Model Context Protocol (MCP) для Xero. Она обеспечивает мост между протоколом MCP и API Xero, позволяя стандартизированный доступ к функциям учета и бизнеса Xero.

Функции

• Аутентификация Xero OAuth2 с настраиваемыми подключениями
• Управление контактами
• Управление планом счетов
• Создание и управление счетами
• Соответствие протоколу MCP

Предпосылки

• Node.js (v18 или выше)
• нпм или пнпм
• Учетная запись разработчика Xero с учетными данными API

Документы и ссылки

• Документация по публичному API Xero
• Xero API Explorer
• Спецификации Xero OpenAPI
• Документация по SDK публичного API Xero-Node
• Документация разработчика

Настраивать

Создать учетную запись Xero

Если у вас еще нет учетной записи и организации Xero, вы можете создать их, зарегистрировавшись здесь, используя бесплатную пробную версию.

Мы рекомендуем начать с Demo Company, поскольку она поставляется с некоторыми предварительно загруженными образцами данных. После входа в систему переключитесь на нее, используя верхний левый раскрывающийся список и выбрав "Demo Company". Вы можете сбросить данные Demo Company или изменить страну в любое время, используя верхний левый раскрывающийся список и перейдя в My Xero .

ПРИМЕЧАНИЕ. Для использования запросов, связанных с расчетом заработной платы, регионом должна быть Новая Зеландия или Великобритания.

Аутентификация

На сервере Xero MCP поддерживаются 2 режима аутентификации:

1. Пользовательские соединения

Это лучший выбор для тестирования и разработки, который позволяет вам указать идентификатор клиента и секреты для конкретной организации. Это также рекомендуемый подход, если вы интегрируете это в сторонние клиенты MCP, такие как Claude Desktop.

Настройка учетной записи разработчика Xero

Настройте пользовательское соединение, следуя этим инструкциям: https://developer.xero.com/documentation/guides/oauth2/custom-connections/

В настоящее время для всех сеансов требуются следующие области: области

Интеграция сервера MCP с Claude Desktop

Чтобы добавить сервер 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.

2. Токен на предъявителя

Это лучший выбор, если вы хотите поддерживать несколько учетных записей Xero во время выполнения и разрешить клиенту MCP выполнять поток аутентификации (например, PKCE) по мере необходимости. В этом случае используйте следующую конфигурацию:

ПРИМЕЧАНИЕ: XERO_CLIENT_BEARER_TOKEN будет иметь приоритет над XERO_CLIENT_ID , если он определен.

Доступные команды MCP

• list-accounts : Получить список учетных записей
• list-contacts : Получить список контактов из Xero
• list-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 Payroll
• list-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 .

Для разработчиков

Установка

Запустить сборку

Интеграция с Claude Desktop

Чтобы связать разрабатываемый сервер Xero MCP с Claude Desktop, перейдите в раздел «Настройки» > «Разработчик» > «Изменить конфигурацию» и добавьте в файл claude_desktop_config.json следующее:

ПРИМЕЧАНИЕ: Для Windows убедитесь, что путь args экранирует \ между папками, например, "C:\\projects\xero-mcp-server\\dist\\index.js"

Лицензия

Массачусетский технологический институт

Безопасность

Пожалуйста, не передавайте свой файл .env или какие-либо конфиденциальные учетные данные в систему контроля версий (они включены в .gitignore как безопасное значение по умолчанию).