AliExpress MCP con Gemini CLI

💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Vendedor de AliExpress, pega la clave de la aplicación y el secreto, haz clic en Authorize e inicia sesión con la cuenta de vendedor de la tienda, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Vendedor de AliExpress + Gemini

Deja que tu IA gestione tu tienda de AliExpress: pedidos y direcciones de entrega, declaraciones de envío con tu propio transportista, productos con precios y stock, categorías, disputas y estados de liquidación. Utiliza tu propia aplicación de vendedor en la Plataforma Abierta de AliExpress.

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:

ALIEXPRESS_SELLER_APP_KEY, ALIEXPRESS_SELLER_APP_SECRET

Paso 1 — Obtén credenciales

Lo que necesitas: una cuenta de vendedor de AliExpress, una cuenta de desarrollador en la Plataforma Abierta de AliExpress y una aplicación propia en la categoría Desarrollador interno de vendedor. AliExpress revisa el perfil del desarrollador y debe aprobar esa categoría de aplicación antes de que se pueda crear la aplicación: nadie más que AliExpress puede acelerar esto, y puede rechazarlo. Su FAQ en chino menciona de 2 a 5 días hábiles para la revisión del desarrollador; no se da tiempo para la categoría.

1. En https://openservice.aliexpress.com haz clic en Crear cuenta (o inicia sesión). Luego completa tu perfil bajo tu ID de usuario, Perfil: elige el tipo de desarrollador, completa los campos y sube los documentos que AliExpress solicita. AliExpress revisa el perfil.
2. Abre la Consola de aplicaciones y haz clic en Crear. En la lista de categorías de aplicaciones haz clic en Solicitar en Desarrollador interno de vendedor (para un vendedor de AliExpress que construye una aplicación para su propio uso), escribe por qué la necesitas en el campo Razón y haz clic en OK. La categoría mostrará Pendiente hasta que AliExpress la apruebe, luego Activa. Solo se puede crear una aplicación por categoría.
3. En la categoría aprobada haz clic en Crear aplicación. Ingresa un nombre para la aplicación y, como URL de callback, la dirección de este servidor seguida de /api/iop-auth/callback (en AnythingMCP Cloud: https://cloud.anythingmcp.com/api/iop-auth/callback), luego haz clic en Enviar.
4. Haz clic en Resumen de APP, luego en Gestionar en tu aplicación. Copia la Clave de la aplicación en ALIEXPRESS_SELLER_APP_KEY. Bajo Información básica haz clic en Ver y copia el Secreto de la aplicación en ALIEXPRESS_SELLER_APP_SECRET.
5. En la misma página mira el Grupo de permisos de API: un grupo marcado como Inactivo debe ser solicitado con Solicitar y una razón antes de que sus APIs respondan.
6. Bajo Consola de aplicaciones, Gestión de aplicaciones, Gestión de autorizaciones ingresa la cuenta de vendedor de tu tienda en la lista blanca de autorización de vendedores y envía. Una aplicación autodesarrollada puede vincular hasta 50 tiendas, y solo tiendas que estén legalmente relacionadas con el desarrollador: la misma empresa, matriz y subsidiaria, la misma empresa matriz, o el mismo representante legal o accionista mayoritario.
7. En la página del conector haz clic en Authorize. AliExpress mostrará su página de inicio de sesión: selecciona el país, ingresa la cuenta de vendedor y la contraseña de la tienda y haz clic en Iniciar sesión y autorizar. Regresarás a AnythingMCP por tu cuenta.

Duración del token: AnythingMCP mantiene el token de acceso y el token de actualización encriptados, lee cuánto duran de la respuesta de AliExpress (expires_in y refresh_expires_in, en segundos) y renueva el token de acceso por sí mismo. Una renovación trae un nuevo token de actualización pero no mueve la fecha de finalización del token de actualización. Cuando se alcanza esa fecha (o AliExpress responde refresh_expires_in 0), haz clic en Authorize nuevamente. La página de Gestión de autorizaciones muestra las duraciones de tu aplicación; la guía en chino de AliExpress menciona 365 días para el token de acceso y 730 días para el token de actualización de una aplicación de vendedor autodesarrollada.

Cómo se firma: cada llamada va a /sync con el nombre de la API en method, además de app_key, access_token, un timestamp en milisegundos, sign_method=sha256 y sign, el HMAC-SHA256 en mayúsculas de todos los parámetros ordenados por nombre, con la clave del Secreto de la aplicación. El secreto nunca sale de AnythingMCP.

Por dónde empezar

• La tienda: aliexpress_seller_get_seller_profile (id de vendedor, país, moneda de cotización, conteos de productos) y aliexpress_seller_get_shop_info (id de tienda, nombre y URL).
• Pedidos: aliexpress_seller_list_orders con order_status WAIT_SELLER_SEND_GOODS lista lo que debe ser enviado; aliexpress_seller_get_order da montos, sub-pedidos y seguimiento; aliexpress_seller_get_order_receipt_info la dirección de entrega.
• Envío con tu propio transportista: aliexpress_seller_list_order_shipping_services indica por sub-pedido si se envía con tu propio transportista (DBS) o con logística de la plataforma; aliexpress_seller_list_shipment_providers da los códigos de proveedor; aliexpress_seller_declare_shipment envía el transportista y el número de seguimiento a AliExpress y no cuesta nada; aliexpress_seller_modify_shipment lo corrige (máximo dos veces, dentro de diez días). aliexpress_seller_list_packages muestra los paquetes y su estado.
• Logística de la plataforma (desactivada en la instalación, porque piden un servicio logístico para la tienda): aliexpress_seller_list_seller_addresses para la dirección de recogida, aliexpress_seller_pack_order para crear el paquete, aliexpress_seller_ship_platform_package para entregarlo, aliexpress_seller_cancel_package para deshacer un paquete. La impresión de la guía de envío no está incluida: AliExpress la devuelve como un archivo dentro de la respuesta, imprímela desde el centro de vendedores.
• Productos: aliexpress_seller_list_products por estado, aliexpress_seller_get_product con cada SKU, aliexpress_seller_update_prices y aliexpress_seller_update_stock por sku_code, aliexpress_seller_set_products_online, y aliexpress_seller_set_products_offline (desactivado). Publicar, editar y eliminar productos no están incluidos.
• Configuración del catálogo: aliexpress_seller_list_categories, aliexpress_seller_list_publishable_categories y aliexpress_seller_list_freight_templates.
• Disputas: aliexpress_seller_list_disputes y aliexpress_seller_get_dispute son lecturas. aliexpress_seller_accept_dispute_solution está desactivado: aceptar una propuesta es vinculante y puede reembolsar al comprador.
• Dinero: aliexpress_seller_list_settlement_bills lista los estados de liquidación. El conector nunca paga, reembolsa o retira por sí mismo.

Ids y formatos

• Los ids de pedidos, sub-pedidos, productos y disputas son números largos: pásalos como texto, solo dígitos. El id de sub-pedido (child_id en la lista de pedidos, id en child_order_list de un pedido) es lo que las herramientas de envío llaman tradeOrderItemId.
• Los tiempos de pedido están en Hora del Pacífico de EE. UU., escritos yyyy-MM-dd HH:mm:ss. Los filtros de paquetes y disputas toman tiempo Unix en milisegundos. Los períodos de liquidación se escriben YYYY/MM/dd, sus fechas de liberación son milisegundos Unix.
• Los montos son objetos con amount (una cadena decimal) y currency_code; los precios que envías son cadenas decimales en la moneda del producto.
• Las listas comienzan desde 1: pedidos y disputas hasta 50 por página, paquetes hasta 50, productos menos de 100. Las actualizaciones de precios y stock toman como máximo 20 productos con 200 SKUs cada uno.
• order_status FINISH cubre pedidos completados y cerrados por igual, y solo se devuelve cuando se solicita. endReason en el extend_map de sus sub-pedidos los distingue.

Respuestas y errores: los resultados se encuentran bajo aliexpress_..._response (el nombre de la API con guiones bajos). Muchas llamadas responden 200 y llevan su propio veredicto dentro: result.success con errorCode y errorMessage (o error_code y error_message), update_success con update_failed_list para actualizaciones de precios y stock. Siempre léelo antes de decirle al usuario que una escritura funcionó. Los rechazos de la pasarela vienen como error_response con un code: IllegalAccessToken cuando la autorización terminó (AnythingMCP renueva el token una vez y vuelve a intentar), InvalidAppkey o IncompleteSignature cuando la clave y el secreto no coinciden, InsufficientPermission cuando la aplicación carece del grupo de permisos de API, y un código de límite de llamadas cuando se ha agotado la cuota de la categoría de la aplicació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 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 muestra YOUR_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" }
    }
  }
}

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 gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Vendedor de AliExpress.

Herramientas disponibles

Ejemplos de indicaciones

• "¿Qué pedidos de AliExpress están esperando que envíe?"
• "Declara el envío del pedido 8187654321098765 con seguimiento de Cainiao LP00123456789012."
• "¿Qué disputas están abiertas y qué piden los compradores?"
• "Establece el stock de SKU AE-CASE-14-BLK a 300 y el precio a 4.99 USD."
• "Muestra los estados de liquidación del mes pasado."

Preguntas frecuentes

¿Debo pegar un token de acceso? No. Pegas la Clave de la Aplicación y el Secreto de la Aplicación de tu aplicación de Desarrollador interno de vendedor, añades la tienda a la lista blanca de vendedores de la aplicación y haces clic en Authorize en la página del conector. La página de inicio de sesión de AliExpress solicita la cuenta de vendedor de la tienda, y el conector mantiene y renueva los tokens por sí mismo.

¿Qué cubre y qué no? Pedidos y direcciones de entrega, declaraciones de envío con tu propio transportista, paquetes, productos con precios y stock, categorías, plantillas de flete, disputas y estados de liquidación. Publicar o editar productos y mensajes de compradores no están cubiertos.

¿Qué herramientas se instalan desactivadas? Las herramientas de logística de la plataforma (aliexpress_seller_pack_order, aliexpress_seller_ship_platform_package, aliexpress_seller_cancel_package), aliexpress_seller_set_products_offline y aliexpress_seller_accept_dispute_solution. Actívalas en la página del conector solo si la IA debe usarlas.

¿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

• Página de inicio del conector
• Conectar a Claude