Cómo conectar Square a Cursor vía MCP

💡 ¿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 + Cursor

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

1. Inicia sesión en developer.squareup.com/apps con tu cuenta de Square y haz clic en Create an application (el nombre da igual).
2. Abre la aplicación y ve a Credentials. El interruptor de arriba cambia entre Sandbox y Production.
3. 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.
4. Pon SQUARE_API_URL en https://connect.squareupsandbox.com para un token de sandbox o en https://connect.squareup.com para un token de producción, sin barra final. Un token solo funciona en su propio entorno.
5. 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 Cursor

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 muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Square.

Herramientas disponibles

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

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse