Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Square con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Fai lavorare la tua AI con la tua attività su Square: consulta pagamenti, rimborsi e ordini, gestisci i clienti, cerca e modifica il catalogo articoli, controlla le giacenze, crea e invia fatture e vedi sedi e membri del team. Sandbox o produzione, con il tuo access token.
Prova a chiedere
Prompt di esempio per Square
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Square, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Square
Fai lavorare la tua AI con la tua attività su Square: consulta pagamenti, rimborsi e ordini, gestisci i clienti, cerca e modifica il catalogo articoli, controlla le giacenze, crea e invia fatture e vedi sedi e membri del team. Sandbox o produzione, con il tuo access token.
Setup
- Accedi a developer.squareup.com/apps con il tuo account Square e clicca su Create an application (il nome non conta).
- Apri l'applicazione e vai su Credentials. Il selettore in alto passa da Sandbox a Production e viceversa.
- Accanto all'Access token dell'ambiente che ti serve, clicca su Show, copia il token e inseriscilo in
SQUARE_ACCESS_TOKEN, senza la parola Bearer e senza spazi. - Imposta
SQUARE_API_URLsuhttps://connect.squareupsandbox.comper un token sandbox o suhttps://connect.squareup.comper un token di produzione, senza barra finale. Un token funziona solo nel proprio ambiente. - Installa il connettore ed esegui
square_get_merchant: mostra nome, paese e valuta dell'attività raggiunta dal token.
Access token: il token della pagina Credentials è un access token personale con accesso completo al tuo account Square, ed è proprio quello che serve al connettore. Non scade, ma chiunque lo possieda può agire per conto della tua attività: tienilo segreto e, se finisce in mani sbagliate, sostituiscilo nella stessa pagina e inserisci quello nuovo in SQUARE_ACCESS_TOKEN.
Sandbox e produzione: il token sandbox appartiene a un venditore di prova predefinito, quindi non ci sono né soldi né clienti reali. Per vedere i risultati come venditore, apri nella developer console Sandbox test accounts → l'account → Square Dashboard. La sandbox non invia mai fatture per email; apri invece il link pubblico della fattura.
Permessi e solo lettura: il token della pagina Credentials ha sempre accesso completo, quindi la sola lettura si imposta nel connettore: disattiva square_refund_payment, square_create_order, square_create_customer, square_update_customer, square_upsert_catalog_object, square_create_invoice, square_publish_invoice e square_cancel_invoice.
Disattivati all'installazione: square_delete_customer, square_delete_catalog_object e square_delete_invoice. Attivali solo se l'AI deve eliminare profili cliente, oggetti del catalogo (un articolo insieme alle sue varianti) o bozze di fattura (anche il relativo ordine viene annullato).
Soldi ed email ai clienti: square_refund_payment restituisce denaro al cliente e non si può annullare, square_publish_invoice invia la fattura al cliente per email e la rende pagabile, e square_cancel_invoice blocca il pagamento di una fattura pubblicata e avvisa il cliente. Prima di usarli, l'AI indica importo, cliente e id e aspetta il tuo sì. Fa lo stesso prima di modificare un articolo esistente del catalogo con square_upsert_catalog_object.
Fatture: una fattura si basa su un ordine aperto. L'AI crea l'ordine con square_create_order (non viene addebitato nulla), poi una bozza con square_create_invoice; al cliente non arriva niente finché non esegue square_publish_invoice. Per l'invio via email il profilo cliente deve avere un indirizzo email.
Le modifiche al catalogo sostituiscono l'intero articolo: square_upsert_catalog_object sostituisce un oggetto esistente per intero, quindi l'AI legge prima l'articolo con square_get_catalog_object e rimanda la copia completa; i campi omessi, varianti comprese, verrebbero eliminati. Le giacenze sono tenute per variante e sede, non per articolo.
Sedi: la maggior parte dei dati appartiene a una sede, e square_list_locations le mostra tutte. Senza sede, square_list_payments copre solo la sede principale, e le fatture sono sempre elencate per sede. Gli ordini registrati offline possono comparire fino a 72 ore dopo.
Errori comuni: 401 UNAUTHORIZED significa che il token è sbagliato o non corrisponde a SQUARE_API_URL (un token sandbox con l'URL di produzione o viceversa): controlla entrambi. 403 significa che al token manca un permesso per la chiamata; un token della pagina Credentials ha accesso completo, quindi verifica di aver inserito proprio quello. 400 VERSION_MISMATCH significa che l'oggetto è cambiato nel frattempo e va riletto; le altre risposte 400 INVALID_REQUEST_ERROR indicano il campo non valido. 404 NOT_FOUND significa id sbagliato, oppure un oggetto di un'altra sede o di un altro ambiente. 429 RATE_LIMITED significa che Square sta limitando le richieste dell'account: attendi un momento e riprova.
Il connettore non accetta pagamenti con carta e non gestisce carte regalo, programmi fedeltà, prenotazioni, abbonamenti, accrediti o webhook.
Prerequisiti: SQUARE_ACCESS_TOKEN, SQUARE_API_URL
Installazione locale del connettore
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
Apri http://localhost:3000/connectors/store, scegli Square e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| 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 |
Esempi di prompt
- "Quali pagamenti abbiamo incassato ieri nella sede principale, e qualcuno è stato rimborsato?"
- "Trova la cliente [email protected] e mostrami i suoi ordini degli ultimi tre mesi."
- "Quante confezioni di Espresso Blend 1 kg abbiamo in magazzino in ogni sede?"
- "Crea una fattura per Acme Srl per 3 ore di consulenza a 90 EUR l'una, con scadenza il 1° novembre, e mostramela prima di inviarla."
Prossimi passi
Questa guida ti è stata utile?
