Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Aymakan mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
Der Kurierdienst Aymakan (Saudi-Arabien) aus einem KI-Agent: Sendungen über Trackingnummer oder Bestellreferenz verfolgen, deine Sendungen auflisten, Links zu AWB-Labels, Abholaufträge und Zeitfenster, Städte, PUDO-Punkte, Lager und gespeicherte Adressen. Sendungen und Abholungen anlegen und stornieren ist enthalten, bei der Installation aber deaktiviert.
Frag einfach
Beispiel-Prompts für Aymakan
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Aymakan klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Aymakan + Meta Muse
Der Kurierdienst Aymakan (Saudi-Arabien) aus einem KI-Agent: Sendungen über Trackingnummer oder Bestellreferenz verfolgen, deine Sendungen auflisten, Links zu AWB-Labels, Abholaufträge und Zeitfenster, Städte, PUDO-Punkte, Lager und gespeicherte Adressen. Sendungen und Abholungen anlegen und stornieren ist enthalten, bei der Installation aber deaktiviert.
Voraussetzungen
Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:
AYMAKAN_API_KEY
Schritt 1 — Zugangsdaten holen
Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Kundenkonto bei Aymakan, dem saudischen Kurierdienst.
- Melde dich im Aymakan-Kunden-Dashboard an.
- Öffne Technical → AyMakan API und kopiere den API-Schlüssel (den Security Code).
- Füge ihn genau so in
AYMAKAN_API_KEYein, ohne das Wort Bearer. - Installiere den Connector und rufe
aymakan_pingauf:logged_inmussYeszeigen.
Nimm den Produktionsschlüssel: Ein Schlüssel aus der Entwicklungsumgebung von Aymakan antwortet hier mit Invalid Credentials. Erzeugst du den Schlüssel im Dashboard neu, funktioniert der alte nicht mehr. Aktualisiere dann auch alle anderen Integrationen, die ihn noch nutzen.
Was er liest: deine Sendungen über die Trackingnummer oder deine eigene Bestellreferenz, mit Zustell- und Abholdaten, Nachnahmebetrag, Gewicht, Packstücken, aktuellem Status und dem ganzen Statusverlauf auf Englisch und Arabisch; die Liste aller Sendungen deines Kontos mit Zustellversuchen und den wichtigsten Daten; Links zu den Labels (AWB); deine Abholaufträge, die Städte mit Abholung und die freien Zeitfenster eines Tages; die Städte, in die Aymakan zustellt; PUDO-Punkte wie Paketstationen und Partnershops; die Lager von Aymakan; und die Abholadressen, die in deinem Konto gespeichert sind.
Labels nur vor der Abholung: Aymakan liefert den Link zum PDF-Label nur, solange die Sendung noch im Status AY-0001 ist (angelegt, nicht abgeholt). Nach der Abholung antwortet die API mit 422, also druck deine Labels, bevor der Kurier kommt. Für mehrere Sendungen kann die KI ein einziges PDF mit allen Labels holen.
Suche über deine Bestellnummer: Das klappt nur bei Sendungen, die mit einer Referenz angelegt wurden, und es werden nur Sendungen deines eigenen Kontos gefunden. Eine Referenz, die es nicht gibt, antwortet mit No Shipments Found.
Bei der Installation deaktiviert: aymakan_create_shipment, aymakan_cancel_shipment, aymakan_create_pickup_request und aymakan_cancel_pickup_request. Sie buchen oder stornieren echte Kurierleistungen, deshalb schaltet ein Administrator sie bewusst ein. Auch dann zeigt dir die KI zuerst die Sendung (Empfänger, Stadt, Nachnahmebetrag, Packstücke), die Trackingnummer oder den Abholauftrag und wartet auf dein Ja. Eine Sendung lässt sich nur im Status AY-0001 stornieren, ein Abholauftrag nur, solange er offen ist oder bearbeitet wird.
Limits: Die Sendungsliste kommt in festen Seiten zu 100 Sendungen (je etwa 110 KB), deshalb nimmt die KI für eine einzelne Sendung die Sendungsverfolgung. Aymakan begrenzt die Zahl der Abholaufträge pro Kunde und Tag.
Häufige Fehler: 401 Invalid Credentials heißt: falscher Schlüssel, alter Schlüssel nach einer Neuerzeugung oder Entwicklungsschlüssel. 422 nennt den Grund in der Meldung, zum Beispiel No Shipments Found, einen Validierungsfehler pro Feld oder ein Label für eine Sendung, die schon über AY-0001 hinaus ist.
Der Connector wickelt keine Nachnahme-Abrechnungen und keine Rechnungen ab, und er bucht oder storniert keine Sendungen und Abholungen, solange ein Administrator diese Tools nicht eingeschaltet hat.
Schritt 2 — Adapter installieren
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
Schritt 3 — Connector in Muse hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.
- Öffne in Muse Settings → Connectors und wähle Add custom connector.
- Füge die MCP-Server-URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDein. - Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
- Bitte Muse im Chat um etwas, wofür es die
Aymakan-Tools braucht.
Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:
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
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.
Verfügbare Tools
| 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) |
Beispiel-Prompts
- „Wo sind die Sendungen AY2866494373 und AY2866494374 gerade?“
- „Such die Sendung zu unserer Bestellreferenz 10045 und zeig mir ihren ganzen Statusverlauf.“
- „Welche meiner Sendungen haben diese Woche mehr als einen Zustellversuch gebraucht, und in welchen Städten?“
- „Gib mir ein PDF mit den Labels aller heute angelegten Sendungen, die noch nicht abgeholt wurden.“
- „Welche Abholzeitfenster sind morgen frei, und welche meiner Abholaufträge sind noch offen?“
FAQ
Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.
Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.
Nächste Schritte
War dieser Guide hilfreich?
