Resumen
Tiendas SHOPLINE (myshopline.com) a través de la API REST de Admin: pedidos, cumplimientos y seguimiento, transacciones y reembolsos, productos y variantes, clientes, ubicaciones y niveles de inventario. Token de acceso de aplicación privada.
Configuración guiada
Conecta SHOPLINE a Gemini en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta SHOPLINE con la configuración guiada y añade tu URL MCP a Gemini. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para SHOPLINE
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.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → SHOPLINE, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
SHOPLINE + Gemini
Tiendas SHOPLINE (myshopline.com) a través de la API REST de Admin: pedidos, cumplimientos y seguimiento, transacciones y reembolsos, productos y variantes, clientes, ubicaciones y niveles de inventario. Token de acceso de aplicación privada.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
SHOPLINE_HANDLE, SHOPLINE_ACCESS_TOKEN
Paso 1 — Obtén credenciales
La configuración tarda aproximadamente 5 minutos.
- Inicia sesión en el Admin de SHOPLINE en
https://admin.myshopline.comy abre Apps, luego Desarrollar Apps (en la parte superior derecha), y crea una aplicación privada. - Asigna los permisos de acceso que necesitan las herramientas:
read_orders,write_orders,read_products,write_products,read_customers,read_inventory,write_inventory,read_location,read_assigned_fulfillment_ordersywrite_assigned_fulfillment_orders(los permisos de solo lectura son suficientes para las herramientas de lectura). - Abre el certificado API de la aplicación y copia el token de acceso en
SHOPLINE_ACCESS_TOKEN. Un token de aplicación privada es válido por 3 años y se puede renovar allí; eliminar la aplicación lo revoca. - Ingresa el identificador de la tienda, la primera parte de
<handle>.myshopline.com, enSHOPLINE_HANDLE.
Por dónde empezar: shopline_list_orders con status cualquier (y fulfillment_status cuando busques pedidos enviados), luego shopline_list_order_fulfillments. Para productos shopline_list_products, shopline_get_product y shopline_list_product_variants.
Pedidos: shopline_list_orders, shopline_count_orders, shopline_update_order (etiquetas, contacto, notas, dirección de envío), shopline_list_order_transactions, shopline_list_order_refunds. El id es el id del pedido; name es el número de pedido que ve el cliente (1001 en adelante, con un prefijo opcional). Cancelar y reembolsar no están incluidos, porque devuelven dinero.
Envío: shopline_create_fulfillment envía un pedido con un número de seguimiento, shopline_list_order_fulfillments lista los envíos, shopline_update_fulfillment_tracking reemplaza la lista de seguimiento de un envío (envía todas las entradas, el resto se borra).
Productos: shopline_list_products, shopline_get_product, shopline_count_products, shopline_update_product (estado activo publica, borrador oculta), shopline_list_product_variants, shopline_update_variant (precio, precio de comparación, SKU, código de barras). Las etiquetas se ingresan como una lista y regresan como una cadena separada por comas. Los productos tienen hasta cinco opciones por variante.
Clientes: shopline_list_customers, shopline_get_customer, shopline_search_customers, shopline_list_customer_orders.
Inventario: cada variante tiene un inventory_item_id. shopline_list_locations, shopline_get_inventory_items, shopline_get_inventory_levels, luego shopline_set_inventory (absoluto) o shopline_adjust_inventory (delta).
Paginación: las listas utilizan un cursor. Cuando hay otra página, la respuesta lleva _pagination.nextUrl; pasa su valor page_info con el mismo límite. _pagination falta en la última página.
Ids y formatos: los ids son cadenas largas de dígitos (26 dígitos): siempre pásalos como texto. Los tiempos son ISO 8601; los precios son cadenas decimales en la moneda de la tienda.
Límite de tasa: 4 solicitudes por segundo por aplicación y tienda, con ráfagas de hasta 40 en cola; más allá de eso, SHOPLINE responde 429 Demasiadas solicitudes. Las respuestas están limitadas a 8 MB, así que usa fields y límites más pequeños para tiendas grandes.
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 — Agrega 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
SHOPLINE.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
shopline_list_orders | Lista pedidos: id, nombre (número de pedido como 1001), order_at, financial_status, fulfillment_status, status, currency, current_total_price… |
shopline_count_orders | Cuenta los pedidos que coinciden con los filtros (status, payment, shipment, dates): responde con el conteo. Solo lectura |
shopline_update_order | Cambia las etiquetas de un pedido, el correo electrónico o teléfono del comprador, notas del comerciante (note_attributes) o dirección de envío. Solo se envían los campos dados; etiquetas… |
shopline_list_order_fulfillments | Lista los cumplimientos (envíos) de un pedido: id, status, tracking_company, tracking_number, tracking_url, line_items y created_at |
shopline_create_fulfillment | Envía un pedido (todo o los elementos de línea dados) con un número de seguimiento y transportista. notify_customer envía el correo electrónico de envío. Responde… |
shopline_update_fulfillment_tracking | Reemplaza la información de seguimiento de un cumplimiento. La lista reemplaza lo que está almacenado: las entradas de seguimiento omitidas se eliminan |
shopline_list_order_transactions | Lista las transacciones de pago de un pedido: id, kind (venta, reembolso, etc.), status, amount, currency, gateway y processed_at. Solo lectura |
shopline_list_order_refunds | Lista los reembolsos de un pedido: id, created_at, note, refund_line_items y transacciones con montos. Solo lectura |
shopline_list_products | Lista productos: id, título, handle, status (activo, borrador, archivado), vendor, tags, product_category, created_at, updated_at, options y… |
shopline_get_product | Lee un producto: título, body_html, status, vendor, tags, handle, options, imágenes, medios y variantes con precio, sku, código de barras, peso… |
shopline_count_products | Cuenta los productos que coinciden con los filtros (status, collection, dates): responde con el conteo. Solo lectura |
shopline_update_product | Cambia un producto: título, subtítulo, descripción (body_html), status (activo publica, borrador oculta, archivado archiva), vendor, tags… |
shopline_list_product_variants | Lista las variantes de un producto: id, sku, código de barras, precio, compare_at_price, option1 a option5, peso, inventory_quantity, inventory_policy… |
shopline_update_variant | Cambia una variante: precio y compare_at_price (cadenas decimales en la moneda de la tienda), sku, código de barras, peso con weight_unit… |
shopline_list_customers | Lista clientes: id, email, teléfono, nombre, apellido, estado, tags, orders_count, total_spent, accepts_marketing, direcciones y… |
shopline_get_customer | Lee un cliente: email, teléfono, nombres, estado, tags, nota, orders_count, total_spent, consentimiento de marketing y direcciones |
shopline_search_customers | Busca clientes por nombre, email, teléfono o texto de dirección (query_param), o por criterios exactos como tags o orders_count (query). Igual… |
shopline_list_customer_orders | Lista los pedidos de un cliente, con los mismos campos de pedido que shopline_list_orders. Hasta 100 por página |
shopline_list_locations | Lista ubicaciones de inventario (almacenes y tiendas): id, nombre, dirección, activo y si es la ubicación predeterminada |
shopline_get_inventory_items | Lee artículos de inventario (uno por variante): id, sku, rastreado, costo y país de origen. El inventory_item_id está en cada variante |
shopline_get_inventory_levels | Lee stock disponible por artículo de inventario y ubicación: inventory_item_id, location_id, available y updated_at |
shopline_set_inventory | Establece el stock disponible de un artículo de inventario en una ubicación a un número absoluto (reemplaza la cantidad actual) |
shopline_adjust_inventory | Cambia el stock disponible de un artículo de inventario en una ubicación por un delta: positivo suma, negativo resta |
Ejemplos de indicaciones
- "¿Cuántos pedidos de SHOPLINE llegaron esta semana, y cuántos están sin cumplir?"
- "Agrega el seguimiento de DHL 1234567890 al cumplimiento del pedido #1052."
- "¿Qué variantes tienen menos de 5 unidades en nuestra ubicación principal?"
- "Muestra todos los pedidos del cliente Anna Berg."
- "¿Qué pedidos fueron reembolsados el mes pasado, y por cuánto?"
Preguntas frecuentes
¿Qué SHOPLINE cubre? Tiendas en myshopline.com, a través de la API REST de Admin de SHOPLINE. La plataforma más antigua de SHOPLINE en shoplineapp.com tiene una API diferente y no está cubierta.
¿De dónde proviene el token de acceso? Admin de SHOPLINE, Apps, Desarrollar Apps: crea una aplicación privada con los permisos que necesitan las herramientas y copia el token de acceso de su certificado API. Ingresa también el identificador de la tienda.
¿Qué herramientas se instalan apagadas? Ninguna. Las transacciones y reembolsos son de solo lectura, y cada escritura (notas de pedidos, cumplimientos, seguimiento, cambios de productos e inventario) se te muestra antes de que se ejecute.
¿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.
Próximos pasos
¿Te ha sido útil esta guía?