Cómo conectar YunExpress a Microsoft Copilot vía MCP

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

YunExpress + Microsoft Copilot

API OMS de YunExpress (云途物流): países de destino, métodos de envío y tipos de mercancía, cotizaciones de flete, órdenes de envío con números de seguimiento, etiquetas, transportistas de última milla, eventos de seguimiento y cargos facturados, cambios de peso e interceptaciones. Borrar órdenes queda desactivado 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:

YUNEXPRESS_API_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas una cuenta de cliente de YunExpress con acceso a la API.

1. Inicia sesión en el centro de clientes de YunExpress (www.yunexpress.cn o tu portal de clientes de YunExpress) y abre la sección API. Anota tu código de cliente (客户编号, p. ej. C12345) y el API secret (API密钥); si aún no existe, solicítalo ahí.
2. YunExpress se autentica con Authorization: Basic <token>, donde el token es el Base64 del código de cliente, un ampersand y el API secret (un &, no dos puntos). Calcúlalo una vez en tu ordenador, por ejemplo con printf '%s' 'C12345&YourApiSecret' | base64, y pega solo el resultado en YUNEXPRESS_API_TOKEN. Se guarda cifrado.
3. Instala el conector y ejecuta yunexpress_list_countries: lista los países de destino y confirma el token.

Qué API: el conector usa la OMS API de YunExpress (versión 1.4.x) en http://oms.api.yunexpress.com. Ese host solo responde por HTTP simple. YunExpress también tiene una open platform más reciente (openapi.yunexpress.cn) que firma cada petición con una marca de tiempo y un token OAuth; este conector no la usa.

Qué lee: los países de destino con su código de dos letras; los métodos de envío (productos logísticos) de tu cuenta con código, nombre en chino e inglés y si tienen seguimiento, opcionalmente solo los que sirven a un país; los tipos de mercancía, como mercancía general o con baterías; cotizaciones de flete por método con tarifa base, certificado, combustible y otros cargos, total, moneda, peso facturable y días de entrega (yunexpress_get_price_quote, con código postal para recargos de zonas remotas); órdenes de envío con número de waybill, número de pedido del cliente, número de seguimiento, método, estado, pesos, destinatario, líneas aduaneras y cargos; la dirección del remitente de una orden; el seguimiento con estado del paquete, estado de seguimiento, transportista de última milla, prueba de entrega y eventos (yunexpress_get_tracking sigue tu configuración de visualización, yunexpress_get_full_tracking devuelve el historial completo donde el método lo admite); el transportista de última milla y su número; los cargos realmente facturados, una vez que YunExpress ha pesado y facturado un waybill.

Enviar un paquete: la IA revisa los métodos para el país y el tipo de mercancía, pide una cotización y luego llama a yunexpress_create_orders con 1 a 10 órdenes por llamada. Cada resultado tiene Success, WayBillNumber, TrackingNumber y TrackType (1 número de seguimiento disponible, 2 pendiente, 3 ninguno). Si el número de seguimiento está pendiente, yunexpress_get_tracking_numbers lo obtiene más tarde por número de pedido del cliente (los resultados se guardan en caché 30 minutos). yunexpress_get_labels devuelve las etiquetas de hasta 50 órdenes como URL temporal de un PDF.

Qué escribe: yunexpress_create_orders reserva envíos reales, yunexpress_update_weight cambia el peso previsto antes de que YunExpress pese el paquete y yunexpress_intercept_order pide a YunExpress que detenga un paquete, con un motivo. Antes de cada escritura la IA te muestra las órdenes (destinatario, método, peso, declaración aduanera) y espera tu sí. Tras un timeout poco claro, lee la orden con yunexpress_get_order antes de reintentar, para que nada se reserve dos veces.

Desactivado al instalar: yunexpress_delete_order, que borra una orden que YunExpress aún no ha recibido y no se puede deshacer. Un administrador lo activa cuando el equipo lo necesita.

Números y unidades: pesos en kg (hasta 3 decimales), medidas en cm enteros, valores declarados (UnitPrice) por unidad en la CurrencyCode indicada. OrderNumber acepta el número de waybill, tu número de pedido del cliente o el número de seguimiento; para interceptar y borrar, OrderType indica cuál es (1 waybill, 2 pedido del cliente, 3 número de seguimiento). Estados del paquete: 0 desconocido, 1 enviado, 2 en tránsito, 3 entregado, 4 recibido, 5 cancelado, 6 entrega fallida, 7 devuelto. Estado de seguimiento: 0 no encontrado, 10 preaviso, 20 en tránsito, 30 listo para recoger, 40 fallido, 50 entregado, 60 incidencia, 80 desconocido, 90 devuelto, 100 cancelado.

Límites: no hay paginación; las listas llegan en una sola respuesta. La creación admite 10 órdenes por llamada y las etiquetas 50. Si YunExpress responde con el código 10000 se alcanzó el límite de peticiones: espera un momento.

Errores comunes: cada respuesta tiene Code (0000 es éxito), Message, los datos en Item o Items y un RequestId para citar al soporte de YunExpress. HTTP 421 con ResultCode 401, o el código 1002 o 1003, significa que el token es incorrecto: vuelve a calcularlo con código de cliente y secret unidos por &. 1004 es un error de parámetro, 1006 sin datos, 1011 éxito parcial, 2004 un número de pedido del cliente duplicado, 2005 una orden que ya existe, 2006 sin número de seguimiento para este método, 2009 un peso que no es positivo, 2010 un método que no sirve al destino, 9999 un error de la plataforma.

El conector no usa la open platform de YunExpress y no gestiona tu cuenta, facturas ni pagos: los únicos datos de coste que lee son cotizaciones y los cargos facturados por waybill.

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 YunExpress.
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

• "¿Qué métodos de envío de YunExpress sirven a Alemania y cuáles tienen seguimiento?"
• "Cotiza un paquete de 0,35 kg y 20 x 15 x 5 cm con batería a Francia, por método con total y días de entrega."
• "Crea una orden de YunExpress para SO-1042 a Anna Muster en Berlín con el método THPHR. Enséñame antes destinatario, peso y líneas aduaneras."
• "¿Dónde está el paquete con número de seguimiento YT2430012345678901 y quién hace la última milla?"
• "Saca las etiquetas de las órdenes de hoy SO-1040 a SO-1045 en un solo PDF."

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