Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Aymakan con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
La mensajería Aymakan (Arabia Saudí) desde un agente de IA: sigue envíos por número de seguimiento o referencia de pedido, lista tus envíos, enlaces a etiquetas AWB, solicitudes de recogida y franjas horarias, ciudades, puntos PUDO, almacenes y direcciones guardadas. Crear y cancelar envíos y recogidas está incluido, desactivado al instalar.
Prueba a pedir
Prompts de ejemplo para Aymakan
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Aymakan, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Aymakan + Meta Muse
La mensajería Aymakan (Arabia Saudí) desde un agente de IA: sigue envíos por número de seguimiento o referencia de pedido, lista tus envíos, enlaces a etiquetas AWB, solicitudes de recogida y franjas horarias, ciudades, puntos PUDO, almacenes y direcciones guardadas. Crear y cancelar envíos y recogidas está incluido, 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:
AYMAKAN_API_KEY
Paso 1 — Obtener credenciales
La configuración lleva unos 2 minutos. Necesitas una cuenta de cliente de Aymakan, la mensajería saudí.
- Inicia sesión en el panel de clientes de Aymakan.
- Abre Technical → AyMakan API y copia la clave de API (el security code).
- Pégala tal cual en
AYMAKAN_API_KEY, sin la palabra Bearer. - Instala el conector y ejecuta
aymakan_ping:logged_indebe indicarYes.
Usa la clave de producción: una clave del entorno de desarrollo de Aymakan responde aquí Invalid Credentials. Si regeneras la clave en el panel, la anterior deja de funcionar, así que actualiza también las demás integraciones que la usen.
Qué lee: tus envíos por número de seguimiento o por tu propia referencia de pedido, con datos de entrega y de recogida, importe contra reembolso, peso, bultos, estado actual y todo el historial de estados en inglés y en árabe; la lista de todos los envíos de tu cuenta con los intentos de entrega y las fechas principales; los enlaces a las etiquetas (AWB); tus solicitudes de recogida, las ciudades donde se puede recoger y las franjas libres de una fecha; las ciudades a las que entrega Aymakan; puntos PUDO como taquillas y tiendas asociadas; los almacenes de Aymakan; y las direcciones de recogida guardadas en tu cuenta.
Etiquetas solo antes de la recogida: Aymakan devuelve el enlace al PDF de la etiqueta solo mientras el envío sigue en estado AY-0001 (creado, aún sin recoger). Después de la recogida la API responde 422, así que imprime tus etiquetas antes de que pase el mensajero. Para varios envíos, la IA puede traer un único PDF con todas las etiquetas.
Búsqueda por tu número de pedido: solo funciona con envíos creados con una referencia, y solo encuentra envíos de tu propia cuenta. Una referencia que no existe responde No Shipments Found.
Desactivadas al instalar: aymakan_create_shipment, aymakan_cancel_shipment, aymakan_create_pickup_request y aymakan_cancel_pickup_request. Reservan o cancelan trabajo real del mensajero, por eso un administrador las activa de forma deliberada. Aun así, la IA te muestra primero el envío (destinatario, ciudad, importe contra reembolso, bultos), el número de seguimiento o la solicitud de recogida, y espera tu sí. Un envío solo se puede cancelar en estado AY-0001, y una solicitud de recogida solo mientras está pendiente o en proceso.
Límites: la lista de envíos llega en páginas fijas de 100 (unos 110 KB cada una), así que para un solo envío la IA usa el seguimiento. Aymakan limita el número de solicitudes de recogida por cliente y día.
Errores habituales: 401 Invalid Credentials significa clave incorrecta, clave antigua tras regenerarla o clave de desarrollo. 422 indica el motivo en el mensaje, por ejemplo No Shipments Found, un error de validación por campo o una etiqueta pedida para un envío que ya ha pasado de AY-0001.
El conector no gestiona liquidaciones de contra reembolso ni facturas, y no reserva ni cancela envíos o recogidas mientras un administrador no active esas herramientas.
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 Muse
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 muestraYOUR_SERVER_ID.
Muse añade los servidores MCP remotos como conectores personalizados e inicia sesión en ellos con OAuth.
- En Muse, abre Settings → Connectors y elige Add custom connector.
- Pega la URL del servidor MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse abre la página de inicio de sesión de AnythingMCP: inicia sesión y aprueba el acceso.
- En un chat, pídele a Muse algo que necesite las herramientas de
Aymakan.
También puedes configurarlo desde un chat, en la web, en las apps de iOS y Android o en WhatsApp. Envía a Muse este mensaje:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Muse se conecta desde la nube de Meta, así que localhost no funciona.
Herramientas disponibles
| Tool | What it does |
|---|---|
aymakan_ping | Check the Aymakan API status and the API key: returns status, environment (production) and logged_in Yes or No |
aymakan_get_tracking | Track one or more Aymakan shipments by tracking number: full shipment data with delivery and collection details, COD amount, weight and… |
aymakan_get_shipments_by_reference | Get Aymakan shipments by your own order reference (the reference given when the shipment was created): full shipment data, tracking_info… |
aymakan_list_shipments | List every shipment of the account, 100 per page (fixed by Aymakan): tracking number, reference, service type, COD flag and amount, pieces… |
aymakan_get_awb_label | Get the link to the PDF AWB label of one shipment by tracking number |
aymakan_get_bulk_awb_labels | Get one PDF link with the AWB labels of several shipments |
aymakan_list_pickup_requests | List the pickup requests of the account with id, pickup code, type, contact, city and address, number of shipments and picked shipments… |
aymakan_list_pickup_cities | List the cities where Aymakan accepts pickup requests, in English and Arabic |
aymakan_get_time_slots | Get the pickup time slots available to the account on a date (e.g. morning, afternoon, evening with their hours) |
aymakan_list_cities | List the cities Aymakan delivers to, in English (city_en) and Arabic (city_ar) |
aymakan_list_pudo_locations | List PUDO (pickup and drop-off) points such as lockers and partner shops with id, name in English and Arabic, address, city, coordinates… |
aymakan_list_dropoff_locations | List Aymakan's warehouses where shipments can be dropped off: name, city, address, manager, phone, e-mail and coordinates |
aymakan_list_addresses | List the collection addresses saved on the Aymakan account: id, title, name, e-mail, city, address, postcode, neighbourhood, phone, country… |
aymakan_create_shipment | Create a new Aymakan shipment |
aymakan_cancel_shipment | Cancel an Aymakan shipment by tracking number |
aymakan_create_pickup_request | Book a courier pickup: date (today or later), time slot from aymakan_get_time_slots, city from aymakan_list_pickup_cities, contact name and… |
aymakan_cancel_pickup_request | Cancel a pickup request by its id (from aymakan_list_pickup_requests) |
Ejemplos de prompts
- "¿Dónde están ahora los envíos AY2866494373 y AY2866494374?"
- "Busca el envío de nuestra referencia de pedido 10045 y enséñame todo su historial de estados."
- "¿Qué envíos míos de esta semana necesitaron más de un intento de entrega, y en qué ciudades?"
- "Dame un solo PDF con las etiquetas de todos los envíos creados hoy que aún no se han recogido."
- "¿Qué franjas de recogida quedan libres mañana y qué solicitudes de recogida mías siguen pendientes?"
FAQ
¿Dónde está disponible Muse? Por ahora Meta ofrece Muse en Estados Unidos y Canadá, en la web, en las apps de iOS y Android y en WhatsApp.
¿Meta revisa este conector? No. Meta no revisa los conectores personalizados. Muse solo ve las herramientas que activaste para este servidor MCP en AnythingMCP, y puedes desconectarlo cuando quieras en Settings → Connectors.
Siguientes pasos
¿Te ha sido útil esta guía?
