Conectar Amazon Vendor Central con Claude (MCP)

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

Amazon Vendor Central + Claude

Amazon Vendor Central a través de la API de Selling Partner: órdenes de compra al por menor, acuses de recibo, confirmaciones de envío, facturas, órdenes de cumplimiento directo con etiquetas, albaranes e inventario, estado de transacciones e informes de proveedores. Inicia sesión con el token de actualización de Amazon de una aplicación de proveedor 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:

SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, SPAPI_MARKETPLACE_ID

Paso 1 — Obtener credenciales

La configuración toma aproximadamente 20 minutos. Necesitas la revisión de Amazon del perfil de desarrollador.

1. En Vendor Central abre Integración, luego Integración API, y completa el Perfil de Desarrollador. Bajo Acceso a Datos elige Desarrollador Privado: Construyo aplicación(s) que integran mi propia empresa con las APIs de Amazon Services, selecciona los roles que necesitas y elige Registrar. Amazon revisa el perfil y abre un caso con los siguientes pasos.
2. En la misma página elige Agregar nuevo cliente de aplicación, completa el formulario, marca Vendedores donde Amazon ofrece la opción, y selecciona los roles. Luego elige Ver bajo credenciales LWA y copia el identificador del cliente en SPAPI_CLIENT_ID y el secreto del cliente en SPAPI_CLIENT_SECRET.
3. Elige Autorizar aplicación para tu cuenta de proveedor. Amazon muestra un token de actualización (comienza con Atzr|): pégalo en SPAPI_REFRESH_TOKEN.
4. Elige tu región en SPAPI_ENDPOINT (América del Norte, Europa o Lejano Oriente) e ingresa el id del marketplace de tu tienda de Amazon en SPAPI_MARKETPLACE_ID, por ejemplo ATVPDKIKX0DER (EE.UU.), A1PA6795UKMFR9 (Alemania), A1F83G8C2ARO7P (Reino Unido), APJ6JRA9NG5V4 (Italia), A13V1IB3VIYZZH (Francia), A1RKKUPIHCS9HS (España), A1VC38T7YXB528 (Japón).

Roles: las herramientas de venta al por menor necesitan el rol Amazon Fulfillment. Las herramientas de cumplimiento directo necesitan Envío Directo al Consumidor (Restringido), un rol restringido porque las órdenes llevan direcciones de clientes; Amazon solicita más información sobre la protección de datos antes de concederlo. Los informes de proveedores necesitan Brand Analytics. Una llamada sin su rol responde 403.

Por dónde empezar: amazon_vendor_list_purchase_orders con purchase_order_state New muestra lo que Amazon ordenó; amazon_vendor_get_purchase_order da una orden completa.

Adquisición minorista: amazon_vendor_list_purchase_orders, amazon_vendor_get_purchase_order, amazon_vendor_list_purchase_order_statuses (cantidades aceptadas y recibidas). Responde a una orden con amazon_vendor_submit_acknowledgements, anuncia el envío con amazon_vendor_submit_shipment_confirmations, y sigue con amazon_vendor_list_shipments y amazon_vendor_list_transport_labels. Los acuses de recibo y las confirmaciones de envío son respuestas vinculantes a Amazon, por lo que amazon_vendor_submit_acknowledgements y amazon_vendor_submit_shipment_confirmations se instalan desactivados, al igual que amazon_vendor_submit_invoices: actívalos en la página del conector cuando la IA deba enviarlos; te pedirá que confirmes cada uno.

Cumplimiento Directo (envías a los clientes de Amazon): amazon_vendor_list_df_orders, amazon_vendor_get_df_order, amazon_vendor_acknowledge_df_orders, amazon_vendor_list_df_packing_slips, amazon_vendor_get_df_packing_slip, amazon_vendor_list_df_customer_invoices, amazon_vendor_list_df_shipping_labels, amazon_vendor_get_df_shipping_label, amazon_vendor_submit_df_shipment_confirmations y amazon_vendor_update_df_inventory. Crear etiquetas de envío: amazon_vendor_request_df_shipping_labels y amazon_vendor_create_df_shipping_labels se instalan desactivados, al igual que amazon_vendor_acknowledge_df_orders, amazon_vendor_submit_df_shipment_confirmations y amazon_vendor_submit_df_invoices.

Las presentaciones son asíncronas: cada herramienta de envío responde con un transactionId y nada más. Lee el resultado con amazon_vendor_get_transaction_status (venta al por menor) o amazon_vendor_get_df_transaction_status (Cumplimiento Directo): Procesando, Éxito o Fallo con los errores. No informes una presentación como completada antes de que diga Éxito.

Informes (3 pasos): amazon_vendor_create_report, luego amazon_vendor_get_report hasta que esté LISTO, luego amazon_vendor_download_report_document.

Notas de campo: las llamadas de lista cubren como máximo 7 días por llamada; las listas de Cumplimiento Directo necesitan tanto created_after como created_before. Los tiempos son ISO 8601. Las cantidades vienen con una unidad (Cajas o Cada uno para venta al por menor, Cada uno para Cumplimiento Directo); el dinero es una cadena decimal con un código de moneda. partyId es tu código de proveedor para la parte vendedora y un código de almacén para las partes de envío y recepción. Página de listas con pagination.nextToken.

Límites de tasa: 10 llamadas por segundo por operación con un pico de 10 (estado de transacción: pico 20). En un 429 espera un momento y vuelve a llamar.

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 Claude

La URL de tu servidor: en AnythingMCP, abre Servidores MCP → el servidor en el que está este conector, y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala dondequiera que esta guía muestre YOUR_SERVER_ID.

Ruta recomendada: funciona en claude.ai web sin editar ningún archivo de configuración.

1. En Claude, abre Personalizar → Conectores.
2. Haz clic en +, luego en Agregar conector personalizado.
3. Ingresa un nombre, por ejemplo Amazon Vendor Central, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, luego haz clic en Agregar.
4. Haz clic en Conectar e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas a continuación aparecerán en tu chat: comienza a escribir indicaciones.

Herramientas disponibles

Ejemplos de indicaciones

• "¿Qué nuevas órdenes de compra de Amazon llegaron esta semana y qué cantidades piden?"
• "Muestra la orden de compra 2JK3S9VC con sus artículos y ventana de envío."
• "¿Qué órdenes de Cumplimiento Directo aún necesitan una etiqueta de envío?"
• "Consulta la transacción 12345-abcde: ¿aceptó Amazon la factura que envié?"
• "Solicita un informe de ventas de proveedores para la semana pasada y dime cuándo está listo."

Preguntas frecuentes

¿Funciona con Claude Code así como con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

¿De dónde provienen las credenciales? De una aplicación privada en Vendor Central (Integración, Integración API) después de que Amazon revisó tu Perfil de Desarrollador. Copia el ID de cliente LWA y el secreto, elige Autorizar aplicación para obtener el token de actualización, e ingresa tu región y el id del marketplace. No se necesitan claves de AWS.

¿Qué roles necesita? Las herramientas de venta al por menor necesitan Amazon Fulfillment, las herramientas de Cumplimiento Directo el rol restringido Envío Directo al Consumidor, y los informes Brand Analytics. Es para proveedores (1P); los vendedores en Seller Central utilizan el conector de Amazon Seller Central.

¿Qué herramientas se instalan desactivadas? Las respuestas vinculantes a Amazon: amazon_vendor_submit_acknowledgements, amazon_vendor_submit_shipment_confirmations, amazon_vendor_submit_invoices, amazon_vendor_acknowledge_df_orders, amazon_vendor_request_df_shipping_labels, amazon_vendor_create_df_shipping_labels, amazon_vendor_submit_df_shipment_confirmations y amazon_vendor_submit_df_invoices. Actívalas en la página del conector cuando la IA deba enviarlas.

Próximos pasos

• Página de inicio del conector
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot