Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте Square одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
Дайте ИИ работать с вашим бизнесом в Square: находить платежи, возвраты и заказы, вести клиентов, искать и редактировать каталог товаров, проверять остатки, создавать и отправлять счета, видеть точки продаж и сотрудников. Песочница или рабочая среда, с вашим собственным токеном доступа.
Попробуй спросить
Примеры промптов для Square
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Square, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Square
Дайте ИИ работать с вашим бизнесом в Square: находить платежи, возвраты и заказы, вести клиентов, искать и редактировать каталог товаров, проверять остатки, создавать и отправлять счета, видеть точки продаж и сотрудников. Песочница или рабочая среда, с вашим собственным токеном доступа.
Настройка
- Войдите на developer.squareup.com/apps со своим аккаунтом Square и нажмите Create an application (название любое).
- Откройте приложение и перейдите в Credentials. Переключатель вверху меняет среду между Sandbox и Production.
- Рядом с Access token нужной среды нажмите Show, скопируйте токен и вставьте его в
SQUARE_ACCESS_TOKENбез слова Bearer и без пробелов. - Укажите в
SQUARE_API_URLадресhttps://connect.squareupsandbox.comдля токена песочницы илиhttps://connect.squareup.comдля рабочего токена, без косой черты в конце. Токен работает только в своей среде. - Установите коннектор и запустите
square_get_merchant: инструмент показывает название, страну и валюту бизнеса, к которому даёт доступ токен.
Токен доступа: токен со страницы Credentials это персональный токен доступа с полным доступом к вашему аккаунту Square, и именно он нужен коннектору. Срок его действия не истекает, но любой, у кого он есть, может действовать от имени вашего бизнеса: храните его в секрете, а если он утёк, замените его на той же странице и вставьте новый в SQUARE_ACCESS_TOKEN.
Песочница и рабочая среда: токен песочницы принадлежит тестовому продавцу по умолчанию, поэтому реальные деньги и клиенты не затрагиваются. Чтобы посмотреть результаты глазами продавца, откройте в консоли разработчика Sandbox test accounts → нужный аккаунт → Square Dashboard. Песочница никогда не отправляет счета по почте; вместо этого откройте публичную ссылку счёта.
Разрешения и режим только для чтения: токен со страницы Credentials всегда даёт полный доступ, поэтому режим только для чтения настраивается в коннекторе: отключите square_refund_payment, square_create_order, square_create_customer, square_update_customer, square_upsert_catalog_object, square_create_invoice, square_publish_invoice и square_cancel_invoice.
Выключены при установке: square_delete_customer, square_delete_catalog_object и square_delete_invoice. Включайте их, только если ИИ должен удалять профили клиентов, объекты каталога (товар удаляется вместе с вариантами) или черновики счетов (связанный заказ при этом тоже отменяется).
Деньги и письма клиентам: square_refund_payment возвращает деньги клиенту, и это нельзя отменить; square_publish_invoice отправляет счёт клиенту по почте и делает его доступным для оплаты; square_cancel_invoice закрывает опубликованный счёт для оплаты и уведомляет клиента. Перед их вызовом ИИ называет сумму, клиента и идентификаторы и ждёт вашего согласия. Так же он поступает перед изменением существующего товара в каталоге через square_upsert_catalog_object.
Счета: счёт строится на открытом заказе. ИИ создаёт заказ через square_create_order (ничего не списывается), затем черновик через square_create_invoice; до вызова square_publish_invoice клиент ничего не получает. Для отправки по почте в профиле клиента должен быть адрес электронной почты.
Изменения каталога заменяют товар целиком: square_upsert_catalog_object заменяет существующий объект полностью, поэтому ИИ сначала читает товар через square_get_catalog_object и отправляет обратно полную копию; пропущенные поля, включая варианты, были бы удалены. Остатки ведутся по вариантам товара и точкам продаж, а не по товару в целом.
Точки продаж: большинство данных относится к конкретной точке продаж (location), и square_list_locations показывает их все. Без указания точки square_list_payments охватывает только основную, а счета всегда выводятся по одной точке. Заказы, принятые офлайн, могут появиться только через 72 часа.
Частые ошибки: 401 UNAUTHORIZED означает, что токен неверный или не соответствует SQUARE_API_URL (токен песочницы с рабочим URL или наоборот): проверьте и то, и другое. 403 означает, что у токена нет разрешения на этот вызов; токен со страницы Credentials даёт полный доступ, поэтому проверьте, что вставили именно его. 400 VERSION_MISMATCH означает, что объект за это время изменился и его нужно прочитать заново; другие ответы 400 INVALID_REQUEST_ERROR указывают на неверное поле. 404 NOT_FOUND означает неверный идентификатор или объект из другой точки продаж или другой среды. 429 RATE_LIMITED означает, что Square ограничивает запросы аккаунта: подождите немного и повторите попытку.
Коннектор не принимает оплату картой и не работает с подарочными картами, программами лояльности, онлайн-записью, подписками, выплатами и вебхуками.
Предварительные требования: SQUARE_ACCESS_TOKEN, SQUARE_API_URL
Локальная установка коннектора
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, выберите Square и введите переменные, перечисленные в Предварительных требованиях.
Доступные инструменты
| Tool | What it does |
|---|---|
square_get_merchant | Read the seller account behind the token: business name, country, currency, language, status and main_location_id |
square_list_locations | List the business locations: id, name, address, timezone, currency, status and capabilities |
square_get_location | Read one location by id, or the main location with "main": address, hours, currency, capabilities |
square_list_payments | List payments (newest first by default) with amount, status, card details, order and customer ids, refunds and receipt URL |
square_get_payment | Read one payment: amounts (total, tip, app fee, refunded), status (APPROVED, PENDING, COMPLETED, CANCELED, FAILED), source and card… |
square_list_refunds | List refunds (newest first by default) across all locations unless one is given: amount, status, reason, payment id |
square_get_refund | Read one refund: amount, status, reason, payment and order ids |
square_refund_payment | Refund a payment in full or in part |
square_search_orders | Search orders of 1 to 10 locations by state, dates, customers or source, with line items, totals, tenders and fulfillments |
square_get_order | Read one order: state, line items with modifiers, taxes and discounts, totals, tenders (payments), refunds and fulfillments |
square_create_order | Create an OPEN order, for example as the basis of an invoice |
square_list_customers | List customer profiles: id, names, company, email, phone, address, reference id, version |
square_search_customers | Search customer profiles by email, phone, reference id, creation or update time, or group |
square_get_customer | Read one customer profile with its current version, groups and preferences |
square_create_customer | Create a customer profile |
square_update_customer | Update a customer profile |
square_delete_customer | Delete a customer profile for good |
square_list_catalog | List catalog objects of the given types (100 per page): items with variations and prices, categories, taxes, discounts, modifier lists |
square_search_catalog_items | Search items by text (name, description, SKU, UPC), category, location, stock level or product type |
square_search_catalog_objects | Search any catalog objects (items, variations, categories, taxes, discounts...) by keywords, exact or prefix attribute values, or change… |
square_get_catalog_object | Read one catalog object by id with its version (needed to update it), optionally with the objects it references |
square_upsert_catalog_object | Create a catalog object, or REPLACE an existing one as a whole: fields left out (variations included) are removed, so for an update send… |
square_delete_catalog_object | Delete a catalog object for good; deleting an item also deletes its variations |
square_get_inventory_counts | Read inventory counts for many item variations and locations at once: quantity (a string) per state such as IN_STOCK, newest first |
square_get_inventory_count | Read the inventory count of one item variation, per location and state |
square_list_invoices | List the invoices of one location: id, number, status (DRAFT, UNPAID, SCHEDULED, PARTIALLY_PAID, PAID, CANCELED, ...), recipient, payment… |
square_search_invoices | Search the invoices of one location, optionally of one customer, sorted by invoice date |
square_get_invoice | Read one invoice: status, version (needed to publish or cancel), order, recipient, payment requests with computed amounts, public_url and… |
square_create_invoice | Create a DRAFT invoice for an OPEN order (make one with square_create_order) |
square_publish_invoice | Publish a draft invoice: Square sends it to the customer (EMAIL delivery) or makes it payable at public_url, and it can no longer be edited… |
square_cancel_invoice | Cancel a published invoice so it can no longer be paid; the customer is notified |
square_delete_invoice | Delete a DRAFT invoice; its order is canceled too |
square_search_team_members | Search team members by location, status or owner flag: id, names, email, phone, status, is_owner and assigned locations |
square_get_team_member | Read one team member: names, email, phone, status, owner flag and location assignments |
Примеры запросов
- «Какие платежи мы приняли вчера в основной точке продаж и был ли по ним возврат?»
- «Найди клиентку [email protected] и покажи её заказы за последние три месяца.»
- «Сколько единиц Espresso Blend 1 kg у нас на складе в каждой точке продаж?»
- «Создай счёт для ООО «Акме» на 3 часа консультаций по 90 EUR со сроком оплаты 1 ноября и покажи его мне перед отправкой.»
Следующие шаги
Это руководство помогло?
