Square MCP: Документация

Обновлено: 25 июля 2026 г.

Подключение

Remote (рекомендуется): https://mcp.squareup.com/sse через npx mcp-remote https://mcp.squareup.com/sse — вход по OAuth аккаунтом Square, токен создавать не нужно.
Локально: ACCESS_TOKEN=... SANDBOX=true npx square-mcp-server start (stdio). Переменные: ACCESS_TOKEN, SANDBOX/PRODUCTION, DISALLOW_WRITES (только чтение), SQUARE_VERSION.
Сервер в статусе Beta: Square ведёт allowlist MCP-клиентов для защиты от вредоносной регистрации.

Инструменты

Всего 3 универсальных инструмента поверх полного API Square:

get_service_info(service) — какие методы доступны у сервиса.
get_type_info(service, method) — какие параметры нужны методу.
make_api_request(service, method, request) — выполнить вызов.

Сервисы (service): customers, orders, catalog, payments, refunds, disputes, invoices, bookings, subscriptions, inventory, loyalty, team, terminal, payouts, giftcards, webhooksubscriptions и другие — полный список в README.

Сценарий для агента

«Найди свободного мастера завтра в 15:00 и запиши Anna Lee», «оформи возврат 25 $ по платежу abc123», «покажи остатки по товару X на складе», «создай счёт клиенту на следующей неделе».

Важно

Ключ ACCESS_TOKEN даёт доступ к деньгам и данным продавца. Начинайте с SANDBOX=true, а для read-only сценариев используйте DISALLOW_WRITES=true — это исключает случайные списания и изменения каталога.

Тарифы

MCP-сервер бесплатный; комиссии — по обычным тарифам Square за приём платежей и использование сервисов (bookings, invoices и т.д.).