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 + ChatGPT
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 ChatGPT
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.
ChatGPT se conecta a servidores MCP como apps personalizadas en modo desarrollador (Developer mode), disponible en los planes de pago, no en el gratuito. En los espacios Business y Enterprise puede que un administrador tenga que habilitarlo antes.
- En ChatGPT, abre Settings → Security and login y activa Developer mode.
- Ve a chatgpt.com/plugins y pulsa +.
- Escribe un nombre y una descripción breve, por ejemplo Name:
Square. - En Connection, introduce la URL del servidor MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDy crea la conexión. - Cuando ChatGPT lo pida, inicia sesión en AnythingMCP (OAuth) y permite el acceso.
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
¿Funciona el plan gratuito de ChatGPT con conectores MCP personalizados? No. Las conexiones MCP personalizadas necesitan el modo desarrollador, que solo está en los planes de pago.
Siguientes pasos
¿Te ha sido útil esta guía?
