Conectar SumUp MCP con Cursor: transacciones

💡 ¿Sin instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → SumUp, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

SumUp + Cursor

Consulta cuentas de comerciante, transacciones, liquidaciones, checkouts, recibos, lectores de tarjetas, miembros del equipo y subcuentas de SumUp desde cualquier agente de IA. Solo lectura, con autenticación mediante token Bearer.

Requisitos previos

Consulta las instrucciones completas de configuración incluidas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno necesarias para este conector son:

SUMUP_API_KEY

Paso 1 — Obtén las credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de comerciante de SumUp y una clave de API de esa cuenta.

1. Inicia sesión en el panel de SumUp en https://me.sumup.com.
2. Abre Settings → For Developers (o el Developer Portal).
3. Genera una clave de API (Personal Access Token) y pégala en SUMUP_API_KEY. Se envía como token Bearer en cada llamada.
4. Instala el conector y ejecuta sumup_get_merchant_profile: devuelve el código de comerciante, el nombre de la empresa, la moneda y el país de la cuenta asociada a la clave, lo que demuestra que la clave funciona.

Qué lee: el perfil del comerciante; el historial de transacciones, por defecto de la más reciente a la más antigua, filtrado por estado (como SUCCESSFUL, CANCELLED o FAILED) o limitado a las transacciones modificadas desde una marca de tiempo ISO 8601, con hasta 100 por página; una transacción concreta por su id o por su código de transacción (como TD6Q7P2); las liquidaciones a tu cuenta bancaria entre dos fechas (YYYY-MM-DD); los checkouts en línea y los enlaces de pago, filtrados por tu propia referencia de checkout; y las subcuentas de operador de la cuenta principal.

Código de comerciante, recibos, equipo y lectores de tarjetas: las versiones actuales de la API de SumUp identifican una cuenta por su código de comerciante, que devuelve sumup_get_merchant_profile; si la clave llega a varias cuentas, sumup_list_memberships las enumera y sumup_get_merchant muestra una. Con ese código la IA también lee las transacciones y las liquidaciones en las versiones actuales de la API (las liquidaciones incluyen deducciones como reembolsos y contracargos), el recibo de una transacción, un checkout en línea concreto, los métodos de pago ofrecidos en línea, los clientes guardados y sus tarjetas tokenizadas (solo los cuatro últimos dígitos), los miembros, los roles personalizados y las personas registradas (titulares, representantes legales), y los lectores de tarjetas vinculados con su estado en directo y el checkout enviado a cada uno. Las herramientas anteriores de transacciones y liquidaciones se mantienen para las configuraciones existentes. Un 403 significa que el usuario de la clave no tiene en SumUp el permiso para esa cuenta.

Solo lectura: las 26 herramientas solo leen. No se modifica nada en tu cuenta de SumUp; los reembolsos, los checkouts nuevos, los cobros en el lector y los cambios de miembros se hacen en el panel de SumUp.

¿Ya lo tienes instalado? Las nuevas herramientas llegan a un conector instalado antes a través de su actualización de catálogo: abre el conector en AnythingMCP y, en Catalog update available, revisa la lista de herramientas nuevas y haz clic en Apply update. Tus credenciales y las herramientas que añadiste tú se quedan como están.

Paso 2 — Instala el adaptador

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ñade 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 SumUp.

Herramientas disponibles

Preguntas frecuentes

¿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