Xero в MCP: управляйте Xero из любого AI-агента

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Xero, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Xero

Дайте ИИ читать вашу бухгалтерию в Xero: счета клиентам и счета поставщиков, контакты клиентов и поставщиков, план счетов, оборотно-сальдовую ведомость (Trial Balance) и отчёт о прибылях и убытках со сравнением периодов, по методу начисления или кассовому методу. Только чтение, с вашим собственным OAuth2-приложением Xero и входом через Authorize with Provider.

Настройка

1. Войдите на developer.xero.com/app/manage (My Apps) и создайте OAuth2-приложение типа Web app (поток authorization code).
2. В качестве redirect URI укажите https://cloud.anythingmcp.com/api/mcp-oauth/callback для AnythingMCP Cloud или <URL вашего AnythingMCP>/api/mcp-oauth/callback, если вы размещаете AnythingMCP сами. URI должен совпадать в точности.
3. На странице Configuration приложения скопируйте Client ID в XERO_CLIENT_ID, затем сгенерируйте client secret и вставьте его в XERO_CLIENT_SECRET.
4. Оставьте XERO_TENANT_ID и XERO_REFRESH_TOKEN пустыми и установите коннектор. На странице коннектора нажмите Authorize with Provider, войдите в Xero и подключите организацию, которую должен читать ИИ.
5. Выполните xero_list_connections. Выберите запись с нужным tenantName и tenantType ORGANISATION и скопируйте её tenantId в XERO_TENANT_ID. Не используйте id или authEventId подключения: это другие значения. Пока XERO_TENANT_ID не задан, остальные инструменты останавливаются до обращения к Xero и называют недостающую переменную.
6. Выполните xero_get_organisation и проверьте название организации, прежде чем ИИ прочитает какие-либо цифры. Один коннектор читает одну организацию; для второй установите его ещё раз.

Как не потерять авторизацию: access-токены действуют 30 минут и обновляются автоматически, а AnythingMCP сохраняет каждый новый refresh-токен, который выдаёт Xero. Refresh-токен, который не обновлялся 60 дней, истекает; тогда снова нажмите Authorize with Provider. Заполняйте XERO_REFRESH_TOKEN, только если у вас уже есть действующий refresh-токен для того же приложения с тем же согласием только на чтение, и не используйте один refresh-токен в двух интеграциях: Xero заменяет его при каждом обновлении, и у одной из них остался бы недействительный.

Только чтение изначально: все десять инструментов только читают (GET); ни один не создаёт, не изменяет и не удаляет бухгалтерские данные. Коннектор запрашивает scope только для чтения: openid offline_access accounting.invoices.read accounting.contacts.read accounting.settings.read accounting.reports.trialbalance.read accounting.reports.profitandloss.read. Xero добавляет согласия, а не заменяет их: если приложению раньше давали права на запись, токен их сохраняет. Чтобы сузить права, отзовите старое подключение в Xero и снова нажмите Authorize with Provider. Кроме того, ИИ видит только то, что может видеть пользователь Xero, выполнивший вход; для отчётов этому пользователю нужен доступ к отчётам.

Счета, контакты и план счетов: xero_list_invoices возвращает вместе счета клиентам (ACCREC) и счета поставщиков (ACCPAY). Фильтруйте через where, например Type=="ACCREC", и сортируйте через order, например InvoiceNumber ASC. Счета и контакты приходят страницами до 100 записей; ИИ запрашивает следующие страницы, пока страница не вернётся пустой или неполной. xero_list_contacts ищет по именам, номерам контактов и адресам электронной почты и по запросу включает архивные контакты. План счетов приходит целиком. xero_get_invoice, xero_get_contact и xero_get_account требуют UUID из соответствующего списка, а не номер счёта, имя контакта или код бухгалтерского счёта.

Отчёты: xero_get_trial_balance принимает одну дату date, xero_get_profit_and_loss принимает fromDate и toDate (формат YYYY-MM-DD). Оба строятся по методу начисления, если не запросить кассовый метод (paymentsOnly). Отчёт о прибылях и убытках может сравнивать от 1 до 12 периодов по месяцам, кварталам или годам (periods и timeframe).

Частые ошибки: 401 или 403 означает, что нет согласия, авторизация истекла, у пользователя Xero не хватает прав или организация не подключена к этому приложению: сверьте XERO_TENANT_ID с результатом xero_list_connections, затем снова нажмите Authorize with Provider. 429 означает, что достигнут лимит запросов Xero для организации: ИИ ждёт указанное в Retry-After число секунд и только потом повторяет запрос, а заголовок X-Rate-Limit-Problem показывает, какой лимит превышен. Лимиты зависят от уровня вашего приложения, см. лимиты API Xero.

Коннектор ничего не создаёт, не изменяет и не удаляет в Xero и не читает банковские операции, бухгалтерский баланс, расчёт зарплаты, файлы и вложения.

Предварительные требования: XERO_CLIENT_ID, XERO_CLIENT_SECRET

Локальная установка коннектора

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Откройте http://localhost:3000/connectors/store, выберите Xero и введите переменные, перечисленные в Предварительных требованиях.

Доступные инструменты

Примеры запросов

• «Какие счета клиентам ещё не оплачены и сколько всего нам должен каждый клиент?»
• «Покажи отчёт о прибылях и убытках за прошлый квартал в сравнении с тремя предыдущими кварталами.»
• «Какие счета поставщиков нужно оплатить в ближайшие 14 дней и на какие суммы?»
• «Найди Acme Ltd в наших контактах и покажи адрес электронной почты, адрес для выставления счетов и непогашенный остаток.»

Следующие шаги

• Подключить к Claude
• Подключить к ChatGPT