Come collegare noon payments a Claude via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → noon payments, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

noon payments + Claude

noon payments, il gateway di pagamento per Emirati Arabi Uniti, Arabia Saudita ed Egitto: stato degli ordini per id ordine o riferimento del merchant con totali autorizzati, catturati e rimborsati e transazioni, report programmati di liquidazione e commissioni, abbonamenti e token delle carte. Cattura e rimborso sono inclusi, ma disattivati all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

NOON_PAYMENTS_API_URL, NOON_PAYMENTS_AUTH_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti serve l'accesso al Merchant Portal di noon payments.

1. Nel Merchant Portal apri Account Settings > Applications. Crea un'application, o usane una esistente, con solo i ruoli che le servono: Payment Integrator o Refund Manager per consultare gli ordini, Financial Auditor per i report, Token Manager per i token delle carte.
2. Costruisci la chiave BusinessIdentifier.ApplicationIdentifier:ApplicationKey: il business identifier dell'e-mail di attivazione, un punto, l'application identifier, i due punti e l'application key. Codificala in Base64, per esempio con printf '%s' 'mybusiness.myapp:KEY' | base64, e incolla solo il testo Base64 in NOON_PAYMENTS_AUTH_KEY, senza la parola Key. Il connettore invia Authorization: Key <quel testo>.
3. Imposta NOON_PAYMENTS_API_URL su https://api.noonpayments.com (globale, produzione) o https://api-test.noonpayments.com (test). Gli endpoint regionali sono https://api.sa.noonpayments.com e https://api.eg.noonpayments.com, con le varianti di test https://api-test.sa.noonpayments.com e https://api-test.eg.noonpayments.com. Solo l'endpoint, senza /payment/v1. Le chiavi cambiano a seconda dell'ambiente.
4. Installa il connettore e cerca un ordine recente con noon_payments_get_order_by_reference e il numero d'ordine del negozio per verificare la chiave.

Id ordine e riferimento ordine: order_id è l'id numerico che noon ha restituito all'avvio del pagamento, salvato con l'ordine del negozio (spesso come id della transazione di pagamento). order_reference è il tuo riferimento inviato in quel momento, di solito il numero d'ordine del negozio. Se più ordini condividono un riferimento (nuovi tentativi), viene restituito il più recente; l'id ordine dà una corrispondenza esatta.

Cosa legge: un ordine per id o per tuo riferimento, con stato (INITIATED, AUTHORIZED, CAPTURED, PARTIALLY_CAPTURED, REFUNDED, REVERSED, CANCELLED, FAILED, MARKED_FOR_REVIEW e altri), importo e valuta, i totali autorizzati, catturati, rimborsati, stornati e residui, le transazioni (AUTHORIZATION, CAPTURE, REFUND e altre, ognuna con stato, importo, ora e id), i dati di pagamento mascherati e le azioni successive; i report programmati che noon ha generato per un giorno o un mese, ciascuno con un link a tempo per scaricare lo ZIP (Excel o separato da tabulazioni); un abbonamento ricorrente con data di creazione, stato, validità, importo e calendario; e la carta mascherata dietro un token di carta salvato (circuito, numero mascherato, scadenza, titolare, stato).

Leggere un ordine: resultCode 0 significa solo che la richiesta è andata a buon fine, non che il pagamento sia riuscito. L'AI giudica in base allo stato dell'ordine e a nextActions.

Riconciliazione: ReconciliationSettlement è un report giornaliero delle catture e dei rimborsi da riconciliare con l'accredito bancario; ActiveSubscriptions, PaymentTokens, MerchantCommissions e MerchantCommissionDetails sono mensili. Per la liquidazione di un giorno l'AI elenca i report programmati con report_type ReconciliationSettlement e quel giorno, e tu scarichi il file da ReportUrl prima che il link scada. Per la riconciliazione non scorre gli ordini uno per uno, perché noon limita le interrogazioni ripetute.

Disattivati all'installazione: noon_payments_capture_order (cattura un ordine AUTHORIZED in tutto o in parte, così i fondi passano sul conto del merchant) e noon_payments_refund_order (rimborsa una cattura sulla carta del cliente, usando l'id della transazione CAPTURE dell'ordine; non si può annullare e richiede il ruolo Refund Manager). Entrambi muovono denaro, quindi un amministratore li attiva deliberatamente. Anche allora l'AI ti mostra ordine, importo e valuta e aspetta il tuo sì, e passa un transaction_reference perché un nuovo tentativo non venga eseguito due volte.

Limiti: non esiste un endpoint per elencare o cercare gli ordini, quindi l'AI li cerca per id o riferimento, oppure usa i report giornalieri. Le consultazioni dei token delle carte non sono pensate per elaborazioni massive.

Errori comuni: gli errori tornano come HTTP 4xx o 5xx con resultCode, message e classDescription. Rejected_Unauthenticated indica chiave o ambiente sbagliati; Rejected_AccessDenied (o 403) indica che all'application manca il ruolo per quella chiamata; Invalid_BadRequest indica un parametro. 404 di solito significa che NOON_PAYMENTS_API_URL contiene un percorso, o che l'ordine non esiste in questo ambiente. 429 significa limitazione: l'AI aspetta prima di riprovare e non ripete la stessa richiesta fallita, perché noon può bloccare l'ordine o bandire l'indirizzo.

Il connettore non avvia pagamenti, non autorizza, storna o annulla ordini e non gestisce la revisione antifrode.

Step 2 — Installa l'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

Step 3 — Aggiungi il connettore in Claude

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca + e poi Add custom connector.
3. Inserisci un nome, ad esempio noon payments, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.

Tool disponibili

Esempi di prompt

• "Qual è lo stato dell'ordine noon payments del nostro ordine 100245, e quanto è stato catturato e rimborsato?"
• "L'ordine 3108459210 è stato catturato per intero, o resta ancora un importo?"
• "Prendi il report ReconciliationSettlement di ieri da noon payments e dammi il link per scaricarlo."
• "Cerca questo abbonamento e dimmi stato, importo e calendario."
• "Rimborsa 75 AED della cattura sull'ordine 3108459210. Prima mostrami ordine e importo."

FAQ

Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Landing del connettore
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot