Cómo conectar noon Marketplace a Microsoft Copilot vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → noon Marketplace, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

noon Marketplace + Microsoft Copilot

Vende en noon.com (Emiratos Árabes Unidos, Arabia Saudí, Egipto) desde un agente de IA a través de la noon Partner API: almacenes, contenido del catálogo y grupos de productos, ofertas, precios, stock, pedidos y envíos FBPI, órdenes de compra, consulta de devoluciones y exportaciones masivas. Inicio de sesión con cuenta de servicio y un JWT firmado; las escrituras de precios, stock, productos y pedidos vienen desactivadas al instalar.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

NOON_KEY_ID, NOON_PRIVATE_KEY, NOON_PROJECT_CODE

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas una cuenta de vendedor en noon.com (Emiratos Árabes Unidos, Arabia Saudí o Egipto) con acceso al portal noon Partner, y una clave de cuenta de servicio para la noon Partner API.

1. Inicia sesión en el portal noon Partner y abre la Access App (o User & Access > User access), y después API Users en la barra lateral izquierda.
2. Haz clic en Add Service Account, escribe un nombre visible y un nombre de usuario, y elige un rol. Project Viewer basta para las herramientas de lectura; las de escritura necesitan un rol que pueda cambiar catálogo, precios, stock o pedidos (Project Owner lo permite todo). Puedes restringir la clave a direcciones IP y ponerle una caducidad; sin ellas funciona desde cualquier IP y no caduca nunca. Cada partner puede crear una sola cuenta de servicio con hasta cinco claves.
3. Al hacer clic en Add se descarga un archivo de clave .json. Solo se muestra una vez; si lo pierdes, crea una clave nueva.
4. Copia tres campos de ese archivo: key_id en NOON_KEY_ID, private_key en NOON_PRIVATE_KEY y project_code en NOON_PROJECT_CODE. La clave privada es el PEM completo, de -----BEGIN PRIVATE KEY----- a -----END PRIVATE KEY-----; puedes pegarla en una sola línea, con las secuencias \n tal como aparecen en el archivo.
5. Instala el conector y ejecuta noon_marketplace_whoami: muestra la cuenta de servicio detrás de la sesión (user code y nombre de usuario).

Cómo funciona el inicio de sesión: no hay una API key fija. En cada inicio de sesión el conector firma con tu clave privada un JWT RS256 nuevo (el id de la clave como subject, la hora actual, un id de token aleatorio) y lo envía con tu código de proyecto al endpoint de login de noon. noon responde con cookies de sesión, que acompañan a cada llamada. Una sesión dura 30 días; el conector vuelve a iniciar sesión antes de que termine y siempre que una llamada devuelve 401. Cada petición lleva además la cabecera X-Project con tu código de proyecto, que la API de contenido de noon exige.

Identificadores: partner_sku es tu propio SKU, único entre todos tus productos; precios, stock y ofertas van ligados a él. sku_parent (empieza por Z) es el id de noon de un producto con todas sus variantes, y se usa para el contenido y los grupos de productos. El SKU de noon (sku, empieza por N) y psku_code (empieza por P) identifican una variante. warehouse_code sale de noon_marketplace_list_warehouses; los pedidos y envíos FBPI pertenecen a un almacén de integración. country_code es ae, sa o eg en minúsculas, y los precios son por SKU y país, en AED, SAR o EGP. Los pedidos y envíos se identifican por fbpi_order_nr, mp_item_nr (una línea de un pedido) y tu propio integration_shipment_nr.

Qué lee: la cuenta de servicio y tus almacenes; todos los códigos de categoría del catálogo de noon y los atributos que exige una categoría, con cómo se validan sus valores; el contenido de un producto con su grado de completitud, el estado de QC y los motivos por los que no está publicado; los grupos de productos (variantes que se muestran juntas en una página); las ofertas de un partner SKU en cada país con precio, stock, estado de publicación y los problemas que mantienen una oferta offline; precios, MSRP (el precio de referencia tachado) y estado activo por SKU y país; el stock por almacén y SKU; los pedidos FBPI (servidos desde tu propio almacén) con sus líneas, el cliente de un pedido y sus envíos; las órdenes de compra; los artículos devueltos por número AWB o código de barras de devolución; y el estado de las importaciones de catálogo. Varias lecturas son peticiones POST con un cuerpo JSON, porque así funciona la API de noon; no cambian nada.

Exportaciones masivas y AWB: noon_marketplace_list_export_categories lista los tipos de informe que puedes exportar, noon_marketplace_create_export inicia uno y noon_marketplace_get_export_status muestra cuándo está listo el archivo, con su download_url. noon_marketplace_generate_awbs genera números AWB (guías aéreas) para los paquetes que se entregan al courier de noon. Ninguna de las dos cambia datos, así que ambas quedan activadas.

Desactivadas al instalar: noon_marketplace_upsert_product, noon_marketplace_upsert_product_group, noon_marketplace_upsert_prices, noon_marketplace_update_stock, noon_marketplace_mark_items_unavailable, noon_marketplace_create_shipment y noon_marketplace_cancel_shipment. Las escrituras de precios, stock, productos, pedidos y envíos cambian lo que los clientes ven y compran (precios publicados, cantidad vendible, contenido publicado) o actúan sobre pedidos reales, y algunas no se pueden deshacer: marcar artículos como no disponibles los cancela para el cliente, y cancelar un envío cancela todos los artículos que contiene. Un administrador activa las que necesita un workspace en los ajustes de herramientas del conector. Después de crear un envío, el manifiesto para la recogida de noon se completa en Seller Lab.

Resultados por lotes: las llamadas de precios, stock y productos responden 200 aunque algunos elementos hayan fallado, así que comprueba el estado de cada elemento devuelto y reenvía solo los fallidos. noon_marketplace_update_stock fija una cantidad absoluta; no la suma a la actual. En noon_marketplace_upsert_prices, un campo omitido o enviado como null conserva su valor. Un producto guardado con status_id 3 tiene problemas de contenido, que noon_marketplace_get_content muestra.

Límites: las herramientas de listado devuelven un next_token, y la IA vuelve a llamar con él y los mismos filtros hasta que llega vacío. Los límites de peticiones se aplican por proyecto y endpoint, con una ventana principal y otra de ráfaga más corta: la mayoría de endpoints permiten 1500 peticiones cada 60 segundos, noon_marketplace_list_warehouses 30 cada 60 segundos con una ráfaga de 15 cada 30 segundos. Un 429 indica que hay que esperar los segundos de la cabecera X-Ratelimit-Retry-After; mejor una llamada por lotes que muchas de un solo elemento.

Errores comunes: 401 significa que falló el inicio de sesión o la sesión: id de clave y clave privada de archivos de clave distintos, una clave desactivada o caducada, o un reloj del servidor desfasado más de cinco minutos respecto al de noon, que entonces rechaza el token firmado. 403 PERMISSION_DENIED significa que la cuenta de servicio no tiene un rol para esa llamada; añade uno en User Access > Manage Role del portal Partner. 400 INVALID_ARGUMENT indica el campo y el motivo. NOT_FOUND en un elemento de precio significa que el SKU aún no tiene registro de precio en ese país, así que fija primero un precio.

Paso 2 — Instalar el adapter

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ñadir el conector en Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de noon Marketplace.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

Ejemplos de prompts

• "Comprueba el stock de los partner SKU TS-100-BLK, TS-100-WHT y TS-100-RED en nuestro almacén de Dubái y avísame de los que estén por debajo de 10 unidades."
• "Revisa mis precios del SKU TS-100-BLK en Emiratos y Arabia Saudí: precio, MSRP, si cada oferta está publicada y qué mantiene una oferta offline."
• "Lista los pedidos FBPI de hoy en nuestro almacén de integración con sus líneas y estado, y dime cuáles no se han enviado todavía."
• "Muéstrame qué tipos de informe puedo exportar, inicia el que elija y comprueba su estado hasta que el enlace de descarga esté listo."
• "Antes de publicar una nueva funda de móvil, busca el código de categoría correcto y muéstrame los atributos obligatorios y cuáles necesitan valores en inglés y en árabe."

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse