Square MCP Server

Что умеет сервер

Сервер Square даёт доступ ко всему семейству API Square через три инструмента: get_service_info (какие методы есть у сервиса), get_type_info (какие параметры нужны) и make_api_request (выполнение вызова). Каталог сервисов широкий: платежи, заказы, каталог, клиенты, счета, подписки, возвраты, выплаты, программа лояльности, подарочные карты, бронирования, команда, терминалы, склад и другие.

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

Когда использовать

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

Локальный вариант (репозиторий) нужен тем, кто хочет запустить собственную копию сервера со своим токеном доступа.

Ограничения и безопасность

Проект помечен как бета. Через общий инструмент make_api_request агент может менять реальные данные и деньги, поэтому проверяйте запросы. Для локального запуска есть переменная DISALLOW_WRITES=true, которая оставляет только операции чтения, а SANDBOX=true направляет вызовы в песочницу Square. Токен доступа храните в переменной окружения и не публикуйте.

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

Размещённый сервер (рекомендуется)

https://mcp.squareup.com/mcp

Claude Desktop (через OAuth, токен не нужен). Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "mcp_square_api": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.squareup.com/mcp"]
    }
  }
}

Для Goose откройте на компьютере с Goose ссылку установки из README (расширение Square MCP Remote). Подробные руководства для Claude, ChatGPT, Goose и других помощников есть в документации Square.

Локальный сервер

# Basic startup
npx square-mcp-server start

# With environment configuration
ACCESS_TOKEN=YOUR_SQUARE_ACCESS_TOKEN SANDBOX=true npx square-mcp-server start

Конфигурация для Claude Desktop:

{
  "mcpServers": {
    "mcp_square_api": {
      "command": "npx",
      "args": ["square-mcp-server", "start"],
      "env": {
        "ACCESS_TOKEN": "YOUR_SQUARE_ACCESS_TOKEN",
        "SANDBOX": "true"
      }
    }
  }
}

Переменные окружения: ACCESS_TOKEN, SANDBOX, PRODUCTION, DISALLOW_WRITES, SQUARE_VERSION. Установка для Goose локально выполняется командой:

npx square-mcp-server install