Xero MCP Server

Что умеет сервер

Сервер соединяет протокол MCP с API Xero. Он поддерживает OAuth2 с пользовательскими подключениями, управление контактами и планом счетов, создание и ведение счетов. Команды чтения охватывают счета, контакты, кредит-ноты, позиции, ручные проводки, платежи, банковские операции, котировки, налоговые ставки, отчёты (прибыли и убытков, баланс, оборотно-сальдовая ведомость) и данные расчёта зарплаты: сотрудники, отпуска, табели.

Для запросов по зарплате регион организации должен быть NZ или UK.

Когда использовать

Подходит бухгалтерам и владельцам бизнеса на Xero: получить отчёт о прибылях и убытках, найти неоплаченные счета, свериться с банковскими операциями, подготовить счёт для контакта. Разработчики используют сервер как опорный пример интеграции с API Xero.

Начинать авторы советуют с демо-компании Xero, в ней уже есть образцы данных, и её можно сбросить.

Ограничения и безопасность

Нужны Node.js 18 или новее и учётные данные разработчика Xero. Рекомендуемый режим — пользовательское подключение (Custom Connection) для конкретной организации. Набор требуемых прав зависит от даты создания подключения: до 29 апреля 2026 года — пакетные права, начиная с этой даты — детальные. Сервер сам пробует сначала первый набор, затем второй, а перечень можно задать переменной XERO_SCOPES.

Второй режим — токен-носитель, когда клиент сам проводит авторизацию (например, PKCE) для нескольких аккаунтов. Агент работает с бухгалтерскими данными, часть из них — закрытые персональные данные сотрудников, поэтому ограничивайте права подключения только нужными областями. Некоторые права Xero объявлены устаревшими в пользу детальных.

Claude Desktop (пользовательское подключение)

Создайте Custom Connection в аккаунте разработчика Xero по инструкции Xero. Затем откройте Settings, Developer, Edit config и добавьте в 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",
        "XERO_SCOPES": "accounting.invoices accounting.contacts accounting.settings"
      }
    }
  }
}

Переменная XERO_SCOPES необязательна; если её нет, используются области по умолчанию.

Если вы используете Node Version Manager, замените "command": "npx" на полный путь к исполняемому файлу, например your_home_directory/.nvm/versions/node/v22.14.0/bin/npx в Mac / Linux.

Токен-носитель

Когда MCP-клиент сам проводит авторизацию:

{
  "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. Токен нужно получать с областями, которые перечислены в README (например, accounting.invoices, accounting.payments, accounting.contacts, accounting.settings).