Amazon Shipping MCP: tarifas, seguimiento y etiquetas

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Amazon Shipping, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Amazon Shipping

API de Envío de Amazon v2 (SP-API) para empresas que envían con Amazon como transportista: compara tarifas, rastrea paquetes, vuelve a obtener etiquetas y documentos, encuentra taquillas y mostradores de recogida, y lee formularios de recogida. La compra, la compra con un clic y la cancelación están incluidas pero desactivadas. Aplicación privada de SP-API con el rol de Amazon Logistics.

Configuración

Configurar toma aproximadamente 20 minutos. Necesitas las reseñas de Amazon plus.

1. Necesitas una cuenta de Envío de Amazon. Los vendedores en Amazon utilizan su cuenta de Seller Central; otros transportistas crean una cuenta en https://solutionproviderportal.amazon.com (no se necesita cuenta de vendedor) y completan la verificación de identidad del desarrollador.
2. Completa el Perfil del Desarrollador: para Acceso a Datos elige Desarrollador Privado: Construyo aplicación(s) que integran mi propia empresa con las APIs de Amazon Services, para Roles elige Amazon Logistics. Amazon responde en aproximadamente 5 días hábiles.
3. Crea un cliente de aplicación SP-API llamado AmazonShipping_TuEmpresa, con la entidad comercial Shipping y el rol de Amazon Logistics, y responde No a delegar el acceso a datos restringidos (PII).
4. Bajo credenciales LWA elige Ver y copia el identificador del cliente (amzn1.application-oa2-client.…) en SPAPI_CLIENT_ID y el secreto del cliente en SPAPI_CLIENT_SECRET.
5. Autoriza la aplicación para tu propia cuenta (Autorizar aplicación) y copia el token de actualización (Atzr|…) en SPAPI_REFRESH_TOKEN.
6. Elige la región en SPAPI_ENDPOINT y tu país de Envío de Amazon en AMAZON_SHIPPING_BUSINESS_ID. Estados Unidos: América del Norte. Reino Unido, Francia, Italia, España, India, Emiratos Árabes Unidos, Arabia Saudita, Egipto: Europa. Japón: Lejano Oriente.

El conector intercambia el token de actualización en https://api.amazon.com/auth/o2/token por tokens de acceso de una hora y los envía en el encabezado x-amz-access-token; el encabezado x-amzn-shipping-business-id lleva el país. Las variables tienen los mismos nombres que en el conector de Amazon Seller Central, pero la aplicación debe tener el rol de Amazon Logistics: las credenciales de una aplicación de venta sin él responden 403.

Antes de la primera etiqueta real: Amazon pide a cada nueva integración que produzca una etiqueta de prueba y la haga firmar (Guía de Etiquetas de Prueba de Envío de Amazon) y luego confirma la primera fecha de envío. Mantén las herramientas de compra desactivadas hasta que eso esté hecho.

Por dónde empezar: amazon_shipping_get_rates con la dirección de envío, el destino y un paquete devuelve los servicios y precios; amazon_shipping_get_tracking sigue un paquete por id de seguimiento e id de transportista.

Tarifas: amazon_shipping_get_rates necesita para cada paquete un packageClientReferenceId propio, dimensiones, peso, el valor asegurado y al menos un artículo. channel_details.channelType es EXTERNAL para pedidos de tu propia tienda y AMAZON (con el id de pedido de Amazon) para pedidos de Amazon. La respuesta lleva un requestToken y un rateId por servicio; ambos son necesarios para comprar y expiran después de 10 minutos. Cuando una tarifa dice requiresAdditionalInputs, lee el esquema con amazon_shipping_get_additional_inputs.

Seguimiento y documentos: amazon_shipping_get_tracking devuelve el estado resumen y el historial de eventos; amazon_shipping_get_shipment_documents devuelve la etiqueta de un paquete comprado nuevamente (base64) y necesita el id de envío y tu packageClientReferenceId. amazon_shipping_get_access_points encuentra taquillas y mostradores cerca de un código postal.

Formularios de recogida: amazon_shipping_get_unmanifested_shipments muestra lo que aún espera un manifiesto, amazon_shipping_get_collection_form_history y amazon_shipping_get_collection_form leen formularios anteriores, y amazon_shipping_get_carrier_accounts lista las cuentas de transportista vinculadas. amazon_shipping_generate_collection_form cierra los envíos abiertos de un transportista y está instalado desactivado.

Compra (desactivada): amazon_shipping_purchase_shipment compra una tarifa, amazon_shipping_one_click_shipment compra por id de servicio sin una solicitud de tarifa, amazon_shipping_direct_purchase_shipment compra para un pedido de Amazon con el servicio que Amazon elige, y amazon_shipping_cancel_shipment cancela un envío comprado antes de la entrega. Cada compra se carga a la cuenta de Envío de Amazon. Pasa una clave de idempotencia y reutilízala al reintentar, para que un tiempo de espera no compre dos veces.

Formatos: los montos son objetos con value y unit (la moneda); los pesos utilizan GRAMO, KILOGRAMO, ONZA o LIBRA y dimensiones PULGADA o CENTÍMETRO; los tiempos son ISO 8601. Las respuestas están envueltas en payload; los fallos vienen como errors, una lista de code, message y details.

Límites: 80 llamadas por segundo con un pico de 100 en la mayoría de las operaciones; el encabezado de respuesta x-amzn-RateLimit-Limit muestra el límite aplicado. Un 429 significa esperar y reintentar.

Requisitos previos: SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, AMAZON_SHIPPING_BUSINESS_ID

Instalar el conector localmente

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

Abre http://localhost:3000/connectors/store, elige Amazon Shipping y pega las variables de entorno listadas bajo Requisitos previos.

Herramientas disponibles

Ejemplos de solicitudes

• "Compara las tarifas de envío de Amazon para un paquete de 2 kg desde Manchester M1 1AE a Londres SW1A 1AA."
• "Rastrea el paquete de envío de Amazon QA0123456789 y dime el último escaneo."
• "Encuentra taquillas de Amazon cerca del código postal EC1A 1BB."
• "Obtén nuevamente la etiqueta del envío que compré esta mañana."
• "¿Qué envíos aún no están en un formulario de recogida?"

Próximos pasos

• Conectar a Claude
• Conectar a ChatGPT