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.
Configurazione guidata
Collega Square a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Square con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
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 + Microsoft Copilot
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.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
SQUARE_ACCESS_TOKEN, SQUARE_API_URL
Step 1 — Ottieni le credenziali
- 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.
Step 2 — Installa l'adapter
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
Step 3 — Aggiungi il connettore in Microsoft Copilot
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Square. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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."
FAQ
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?