Aymakan über MCP mit Cursor verbinden

💡 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 + Cursor

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.

1. Melde dich im Aymakan-Kunden-Dashboard an.
2. Öffne Technical → AyMakan API und kopiere den API-Schlüssel (den Security Code).
3. Füge ihn genau so in AYMAKAN_API_KEY ein, ohne das Wort Bearer.
4. Installiere den Connector und rufe aymakan_ping auf: logged_in muss Yes zeigen.

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 Cursor 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 Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Aymakan-Tools aufrufen.

Verfügbare Tools

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

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden