Сервер Xero MCP

Name: Xero MCP Server
Author: XeroAPI

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

Функции

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

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

Предпосылки

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

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

Настраивать

Создать учетную запись 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 следующее:

{ "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" } } } }

ПРИМЕЧАНИЕ: Если вы используете 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) по мере необходимости. В этом случае используйте следующую конфигурацию:

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

ПРИМЕЧАНИЕ: 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 .

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

Установка

# Using npm npm install # Using pnpm pnpm install

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

# Using npm npm run build # Using pnpm pnpm build

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

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

ПРИМЕЧАНИЕ: Для Windows убедитесь, что путь args экранирует \ между папками, например, "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" } } } }

Лицензия

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

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

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