Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Square con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Deja que tu IA trabaje con tu negocio en Square: consulta pagos, reembolsos y pedidos, gestiona clientes, busca y edita el catálogo de artículos, revisa el inventario, crea y envía facturas, y consulta ubicaciones y miembros del equipo. Sandbox o producción, con tu propio token de acceso.
Prueba a pedir
Prompts de ejemplo para Square
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Square, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Square + Meta Muse
Deja que tu IA trabaje con tu negocio en Square: consulta pagos, reembolsos y pedidos, gestiona clientes, busca y edita el catálogo de artículos, revisa el inventario, crea y envía facturas, y consulta ubicaciones y miembros del equipo. Sandbox o producción, con tu propio token de acceso.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
SQUARE_ACCESS_TOKEN, SQUARE_API_URL
Paso 1 — Obtener credenciales
- Inicia sesión en developer.squareup.com/apps con tu cuenta de Square y haz clic en Create an application (el nombre da igual).
- Abre la aplicación y ve a Credentials. El interruptor de arriba cambia entre Sandbox y Production.
- Junto al Access token del entorno que quieras, haz clic en Show, copia el token y pégalo en
SQUARE_ACCESS_TOKEN, sin la palabra Bearer y sin espacios. - Pon
SQUARE_API_URLenhttps://connect.squareupsandbox.compara un token de sandbox o enhttps://connect.squareup.compara un token de producción, sin barra final. Un token solo funciona en su propio entorno. - Instala el conector y ejecuta
square_get_merchant: muestra el nombre, el país y la moneda del negocio al que llega el token.
Token de acceso: el token de la página Credentials es un token de acceso personal con acceso completo a tu propia cuenta de Square, que es justo lo que necesita el conector. No caduca, pero quien lo tenga puede actuar en nombre de tu negocio: guárdalo en secreto y, si se filtra, sustitúyelo en la misma página y pega el nuevo en SQUARE_ACCESS_TOKEN.
Sandbox y producción: el token de sandbox pertenece a un vendedor de prueba predeterminado, así que no hay dinero ni clientes reales de por medio. Para ver los resultados como vendedor, abre en la consola de desarrollador Sandbox test accounts → la cuenta → Square Dashboard. El sandbox nunca envía facturas por correo; abre en su lugar el enlace público de la factura.
Permisos y solo lectura: el token de la página Credentials siempre tiene acceso completo, así que el modo de solo lectura se configura en el conector: desactiva square_refund_payment, square_create_order, square_create_customer, square_update_customer, square_upsert_catalog_object, square_create_invoice, square_publish_invoice y square_cancel_invoice.
Desactivadas al instalar: square_delete_customer, square_delete_catalog_object y square_delete_invoice. Actívalas solo si la IA debe eliminar perfiles de clientes, objetos del catálogo (un artículo junto con sus variantes) o borradores de factura (su pedido también se cancela).
Dinero y correos a clientes: square_refund_payment devuelve dinero al cliente y no se puede deshacer, square_publish_invoice envía la factura al cliente por correo y la deja lista para pagar, y square_cancel_invoice impide pagar una factura publicada y avisa al cliente. Antes de usarlas, la IA indica el importe, el cliente y los ids y espera tu confirmación. Hace lo mismo antes de cambiar un artículo existente del catálogo con square_upsert_catalog_object.
Facturas: una factura se crea sobre un pedido abierto. La IA crea el pedido con square_create_order (no se cobra nada) y luego un borrador con square_create_invoice; al cliente no le llega nada hasta square_publish_invoice. Para el envío por correo, el perfil del cliente necesita una dirección de correo.
Los cambios en el catálogo reemplazan el artículo entero: square_upsert_catalog_object reemplaza un objeto existente por completo, así que la IA primero lee el artículo con square_get_catalog_object y devuelve la copia completa; los campos que falten, variantes incluidas, se eliminarían. El inventario se lleva por variante de artículo y ubicación, no por artículo.
Ubicaciones: la mayoría de los datos pertenecen a una ubicación, y square_list_locations las muestra todas. Sin ubicación, square_list_payments solo cubre la ubicación principal, y las facturas siempre se listan por ubicación. Los pedidos registrados sin conexión pueden tardar hasta 72 horas en aparecer.
Errores frecuentes: 401 UNAUTHORIZED significa que el token es incorrecto o no coincide con SQUARE_API_URL (un token de sandbox con la URL de producción, o al revés): revisa ambos. 403 significa que al token le falta un permiso para la llamada; un token de la página Credentials tiene acceso completo, así que comprueba que pegaste ese. 400 VERSION_MISMATCH significa que el objeto cambió mientras tanto y hay que volver a leerlo; las demás respuestas 400 INVALID_REQUEST_ERROR indican el campo erróneo. 404 NOT_FOUND significa un id incorrecto, o un objeto de otra ubicación u otro entorno. 429 RATE_LIMITED significa que Square está limitando la cuenta: espera un momento y vuelve a intentarlo.
El conector no cobra pagos con tarjeta ni gestiona tarjetas regalo, programas de fidelidad, reservas, suscripciones, liquidaciones ni webhooks.
Paso 2 — Instalar el 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
Paso 3 — Añadir el conector en Muse
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Muse añade los servidores MCP remotos como conectores personalizados e inicia sesión en ellos con OAuth.
- En Muse, abre Settings → Connectors y elige Add custom connector.
- Pega la URL del servidor MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse abre la página de inicio de sesión de AnythingMCP: inicia sesión y aprueba el acceso.
- En un chat, pídele a Muse algo que necesite las herramientas de
Square.
También puedes configurarlo desde un chat, en la web, en las apps de iOS y Android o en WhatsApp. Envía a Muse este mensaje:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Muse se conecta desde la nube de Meta, así que localhost no funciona.
Herramientas disponibles
| 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 |
Ejemplos de prompts
- "¿Qué pagos cobramos ayer en la ubicación principal y se reembolsó alguno?"
- "Busca a la clienta [email protected] y muéstrame sus pedidos de los últimos tres meses."
- "¿Cuántas unidades de Espresso Blend 1 kg tenemos en stock en cada ubicación?"
- "Crea una factura para Acme S.L. por 3 horas de consultoría a 90 EUR cada una, con vencimiento el 1 de noviembre, y enséñamela antes de enviarla."
FAQ
¿Dónde está disponible Muse? Por ahora Meta ofrece Muse en Estados Unidos y Canadá, en la web, en las apps de iOS y Android y en WhatsApp.
¿Meta revisa este conector? No. Meta no revisa los conectores personalizados. Muse solo ve las herramientas que activaste para este servidor MCP en AnythingMCP, y puedes desconectarlo cuando quieras en Settings → Connectors.
Siguientes pasos
¿Te ha sido útil esta guía?
