Resumen
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.
Configuración guiada
Conecta SumUp a ChatGPT en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta SumUp con la configuración guiada y añade tu URL MCP a ChatGPT. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
El plugin de AnythingMCP en el directorio de ChatGPT responde, en AnythingMCP Cloud, a preguntas sobre las bases de datos de tu empresa (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, solo lectura): abre la ficha (se abre en una pestaña nueva) y pulsa Install plugin. Los demás conectores se añaden a ChatGPT como servidor MCP personalizado con la URL MCP de tu AnythingMCP.
Prueba a pedir
Prompts de ejemplo para SumUp
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 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 + ChatGPT
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 de configuración completas incluidas en el conector (visibles en la tienda de la aplicación al seleccionar 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.
- Inicia sesión en el panel de SumUp en https://me.sumup.com.
- Abre Settings → For Developers (o el Developer Portal).
- Genera una clave de API (Personal Access Token) y pégala en
SUMUP_API_KEY. Se envía como token Bearer en cada llamada. - 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 ChatGPT
La URL de tu servidor: en AnythingMCP, abre MCP Servers → el servidor en el que está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestreYOUR_SERVER_ID.
ChatGPT añade los servidores MCP como plugins en su página Plugins, en la web y con planes de pago. Ya no hace falta el modo desarrollador. En un espacio de trabajo Business solo pueden añadirlo los administradores y propietarios; en Enterprise y Edu, un administrador puede conceder el permiso Create plugins with MCPs.
- Ve a chatgpt.com/plugins, haz clic en Add y después en Add custom MCP server.
- Introduce un nombre, p. ej. Name:
SumUp. - En Connection, introduce la Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDy deja Authentication en OAuth. - Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT te lo pida, inicia sesión en AnythingMCP y permite el acceso.
- Instala el nuevo plugin desde tus plugins personales, luego escribe @ en un chat y selecciónalo.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
sumup_get_merchant_profile | Recupera el perfil del comerciante y la información de la cuenta asociados a la clave de API autenticada, incluidos el código de comerciante, el nombre de la empresa… |
sumup_list_transactions | Lista el historial de transacciones de la cuenta de comerciante autenticada con filtrado por rango de fechas, estado del pago y paginación |
sumup_get_transaction | Recupera la información detallada de una transacción concreta por su ID o su código de transacción |
sumup_list_payouts | Recupera el historial de liquidaciones y los informes de liquidación transferidos a la cuenta bancaria del comerciante, filtrados por rango de fechas |
sumup_list_checkouts | Lista los checkouts en línea y los enlaces de pago generados para los clientes, con filtros opcionales por estado y referencia de checkout |
sumup_list_subaccounts | Recupera las subcuentas de operador configuradas bajo la cuenta de comerciante principal |
sumup_list_memberships | Lista las cuentas de comerciante (y organizaciones) a las que pertenece el usuario de la clave de API, con el código de comerciante como resource.id, el nombre de la cuenta… |
sumup_get_merchant | Recupera una cuenta de comerciante por su código: nombre de la empresa y datos legales, tipo y perfil de negocio, país, moneda y configuración regional predeterminadas… |
sumup_list_merchant_payouts | Lista los pagos (payouts) a la cuenta bancaria del comerciante entre dos fechas (API v1.0 actual): fecha del pago, importe, comisión, moneda, estado, referencia… |
sumup_list_merchant_transactions | Lista las transacciones del comerciante (API v2.1 actual): pagos con tarjeta, en efectivo y en línea, reembolsos y contracargos con importe, moneda, estado… |
sumup_get_merchant_transaction | Recupera todos los detalles de una transacción (API v2.1 actual): importe, IVA, propina, comisión, estado, tarjeta y modo de entrada, productos, plan de pagos… |
sumup_get_receipt | Recupera el recibo estructurado de una transacción: datos del comerciante, datos de la transacción con productos e IVA, datos de la tarjeta (EMV) y del adquirente |
sumup_get_checkout | Recupera un checkout en línea por su id: importe, moneda, estado (PENDING, PAID, FAILED, EXPIRED), referencia de checkout, descripción… |
sumup_get_customer | Recupera un cliente guardado (usado para pagos en línea recurrentes o tokenizados) por el id de cliente que asignaste: datos personales como el nombre… |
sumup_list_payment_instruments | Lista los instrumentos de pago guardados de un cliente: token de la tarjeta, tipo de tarjeta y datos enmascarados, mandato, fecha de creación… |
sumup_list_payment_methods | Lista los métodos de pago disponibles para el comerciante en los checkouts en línea (tarjetas, Apple Pay, Google Pay, iDEAL, Bancontact y otros)… |
sumup_list_members | Lista los miembros (usuarios) de una cuenta de comerciante con correo electrónico, roles, estado (accepted, pending…) y permisos |
sumup_get_member | Recupera un miembro de una cuenta de comerciante: usuario, correo electrónico, roles, permisos, estado y marcas de tiempo |
sumup_list_roles | Lista los roles personalizados de una cuenta de comerciante con sus nombres y permisos, para explicar qué permite el rol de un miembro |
sumup_get_role | Recupera un rol personalizado de una cuenta de comerciante con sus permisos |
sumup_list_persons | Lista las personas registradas en una cuenta de comerciante (representantes legales, propietarios y otras personas de la empresa)… |
sumup_get_person | Recupera una persona registrada en una cuenta de comerciante |
sumup_list_readers | Lista los lectores de tarjetas (p. ej. SumUp Solo) vinculados a la cuenta de comerciante: id, nombre, estado, modelo e identificador del dispositivo |
sumup_get_reader | Recupera un lector de tarjetas vinculado: nombre, estado, modelo e identificador del dispositivo, metadatos y marcas de tiempo |
sumup_get_reader_status | Recupera el estado en tiempo real de un lector de tarjetas: en línea o fuera de línea, nivel de batería, tipo de conexión, firmware y estado del checkout en curso |
sumup_get_reader_checkout | Recupera un checkout enviado a un lector de tarjetas: importe, estado y la transacción resultante |
Preguntas frecuentes
¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no figura en su lista.
Siguientes pasos
¿Te ha sido útil esta guía?