mcp-xero — MCP-сервер для Claude Code: что делает и как установить
Подключает облачную бухгалтерию Xero к ИИ-ассистенту. Позволяет создавать счета, выгружать баланс, регистрировать платежи и контакты прямо из чата.
claude mcp add mcp-xero -e XERO_ACCESS_TOKEN=<XERO_ACCESS_TOKEN> -e XERO_TENANT_ID=<XERO_TENANT_ID> -- npx -y @codespar/mcp-xeroЧто делает mcp-xero
Сервер предоставляет 24 инструмента для управления учётом в Xero. Через протокол MCP агент может искать контрагентов, выставлять инвойсы, аннулировать их, отправлять подтверждённые счета на почту клиентам и регистрировать входящие или исходящие банковские операции. Также поддерживается получение финансового отчёта Balance Sheet и просмотр плана счетов.
Для запросов сервер использует готовый OAuth2 bearer-токен и идентификатор организации XERO_TENANT_ID. Сервер не обновляет токены сам: авторизацию и ротацию refresh-токена нужно настроить отдельно во внешнем сервисе. Если токен истечёт, API Xero вернёт ошибку 401.
По умолчанию запуск выполняется через stdio с помощью npx -y @codespar/mcp-xero. При выборке списков доступна серверная фильтрация параметром where, позволяющая отбирать записи по статусу или датам.
Какие задачи решает
- выставлять и отправлять счета клиентам из диалога
- проверять задолженности и балансовый отчёт компании
- заносить банковские транзакции и платежи по счетам
- искать и архивировать карточки контрагентов
Примеры запросов агенту
- Выстави клиенту ACME счёт за разработку и отправь его на контактный email
- Найди все непогашенные инвойсы в Xero со статусом AUTHORISED
- Покажи отчёт Balance Sheet за текущий финансовый период
Как установить mcp-xero
Командой платформы
claude mcp add mcp-xero -e XERO_ACCESS_TOKEN=<XERO_ACCESS_TOKEN> -e XERO_TENANT_ID=<XERO_TENANT_ID> -- npx -y @codespar/mcp-xeroВместо <…> подставьте свои значения
Командой платформы
codex mcp add xero --env XERO_ACCESS_TOKEN=<XERO_ACCESS_TOKEN> --env XERO_TENANT_ID=<XERO_TENANT_ID> -- npx -y @codespar/mcp-xeroВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"xero": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-xero"
],
"env": {
"XERO_ACCESS_TOKEN": "<XERO_ACCESS_TOKEN>",
"XERO_TENANT_ID": "<XERO_TENANT_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"xero": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-xero"
],
"env": {
"XERO_ACCESS_TOKEN": "<XERO_ACCESS_TOKEN>",
"XERO_TENANT_ID": "<XERO_TENANT_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e XERO_ACCESS_TOKEN=<XERO_ACCESS_TOKEN> -e XERO_TENANT_ID=<XERO_TENANT_ID> xero npx -y @codespar/mcp-xeroВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-xero
Как установить mcp-xero в Claude Code?
В Claude Code сервер добавляется командой claude mcp add mcp-xero -e XERO_ACCESS_TOKEN=<XERO_ACCESS_TOKEN> -e XERO_TENANT_ID=<XERO_TENANT_ID> -- npx -y @codespar/mcp-xero. Значения токена и идентификатора тенанта подставляются вместо плейсхолдеров.
Что умеет mcp-xero?
Сервер даёт модели доступ к 24 методам Xero. Он помогает выставлять счета, фиксировать поступления, просматривать баланс и вести справочник контрагентов.
Как устроена авторизация в mcp-xero?
Сервер принимает готовый bearer-токен через переменную XERO_ACCESS_TOKEN. Логику первичной OAuth-авторизации и продления сессии необходимо держать во внешнем сервисе, так как сам сервер ротацией токенов не занимается.
