Square MCP: заказы, каталог и записи, возвраты вручную

У Square есть официальный MCP-сервер для подключения AI-агента к API платформы; по состоянию на 30 октября 2026 года сервис находится в Beta. Доступны размещённый сервер с OAuth и локальный вариант для тестирования в Sandbox: небольшой компании разумно начать с анализа продаж и записей, оставив списания и возвраты сотруднику. Основа подключения описана в официальной документации Square MCP.

Что он позволяет делать

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

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

Каталог. Catalog API охватывает товары, услуги, варианты, скидки и налоги; остатки относятся к Inventory API. Например, агент может сравнить выбранные варианты товаров и составить список описаний, которым нужна редактура. Предложения по тексту сначала сохраняйте в документе для проверки владельцем.

Записи клиентов. Bookings API позволяет получать записи и искать свободное время. Для салона можно подготовить сводку по приёмам или варианты времени для клиента. Требуйте указывать филиал, услугу, сотрудника и часовой пояс; прежде чем обещать клиенту время, администратор должен подтвердить его доступность.

Это примеры организации работы, а не гарантия правильного выполнения конкретным клиентом. Другие подключения собраны в категории MCP-серверы для приложений. Если роли компонентов пока неясны, начните с сравнения MCP и API.

Где чтение, а где изменение данных

В официальном репозитории описаны get_service_info для поиска методов, get_type_info для требований к запросу и make_api_request для вызова API. У универсального инструмента нужно проверять сервис, метод и аргументы: само название не показывает, изменит ли вызов запись.

Начальная карта прав ниже основана на справочнике OAuth Square и документации Catalog по состоянию на 30 октября 2026 года.

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

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

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

1. Задайте границы поручения. Укажите филиал, период, разрешённые данные и формат отчёта. Начните с заказов или каталога, без доступа ко всей клиентской базе. Заранее решите, по каким записям владелец будет проверять выводы.

2. Проведите репетицию в Sandbox. Размещённый MCP-сервер Square обращается только к рабочим данным. Для Sandbox используйте локальный сервер и явно задайте SANDBOX=true и DISALLOW_WRITES=true согласно реализации локального сервера. Передавайте токен доступа через принятый в компании механизм хранения секретов; не вставляйте его в запрос агенту или коммит.

3. Настройте клиент редактора. Для VS Code или другого редактора с MCP проверьте актуальную документацию по настройке серверов и подтверждению вызовов. Со стороны клиента поможет руководство по MCP в VS Code. Адрес размещённого сервера Square — https://mcp.squareup.com/mcp, вход выполняется через OAuth. Используйте его только после решения подключиться к рабочим данным и проверьте аккаунт продавца при авторизации.

4. Проверяйте разрешения и запросы. Сопоставьте запрашиваемые права с поручением. На время пилота отключите автоматическое выполнение и просматривайте аргументы инструмента вызова API. Флаг чтения в локальной конфигурации — дополнительное ограничение; он не настраивает размещённый сервис. Зафиксировать границы поможет практика работы с разрешениями.

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

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

В календаре видна лишь часть записей. Доступ уровня покупателя ограничен записями, созданными вызывающим приложением. Для изменений на уровне продавца нужен подходящий платный план Appointments; до проектирования такой функции проверяйте support_seller_level_writes в профиле бронирования компании. Это ограничения Bookings API, которые нельзя снять удачной формулировкой запроса.

Клиент не проходит подключение. Square описывает список разрешённых MCP-клиентов. Перед подключением незнакомого редактора проверьте актуальные инструкции Square. Не подменяйте отклонённый OAuth-вход токеном с широкими полномочиями только ради завершения настройки.

Неполный отчёт выглядит окончательным. По документации Catalog API, выдача каталога может разбиваться на страницы. В процессе должна быть предусмотрена проверка оставшихся страниц. Указывайте время подготовки сводки: её нельзя считать бессрочным подтверждением остатков или свободного времени.

Текст из данных пытается управлять агентом. Комментарии клиентов и описания товаров — материал для анализа. Встроенные в них указания не должны расширять задачу или разрешать возврат. Для более широкой проверки используйте чек-лист безопасности MCP.

Где здесь Tvijo

По состоянию на 30 октября 2026 года расширение DSHREM для VS Code служит входом из редактора в ограниченные задачи с выбранным контекстом. Здесь оно может быть полезно для разбора обезличенной сводки продаж или кода коннектора. TvijoCode включает расширение в тестовую сборку редактора; наличие этой сборки не подтверждает готовое подключение к Square.

Tvijo MCP предоставляет консультации. Проверка переданного diff подготовлена, но в датированном статусе выпуска публикация ещё ожидается; интеграция с редактором и делегирование остаются планами. Подключение Square и Tvijo к одному клиенту само по себе не даёт Tvijo возможности управлять Square. Для коннектора конкретной компании отдельно определяют задачи, права и критерии приёмки. Списания и возвраты выполняет ответственный сотрудник.

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

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

Есть ли у Square официальный MCP-сервер?

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

Может ли агент менять записи или делать возвраты?

API Square поддерживают изменения с учётом разрешений и условий Bookings. В описанном пилоте финансовые действия выполняются вручную, а изменения записей требуют отдельного согласования.

Можно ли начать без доступа к реальным продажам?

Да. Пройдите репетицию в Sandbox из инструкции подключения, используя тестовые данные и ограничения чтения. До первого запроса проверьте аккаунт и выбранную среду.

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