Xero и MCP: проверка счетов и контактов, платежи — человеку

Как подключить агента к Xero для чтения счетов и контактов, ограничить scopes и оставить внесение записей и платежи человеку.

Обновлено 31 Oct 2026 6 мин чтения 6 просмотров

🎯 Для Small-team owners, bookkeepers and developers planning an agent that reads Xero data for drafts and checks.

📚 Вы узнаете

Distinguish hosted and local Xero MCP setup
Separate read scopes from data-changing tools
Connect an editor client and verify the organisation
Prepare a reviewable draft while keeping posting and payments human

У Xero есть официальный облачный MCP server, через который AI-агент может читать и изменять бухгалтерские данные, а также локальный сервер в репозитории XeroAPI. Для проверки счетов и контактов начните с доступа только на чтение и текстового проекта результата; внесение записей и платежи оставьте человеку. Облачный вариант описан в документации Xero Developer Remote MCP, по состоянию на 30 октября 2026 года.

Что можно делать

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

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

Сравнение контактов тоже лучше завершать списком возможных дублей. Похожие названия ещё не доказывают, что записи нужно объединить или исправить. Пусть агент покажет идентификаторы, на которых основано предположение, а решение примет ответственный сотрудник.

Разницу между интерфейсом для агента и самим сервисом объясняет сравнение MCP и API. Другие примеры собраны в категории MCP servers для приложений.

Какое подключение Xero вы выбираете?

Облачный developer server и локальный пакет подключаются по-разному. В официальном локальном репозитории описаны Custom Connections с XERO_CLIENT_ID и XERO_CLIENT_SECRET либо передача токена через XERO_CLIENT_BEARER_TOKEN. Нельзя без изменений переносить такую конфигурацию на облачный сервис.

Для облачного сервера Xero рекомендует OAuth 2.0 с PKCE. Токены web-приложений технически тоже поддерживаются, но Xero не рекомендует этот вариант. Приложения типа Custom Connection не допускаются к облачному серверу. По состоянию на 30 октября 2026 года документация предусматривает Core и выше для реальных организаций, а Starter — для демонстрационной организации. Перед выбором схемы проверьте условия в Remote MCP FAQ.

Для локальной схемы Custom Connection привязывается к одной организации; у него отдельные условия подписки и доступности по регионам. Обратитесь к Custom Integration FAQ. Наличие подписки Xero не означает, что в неё входят все варианты подключения для разработчиков.

Что только читает, а что изменяет данные?

Ниже — несколько пар инструментов и разрешений облачного сервера из таблицы Xero, по состоянию на 30 октября 2026 года:

Задача	Чтение: инструмент и scope	Изменение: инструмент и scope
Счета	`list_invoices` — `accounting.invoices.read`	`create_invoice` — `accounting.invoices`
Контакты	`list_contacts` — `accounting.contacts.read`	`update_contact` — `accounting.contacts`
Записи о платежах	`list_payments` — `accounting.payments.read`	`create_payment` — `accounting.payments`

Это примеры, а не полный перечень разрешений. Запрашивайте только чтение, необходимое для задачи. В локальном варианте репозиторий предусматривает переопределение через XERO_SCOPES; изучите настройки по умолчанию, прежде чем копировать пример с широким доступом.

Проект счёта в текстовом файле и счёт со статусом DRAFT в Xero — разные результаты. Сохранение DRAFT уже создаёт запись в бухгалтерской системе, пусть она и ожидает согласования; это следует из Invoices API. В предлагаемом процессе запись создаёт и проводит человек.

Payments API позволяет применять записи о платежах к бухгалтерским документам. Успешный ответ бухгалтерской системы нельзя считать доказательством банковского перевода. Сам платёж и подтверждение его исполнения должны оставаться у человека.

Как подключить безопасно

Определите допустимый результат. Запишите организацию, период и форму ответа: таблица для проверки или текстовый проект. Создание и утверждение счетов, редактирование контактов и платежные действия исключите из задачи агента. В практике работы с разрешениями объясняется, почему одной просьбы в промпте недостаточно.
Подготовьте приложение нужного типа. В этой инструкции выбираем приложение разработчика Xero с OAuth 2.0 и PKCE и клиент, который поддерживает этот процесс авторизации. Redirect URL настройте по актуальной документации клиента. Начните с демонстрационной организации. Не передавайте токены и секреты в чат и не сохраняйте их в файлах проекта, попадающих в репозиторий.
Добавьте облачный адрес в редакторе. В VS Code откройте палитру команд, выполните MCP: Add Server, выберите HTTP и введите https://api.xero.com/mcp/v1. Выберите место хранения конфигурации с учётом используемой сессии агента и внимательно прочитайте запросы авторизации. Следуйте документации VS Code по MCP: форматы конфигурации клиентов различаются. Дополнительные пояснения есть в руководстве по MCP в VS Code.
Проверьте согласие и доступные инструменты. Разрешите только нужное чтение. Посмотрите, какие инструменты доступны в сессии, и отключите запись, если клиент это поддерживает. Выбор инструментов дополняет ограничения OAuth. Если настройка требует ненужных прав изменения, исправьте её до работы с реальными данными.
Убедитесь, что простое чтение работает. Для облачного сервера вызовите get_connected_tenants, определите организацию и запросите небольшой набор счетов или контактов. Раскройте результат вызова в клиенте. Проверьте принадлежность данных нужной организации и соответствие ответа полученным записям.
Проверьте результат отдельно. Сопоставьте проект текста или таблицы с Xero до использования. Сохраните ссылки на использованные записи и список неопределённостей. Внесение записей, отправку сообщений и платежи выполняет человек в согласованном процессе. После пилота отключите доступ: порядок через Connected Apps описан в Remote MCP FAQ.

Когда это не работает

Подключение есть, но подробностей не хватает. Invoices API различает краткую выдачу списка и подробные ответы. До проверки отдельных строк посмотрите, что именно вернул инструмент. Недостающие сведения нельзя заменять предположениями о налогах или суммах.

Старый пример показывает другие инструменты. В README локального сервера имена команд содержат дефисы, у облачных инструментов — подчёркивания. Сопоставляйте имена и авторизацию с выбранным сервером. Если пример расходится с обнаруженными инструментами, проверьте актуальную документацию.

Процесс рассчитывает на встроенное подтверждение записи. В Remote MCP FAQ сказано, что инструменты сами не запрашивают подтверждение перед изменениями. Ограничивайте права доступа и используйте средства контроля клиента. В пилоте для чтения и подготовки текста не выдавайте права записи в рабочую организацию.

Данные неполны или запрос завершился ошибкой. Частичный ответ нельзя выдавать за всю бухгалтерскую картину. Сузьте вопрос, изучите ошибку и сравните результат с Xero. Перед расширением доступа пройдите чек-лист безопасности MCP.

Где здесь Tvijo

По состоянию на 30 октября 2026 года расширение DSHREM для VS Code позволяет задавать вопросы из редактора с явно приложенным контекстом. Для бухгалтерской задачи можно передать разрешённую, сокращённую до необходимого выписку и получить проект пояснения или проверку согласованности. До отправки клиентской информации изучите разрешения и передачу данных.

TvijoCode — тестовая сборка со встроенным расширением. Tvijo MCP предоставляет совместимому клиенту консультационные функции Tvijo; подготовленная проверка diff в датированном описании релиза ещё ожидает публикации, а делегирование в редактор остаётся планом. Эти возможности не означают наличия готового коннектора Xero или автоматического доступа к инструментам другого сервера. Прямое подключение Xero требует отдельного определения прав, реализации и проверки. Внесение записей и платежи остаются у человека.

В предложениях Tvijo по состоянию на 31 октября 2026 года Try указан по цене $0: до 50 задач, 100 000 токенов или $0.05 спонсируемого использования — до первого достигнутого ограничения, из общего ежедневного пула $1, который финансирует TVIJO. Service credit показан как $10 для запроса предоплаченного кредита; использование оплачивается по факту с сервисной наценкой 8%. Приём платежей не активирован; создание заказа не означает списание денег.

Частые вопросы

Xero MCP server работает только на чтение?

В нём есть инструменты записи. Для режима чтения нужны соответствующие scopes и ограничения клиента; примеры разрешений выше разделяют чтение и изменения.

Может ли агент подготовить счёт без создания записи в Xero?

Да: запросите текстовый проект на основе разрешённых данных. Перед созданием записи его проверяет человек; сохранение счёта DRAFT уже является записью в систему.

Установка Tvijo подключает мой аккаунт Xero?

Описанные возможности Tvijo не подтверждают готовой интеграции Xero. Для проекта текста или проверки используйте отдельно авторизованное подключение либо тщательно отобранную выписку.

Xero — товарный знак правообладателя. Tvijo не связан с ним и не одобрен им.

Источники

Ниже указаны источники и даты наблюдений. Статус проверки отмечен для каждого материала.

Xero Developer Remote MCP · Проверено 2026-10-31 · Hosted endpoint, tool names and read/write scope mappings; hosted setup and tenant discovery.
Xero Remote MCP FAQs · Проверено 2026-10-31 · PKCE recommendation, technically supported but discouraged web-app authentication, client OAuth support, plan eligibility, Custom Connection exclusion, lack of tool-level confirmation and disconnection.
XeroAPI/xero-mcp-server · Проверено 2026-10-31 · Official local implementation, authentication variables, XERO_SCOPES override and hyphenated local command names.
Xero Accounting API: Invoices · Проверено 2026-10-31 · Creating a DRAFT is a data write; invoice listing and detail responses differ.
Xero Accounting API: Payments · Проверено 2026-10-31 · Reading and applying accounting payment records to invoices and other documents.
Xero Custom Integration FAQs · Проверено 2026-10-31 · Single-organisation Custom Connections, regional/subscription conditions and scopes.
Add MCP servers in VS Code · Проверено 2026-10-31 · MCP: Add Server, HTTP connection path, configuration destinations and verification of tool results.