Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Shoptet 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
Tienda online Shoptet (República Checa, Eslovaquia, Hungría), solo lectura: pedidos con historial y notas, productos y variantes con precios y stock, categorías, marcas, niveles y movimientos de stock, clientes, facturas, facturas proforma, notas de crédito, métodos de pago y de envío.
Prueba a pedir
Prompts de ejemplo para Shoptet
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 → Shoptet, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Shoptet + Gemini
Tienda online Shoptet (República Checa, Eslovaquia, Hungría), solo lectura: pedidos con historial y notas, productos y variantes con precios y stock, categorías, marcas, niveles y movimientos de stock, clientes, facturas, facturas proforma, notas de crédito, métodos de pago y de envío.
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:
SHOPTET_API_TOKEN
Paso 1 — Obtener credenciales
La configuración lleva unos 3 minutos. Necesitas una tienda Shoptet Premium, porque la API privada solo está disponible en Premium, y acceso a su administración.
- En la administración de Shoptet, abre Connections (Propojení), Private API y crea un token.
- Dale al token acceso de lectura a las áreas que la IA debe ver: pedidos, productos, stock, clientes y documentos. Un área que el token no puede leer responde 403.
- Pega el token en
SHOPTET_API_TOKEN: solo el token, sin espacios ni comillas. - Instala el conector y ejecuta
shoptet_get_eshop: muestra el nombre, la URL, las monedas, los idiomas y la zona horaria de la tienda, y así confirma que el token funciona.
Un token, una tienda: cada token pertenece a una sola tienda. Si tienes una tienda .cz y otra .sk, instala el conector una segunda vez con el token de la otra tienda.
Qué lee: la configuración de la tienda; los pedidos con dirección de facturación y de entrega, líneas, precios con y sin IVA, estado, indicador de pagado, método de pago y de envío, canal de venta, notas y número de seguimiento; el historial completo de un pedido (cambios de estado, emails enviados, observaciones); los productos y sus variantes con código, EAN, precio, tipo de IVA, disponibilidad y stock, también por almacén si lo pides; categorías y marcas; los niveles de stock con las cantidades reservadas por pedidos y los movimientos de stock; los clientes registrados con direcciones, número de empresa y NIF-IVA y grupo de clientes; las facturas con símbolo variable, vencimiento y desglose de IVA; las facturas proforma; las notas de crédito (opravné daňové doklady) con su motivo; y los métodos de pago y de envío.
Primero la configuración de la tienda: los estados de pedido, los orígenes de pedido, los almacenes, las categorías y las marcas son distintos en cada tienda, así que la IA lee primero sus ids en tu tienda (por ejemplo con shoptet_list_order_statuses o shoptet_list_stocks) y después filtra con ellos. Un producto se encuentra por su código, el SKU que ves en la administración y en los pedidos, con shoptet_get_product_by_code.
Páginas, horas y precios: los pedidos llegan del más reciente al más antiguo, como mucho 50 por página; los productos de 1 a 100 por página; las notas de crédito como mucho 20 por página. Cada lista indica cuántas páginas hay, y la IA solo pide la siguiente cuando la necesita. Las horas llevan un desfase como 2026-10-20T00:00:00+0200: las tiendas checas y eslovacas usan la hora de Europe/Prague. Los precios vienen con la moneda de la tienda, por ejemplo CZK o EUR.
Solo lectura: el conector no tiene ninguna herramienta que cambie nada. No puede modificar un pedido ni su estado, un producto, un precio, el stock ni un cliente, así que no hay nada que la IA tenga que confirmar contigo.
Límites: Shoptet permite 3 peticiones simultáneas por token y frena los picos con un 429. La IA espera unos segundos antes de volver a intentarlo y pide solo lo que necesita en lugar de recorrer toda la tienda.
Errores comunes: 401 expired-token o invalid-token significa que el token se borró o caducó: crea uno nuevo. 403 invalid-token-no-rights indica que el token no tiene acceso a esa área: edita sus permisos en Private API. 404 indica que no hay ningún pedido, producto o documento con ese código.
El conector no crea ni modifica pedidos, productos, precios, stock o clientes, no emite facturas ni notas de crédito y no envía emails a tus clientes.
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
Shoptet.
Herramientas disponibles
| Tool | What it does |
|---|---|
shoptet_get_eshop | Get the e-shop's own settings: name, URL, contact and billing details, VAT payer, time zone, default price list, currencies and languages.… |
shoptet_list_orders | List orders, newest first, at most 50 per page: code, creation and change time, customer name, e-mail and phone, status, paid flag, total… |
shoptet_get_order | Get one order by its code (order number): billing and delivery address, items with code, name, amount, unit price and VAT, prices, status… |
shoptet_get_order_history | Get the history of an order: every status change, e-mail sent, remark and system event with time, text and the user who did it |
shoptet_list_order_statuses | List the order statuses of the shop (they differ from shop to shop): id, name, whether it is a system status, whether it marks the order… |
shoptet_list_order_sources | List the order sources of the shop (e-shop, cash desk, marketplaces, imports) with id and name |
shoptet_list_products | List products, 1 to 100 per page: guid, name, type, visibility, default category, brand, supplier, URL and rating |
shoptet_get_product | Get one product by guid with its variants: code, EAN, price, VAT rate, stock amount, availability, weight and parameters per variant… |
shoptet_get_product_by_code | Get a product by the code of the product or of one of its variants (the SKU shown in the admin and on orders), with the same details and… |
shoptet_list_categories | List the product categories: guid, name, parent guid, visibility and URL |
shoptet_list_brands | List the brands (manufacturers) of the shop: guid, code, name, web and whether they show in the brand list |
shoptet_list_stocks | List the stocks (warehouses) of the shop with id, title and whether they are a pickup point, plus the default stock id |
shoptet_list_stock_supplies | List the stock levels in one stock: product guid, code, amount in stock, claimed amount (reserved by orders) and storage location |
shoptet_list_stock_movements | List stock movements in one stock, oldest first: product code, amount after the change, the change, time and who or what changed it (an… |
shoptet_list_customers | List registered customers: guid, billing name and company, creation and change time and admin link |
shoptet_get_customer | Get one registered customer: billing and delivery addresses, company id and VAT id, customer group, price ratio, remark and account e-mails |
shoptet_list_customer_groups | List the customer groups (e.g. retail, wholesale, VIP) with id, name, default price list and maximum discount |
shoptet_list_invoices | List invoices: code, order code, issue, due and tax dates, billing name and company, variable symbol, paid flag and price |
shoptet_get_invoice | Get one invoice by its code: items, prices and VAT breakdown, billing and delivery address, payment method, due date, paid flag and symbols |
shoptet_list_credit_notes | List credit notes (opravné daňové doklady): code, invoice and order code, date, billing name, reason and price |
shoptet_list_proforma_invoices | List proforma invoices (advance invoices): code, order code, date, billing name, paid flag and price |
shoptet_list_payment_methods | List the payment methods of the shop with guid, name, type, visibility and whether they are for wholesale or in-person payment |
shoptet_list_shipping_methods | List the shipping methods of the shop with guid, name, carrier, tracking URL and visibility |
Ejemplos de prompts
- "¿Qué pedidos de ayer siguen sin pagar y cuál es el total de cada uno en CZK?"
- "Enséñame el historial del pedido 2026000123: cuándo cambió de estado, qué emails recibió el cliente y cuál es el número de seguimiento."
- "¿Qué productos se están agotando en nuestro almacén principal y cuántas unidades de cada uno ya están reservadas por pedidos?"
- "Busca todos los pedidos de [email protected] de este año y dime qué facturas suyas siguen pendientes de pago."
- "Haz una lista de las notas de crédito de este mes con el motivo, el importe y la factura a la que corresponde cada una."
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
¿Te ha sido útil esta guía?
