Conectar Amazon Shipping MCP con Cursor

💡 ¿No tienes 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 + Cursor

API de Amazon Shipping v2 (SP-API) para empresas que envían con Amazon como transportista: compara tarifas, rastrea paquetes, recupera etiquetas y documentos nuevamente, 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 SP-API con el rol de Amazon Logistics.

Requisitos previos

Consulta las instrucciones de configuración completas 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:

SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, AMAZON_SHIPPING_BUSINESS_ID

Paso 1 — Obtener credenciales

La configuración tarda unos 20 minutos. Necesitas las reseñas de Amazon plus.

1. Necesitas una cuenta de Amazon Shipping. 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_YourCompany, con la entidad comercial Shipping y el rol Amazon Logistics, y responde No a la delegación de acceso a datos restringidos (PII).
4. En 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 Amazon Shipping 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 firme (Guía de Etiquetas de Prueba de Amazon Shipping) 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 y 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 Amazon Shipping. 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.

Paso 2 — Instalar 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 — Agregar el conector en Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Amazon Shipping.

Herramientas disponibles

Ejemplos de mensajes

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

Preguntas frecuentes

¿De dónde provienen las credenciales? De una aplicación privada SP-API con el rol de Amazon Logistics, creada en Seller Central o, sin una cuenta de vendedor, en el Portal de Proveedores de Soluciones de Amazon. Copia el ID de cliente LWA y el secreto, autoriza la aplicación para tu propia cuenta para obtener el token de actualización, y elige tu región y país de Amazon Shipping.

¿Qué países cubre? Los países donde Amazon Shipping opera: Estados Unidos, Reino Unido, Francia, Italia, España, India, Emiratos Árabes Unidos, Arabia Saudita, Egipto y Japón. Es para paquetes enviados con Amazon como transportista, también para pedidos que no provienen de Amazon.

¿Puede comprar etiquetas o cancelar envíos? amazon_shipping_purchase_shipment, amazon_shipping_direct_purchase_shipment, amazon_shipping_one_click_shipment, amazon_shipping_cancel_shipment y amazon_shipping_generate_collection_form están instalados desactivados. Actívalos en la página del conector solo si la IA debe usarlos.

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Próximos pasos

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