noon payments über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → noon payments klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

noon payments + Cursor

noon payments, das Payment-Gateway für VAE, Saudi-Arabien und Ägypten: Bestellstatus über Bestell-ID oder Händlerreferenz mit autorisierten, gecaptureten und erstatteten Summen und Transaktionen, geplante Abrechnungs- und Provisionsberichte, Abonnements und Karten-Tokens. Capture und Erstattung sind enthalten, aber bei der Installation 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:

NOON_PAYMENTS_API_URL, NOON_PAYMENTS_AUTH_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst Zugang zum Merchant Portal von noon payments.

1. Öffne im Merchant Portal Account Settings > Applications. Leg eine Application an, oder nimm eine bestehende, mit nur den Rollen, die sie braucht: Payment Integrator oder Refund Manager für Bestellabfragen, Financial Auditor für Berichte, Token Manager für Karten-Tokens.
2. Bau den Key BusinessIdentifier.ApplicationIdentifier:ApplicationKey: den Business Identifier aus der Einrichtungs-E-Mail, einen Punkt, den Application Identifier, einen Doppelpunkt und den Application Key. Kodiere ihn in Base64, zum Beispiel mit printf '%s' 'mybusiness.myapp:KEY' | base64, und füge nur den Base64-Text in NOON_PAYMENTS_AUTH_KEY ein, ohne das Wort Key. Der Connector sendet Authorization: Key <dieser Text>.
3. Setz NOON_PAYMENTS_API_URL auf https://api.noonpayments.com (global, live) oder https://api-test.noonpayments.com (Test). Die regionalen Endpunkte sind https://api.sa.noonpayments.com und https://api.eg.noonpayments.com, mit den Testvarianten https://api-test.sa.noonpayments.com und https://api-test.eg.noonpayments.com. Nur der Endpunkt, ohne /payment/v1. Die Keys unterscheiden sich je Umgebung.
4. Installiere den Connector und schlag mit noon_payments_get_order_by_reference und der Bestellnummer des Shops eine aktuelle Bestellung nach, um den Key zu prüfen.

Bestell-ID und Bestellreferenz: order_id ist die numerische Bestell-ID, die noon beim Start der Zahlung zurückgegeben hat und die bei der Shop-Bestellung gespeichert ist (oft als Transaktions-ID der Zahlung). order_reference ist deine eigene Referenz, die dabei mitgeschickt wurde, meist die Bestellnummer des Shops. Teilen sich mehrere Bestellungen eine Referenz (Wiederholungen), kommt die neueste zurück; die Bestell-ID trifft genau.

Was er liest: eine Bestellung über ihre ID oder deine Referenz, mit Status (INITIATED, AUTHORIZED, CAPTURED, PARTIALLY_CAPTURED, REFUNDED, REVERSED, CANCELLED, FAILED, MARKED_FOR_REVIEW und weitere), Betrag und Währung, den autorisierten, gecaptureten, erstatteten, stornierten und offenen Summen, den Transaktionen (AUTHORIZATION, CAPTURE, REFUND und weitere, jeweils mit Status, Betrag, Zeit und ID), den maskierten Zahlungsdaten und den nächsten Aktionen; die geplanten Berichte, die noon für einen Tag oder Monat erzeugt hat, jeweils mit einem befristeten Link zum Herunterladen des ZIP (Excel oder tabulatorgetrennt); ein wiederkehrendes Abonnement mit Erstellungsdatum, Status, Gültigkeit, Betrag und Zahlungsplan; und die maskierte Karte hinter einem gespeicherten Karten-Token (Marke, maskierte Nummer, Ablaufdatum, Karteninhaber, Status).

Eine Bestellung lesen: resultCode 0 heißt nur, dass die Anfrage funktioniert hat, nicht dass die Zahlung erfolgreich war. Die KI urteilt nach dem Bestellstatus und nextActions.

Abgleich: ReconciliationSettlement ist ein täglicher Bericht der Captures und Erstattungen, die mit der Bankabrechnung abzugleichen sind; ActiveSubscriptions, PaymentTokens, MerchantCommissions und MerchantCommissionDetails sind monatlich. Für die Abrechnung eines Tages listet die KI die geplanten Berichte mit report_type ReconciliationSettlement und diesem Tag, und du lädst die Datei über ReportUrl herunter, bevor der Link abläuft. Für den Abgleich geht sie nicht Bestellung für Bestellung durch, weil noon wiederholtes Abfragen drosselt.

Bei der Installation deaktiviert: noon_payments_capture_order (captured eine AUTHORIZED-Bestellung ganz oder teilweise, damit das Geld auf das Händlerkonto geht) und noon_payments_refund_order (erstattet einen Capture auf die Karte des Kunden zurück, mit der CAPTURE-Transaktions-ID aus der Bestellung; lässt sich nicht rückgängig machen und braucht die Rolle Refund Manager). Beide bewegen Geld, deshalb schaltet ein Administrator sie bewusst ein. Auch dann zeigt dir die KI Bestellung, Betrag und Währung und wartet auf dein Ja, und sie übergibt eine transaction_reference, damit eine Wiederholung nicht doppelt ausgeführt wird.

Limits: Es gibt keinen Endpunkt, um Bestellungen aufzulisten oder zu suchen; die KI schlägt sie über ID oder Referenz nach oder nimmt die täglichen Berichte. Abfragen von Karten-Tokens sind nicht für Massenläufe gedacht.

Häufige Fehler: Fehler kommen als HTTP 4xx oder 5xx mit resultCode, message und classDescription zurück. Rejected_Unauthenticated bedeutet einen falschen Key oder die falsche Umgebung; Rejected_AccessDenied (oder 403) heißt, dass der Application die Rolle für diesen Aufruf fehlt; Invalid_BadRequest weist auf einen Parameter hin. 404 heißt meist, dass NOON_PAYMENTS_API_URL einen Pfad enthält oder die Bestellung in dieser Umgebung nicht existiert. 429 bedeutet Drosselung: Die KI wartet, bevor sie es erneut versucht, und wiederholt nicht dieselbe fehlschlagende Anfrage, weil noon die Bestellung sperren oder die Adresse blockieren kann.

Der Connector startet keine Zahlungen, autorisiert, reversiert oder storniert keine Bestellungen und übernimmt keine Betrugsprüfung.

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 noon payments-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welchen Status hat die noon-payments-Bestellung zu unserer Shop-Bestellung 100245, und wie viel davon ist gecaptured und erstattet?“
• „Wurde Bestellung 3108459210 vollständig gecaptured, oder ist noch ein Betrag offen?“
• „Hol den ReconciliationSettlement-Bericht von gestern aus noon payments und gib mir den Download-Link.“
• „Schlag dieses Abonnement nach und sag mir Status, Betrag und Zahlungsplan.“
• „Erstatte 75 AED vom Capture der Bestellung 3108459210. Zeig mir vorher Bestellung und Betrag.“

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
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden