Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Clover 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
El punto de venta Clover (Fiserv) de un comercio: datos y ajustes del negocio, artículos con stock, categorías, tipos de impuesto, descuentos y modificadores, pedidos con líneas, pagos, reembolsos y medios de pago, clientes, empleados y turnos. Crea y actualiza artículos, stock, categorías, pedidos y clientes. Norteamérica, Europa, Latinoamérica o sandbox.
Prueba a pedir
Prompts de ejemplo para Clover
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 → Clover, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Clover + Gemini
El punto de venta Clover (Fiserv) de un comercio: datos y ajustes del negocio, artículos con stock, categorías, tipos de impuesto, descuentos y modificadores, pedidos con líneas, pagos, reembolsos y medios de pago, clientes, empleados y turnos. Crea y actualiza artículos, stock, categorías, pedidos y clientes. Norteamérica, Europa, Latinoamérica o sandbox.
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:
CLOVER_API_TOKEN, CLOVER_MERCHANT_ID, CLOVER_API_URL
Paso 1 — Obtener credenciales
La configuración lleva unos 5 minutos. Necesitas una cuenta de comercio Clover (o un comercio de prueba) y un usuario admin que pueda crear tokens de API.
- Entra en el Clover Merchant Dashboard como admin y abre Settings, View all settings, API tokens (en Account and setup, Business operations). Crea un token y marca los permisos que necesitan las herramientas: Merchant read, Inventory read y write, Orders read y write, Payments read, Customers read y write, Employees read. Para un comercio de prueba, haz lo mismo desde el Global Developer Dashboard (Test merchants, Launch dashboard).
- Pega el token en
CLOVER_API_TOKEN. Se envía comoAuthorization: Bearer <token>. - Pon en
CLOVER_MERCHANT_IDel id de comercio de 13 caracteres (mId). Aparece en la dirección del dashboard.../merchants/<mId>/...y en Account and setup, Merchants. - Pon en
CLOVER_API_URLla región del comercio:https://api.clover.com(Norteamérica),https://api.eu.clover.com(Europa),https://api.la.clover.com(Latinoamérica) ohttps://apisandbox.dev.clover.com(sandbox). - Instala el conector y ejecuta
clover_get_merchant: muestra el nombre del negocio y confirma el token.
Qué lee: el comercio con clover_get_merchant, clover_get_merchant_address y clover_get_merchant_properties (moneda, zona horaria, configuración regional, propinas e impuestos), los tipos de pedido y los roles de empleados; artículos con clover_list_items y clover_get_item (precio, tipo de precio, SKU, código, coste; con expand categorías, impuestos, grupos de modificadores o stock), stock con clover_list_item_stocks y clover_get_item_stock, categorías con clover_list_categories, clover_get_category y clover_list_category_items, además de tipos de impuesto, descuentos predefinidos y grupos de modificadores; pedidos con clover_list_orders y clover_get_order (expand lineItems y payments), sus líneas y descuentos de pedido; pagos con clover_list_payments, clover_get_payment, clover_list_order_payments y clover_list_employee_payments (útil para propinas y ventas por empleado), reembolsos con clover_list_refunds y clover_get_refund, medios de pago (tenders) con clover_list_tenders y clover_get_tender; clientes con clover_list_customers y clover_get_customer (expand emailAddresses, phoneNumbers y addresses); empleados con clover_list_employees y clover_get_employee y fichajes con clover_list_shifts y clover_list_employee_shifts.
Qué escribe: artículos con clover_create_item y clover_update_item; stock con clover_update_item_stock, que fija una cantidad absoluta y no una diferencia, así que la IA lee antes el stock actual; categorías con clover_create_category y clover_update_category; clientes con clover_create_customer y clover_update_customer. Pedidos en una llamada: clover_calculate_order devuelve totales, impuestos, descuentos y cargos de servicio sin guardar, y después clover_create_atomic_order crea el mismo carrito. Paso a paso: clover_create_order, clover_add_line_item, clover_add_order_discount y clover_update_order. Clover actualiza un registro con un POST a su dirección. Los pedidos y los cambios de stock aparecen al instante en los dispositivos y en los informes del comercio, así que la IA te enseña lo que va a cambiar y espera tu sí.
Desactivadas al instalar: clover_void_line_item, clover_delete_order y clover_delete_customer. No se pueden deshacer, así que un admin del workspace las activa cuando el equipo las necesita.
Filtros: filter acepta una lista de condiciones con la forma campo operador valor, por ejemplo ["createdTime>=1767225600000", "createdTime<1767830400000"]; se combinan con AND. Los filtros de tiempo en pedidos, pagos y reembolsos cubren como máximo 90 días por petición, así que la IA divide los periodos más largos en ventanas de 90 días. expand añade registros relacionados en la misma llamada (separados por comas).
Formatos de datos: las listas llegan como {elements: [...], href}. El dinero es un entero en céntimos de la moneda del comercio (1999 = 19,99); los descuentos son importes negativos. Las cantidades de línea (unitQty) van multiplicadas por 1000. Los tipos de impuesto van multiplicados por 100000 (825000 = 8,25 %). Las horas son milisegundos Unix epoch en UTC; la IA las convierte con la zona horaria de clover_get_merchant_properties. Los ids son cadenas de 13 caracteres.
Paginación: limit (100 por defecto, 1000 como máximo) y offset. Cuando una página trae limit elementos, la IA vuelve a pedir con offset más limit. Las listas anidadas cargadas con expand se cortan en 100 entradas.
Límites y errores comunes: 16 peticiones por segundo y 5 peticiones simultáneas por token; por encima, Clover responde 429 con retry-after. 401 indica un token incorrecto o revocado o la región equivocada en CLOVER_API_URL (un token de sandbox solo funciona en apisandbox.dev.clover.com). 403 indica que al token le falta el permiso para esos datos: edita el token en el Merchant Dashboard y márcalo. 404 indica un id de comercio o de registro incorrecto. 400 suele indicar un campo de filtro no válido.
El conector no cobra pagos con tarjeta ni emite reembolsos: eso se hace en el dispositivo Clover o con la Clover Ecommerce API. Lee tipos de impuesto, descuentos, grupos de modificadores, empleados y turnos sin cambiarlos y, con las herramientas activas al instalar, no borra nada.
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 Gemini
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.
Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 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. - Guarda el archivo y reinicia
gemini. - Ejecuta
/mcpdentro de Gemini CLI (ogemini mcp listen tu terminal):anythingmcpdebería aparecer como conectado. - Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de
Clover.
Herramientas disponibles
| Tool | What it does |
|---|---|
clover_get_merchant | Get the merchant behind the token: business name, address, phone, website, owner and default currency |
clover_get_merchant_address | Get the business address of the merchant: street lines, city, state, zip and country, as stored in Clover |
clover_get_merchant_properties | Get merchant settings: default currency, time zone, locale, tips and tax settings, receipt and order options |
clover_list_order_types | List order types of the merchant (dine in, take out, delivery and custom ones) with label, taxable flag, fee and hours |
clover_list_roles | List the employee roles of the merchant (admin, manager, employee and custom roles) with their system role and employees |
clover_list_items | List inventory items with name, price, price type, SKU, code, cost, stock tracking and visibility |
clover_get_item | Get one inventory item by id with price, price type, SKU, code, cost and, when expanded, categories, tax rates, modifier groups and stock |
clover_create_item | Create an inventory item. price is in cents (1999 = 19.99) and required; priceType FIXED, VARIABLE (entered at sale) or PER_UNIT |
clover_update_item | Update an inventory item (Clover updates with POST): name, price in cents, SKU, code, cost, visibility or categories |
clover_list_item_stocks | List the stock of all inventory items: item id, quantity on hand (decimal) and the low-stock alert threshold |
clover_get_item_stock | Get the stock of one inventory item: quantity on hand, stock alert threshold and when it last changed |
clover_update_item_stock | Set the stock of an inventory item to a new absolute quantity (not a change) |
clover_list_categories | List item categories with name, sort order and colour; expand items to get the items in each category |
clover_get_category | Get one item category by id with name, sort order and colour; expand items to list its items |
clover_list_category_items | List the items in one category with price, SKU and, when expanded, stock, tax rates and modifier groups |
clover_create_category | Create an item category shown on the register, with a name, sort order and colour |
clover_update_category | Rename a category or change its sort order or colour (Clover updates with POST). name is required by the API |
clover_list_tax_rates | List tax rates with name, rate (in units of 1/100000, so 825000 = 8.25%), flat amount, type and whether it is the default |
clover_list_discounts | List the predefined discounts of the merchant: name, amount in cents (negative) or percentage |
clover_list_modifier_groups | List modifier groups (e.g |
clover_list_orders | List orders with state, total in cents, payment state, employee, order type and times |
clover_get_order | Get one order by id with total, state, payment state and, when expanded, line items, discounts, payments, refunds and customers |
clover_create_atomic_order | Create a complete order in one call from an order cart: line items (inventory items or ad hoc), modifiers, discounts and service charge… |
clover_calculate_order | Calculate an order cart without saving it: totals, taxes, discounts and service charges for the same cart as clover_create_atomic_order |
clover_create_order | Create an empty custom order (title, note, state, order type), then add lines with clover_add_line_item |
clover_update_order | Update an order (Clover updates with POST): title, note, state, order type or tax removal |
clover_list_order_line_items | List the line items of an order with name, price in cents, quantity, discounts, modifications and refund state |
clover_get_order_line_item | Get one line item of an order with name, price in cents, unit quantity, note, discounts and modifications |
clover_add_line_item | Add a line item to an order: an inventory item by id, or an ad hoc line with name and price in cents. unitQty is quantity x 1000 for… |
clover_void_line_item | Remove (void) a line item from an order |
clover_list_order_discounts | List the order-level discounts applied to an order with name, amount in cents or percentage and approver |
clover_add_order_discount | Apply a discount to a whole order: a name plus an amount in cents (negative, e.g. -500) or a percentage, or a predefined discount by id |
clover_delete_order | Delete an order |
clover_list_payments | List payments with amount, tip and tax in cents, result (SUCCESS, FAIL and so on), tender, card type, order and employee |
clover_get_payment | Get one payment by id with amount, tip, tax, cash back in cents, result, tender, card transaction details and refunds |
clover_list_order_payments | List the payments made on one order with amount, tip and tax in cents, result, tender and card details |
clover_list_employee_payments | List the payments taken by one employee, with amount, tip and tax in cents, result and tender |
clover_list_refunds | List refunds with amount and tax in cents, the payment and order they belong to, employee and time |
clover_get_refund | Get one refund by id with amount, tax and tip in cents, the refunded payment, line items and employee |
clover_list_tenders | List tenders (payment methods such as cash, credit card, debit card, check, gift card, external) with label, label key and whether enabled |
clover_get_tender | Get one tender (payment method) by id with label, label key, instructions and whether it opens the cash drawer |
clover_list_customers | List customers with name, customer since and marketing consent; expand emailAddresses, phoneNumbers and addresses for contact data |
clover_get_customer | Get one customer by id with name, customer since, marketing consent and, when expanded, emails, phone numbers, addresses and notes |
clover_create_customer | Create a customer with name, email addresses, phone numbers, addresses and marketing consent |
clover_update_customer | Update a customer (Clover updates with POST): name, marketing consent or metadata such as business name and note |
clover_delete_customer | Delete a customer with their contact data |
clover_list_employees | List employees with name, nickname, email, role, PIN-protected flags and custom id; expand roles or shifts |
clover_get_employee | Get one employee by id with name, nickname, email, role and, when expanded, roles and shifts |
clover_list_shifts | List clock-in and clock-out shifts of all employees with in time, out time and overrides |
clover_list_employee_shifts | List the clock-in and clock-out shifts of one employee with in time, out time and overrides, newest first |
Ejemplos de prompts
- "¿Cuánto vendimos ayer y cuántas propinas hubo, desglosado por medio de pago? Usa nuestra zona horaria."
- "¿Qué artículos con control de stock tienen menos de 10 unidades? Muestra nombre, SKU y cantidad."
- "Cambia el precio del artículo Cappuccino a 4,20. Enséñame el precio anterior y el nuevo antes de guardar."
- "Calcula un pedido con 2 pizzas Margarita y 1 limonada con nuestro descuento de personal, muéstrame el total y luego créalo."
- "Lista los reembolsos de los últimos 30 días con importe, pedido original y empleado."
FAQ
¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?