noon payments über MCP mit Gemini 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 + Gemini

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

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI 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

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden