Cómo conectar noon payments a Microsoft Copilot vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → noon payments, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

noon payments + Microsoft Copilot

noon payments, la pasarela de pago para Emiratos Árabes Unidos, Arabia Saudí y Egipto: estado de pedidos por id de pedido o referencia del comercio con totales autorizados, capturados y reembolsados y transacciones, reportes programados de liquidación y comisiones, suscripciones y tokens de tarjeta. Captura y reembolso están incluidos, pero desactivados al instalar.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

NOON_PAYMENTS_API_URL, NOON_PAYMENTS_AUTH_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas acceso al Merchant Portal de noon payments.

1. En el Merchant Portal abre Account Settings > Applications. Crea una application, o usa una existente, solo con los roles que necesita: Payment Integrator o Refund Manager para consultar pedidos, Financial Auditor para los reportes, Token Manager para los tokens de tarjeta.
2. Arma la clave BusinessIdentifier.ApplicationIdentifier:ApplicationKey: el business identifier del correo de alta, un punto, el application identifier, dos puntos y la application key. Codifícala en Base64, por ejemplo con printf '%s' 'mybusiness.myapp:KEY' | base64, y pega solo el texto Base64 en NOON_PAYMENTS_AUTH_KEY, sin la palabra Key. El conector envía Authorization: Key <ese texto>.
3. Define NOON_PAYMENTS_API_URL como https://api.noonpayments.com (global, producción) o https://api-test.noonpayments.com (prueba). Los endpoints regionales son https://api.sa.noonpayments.com y https://api.eg.noonpayments.com, con las variantes de prueba https://api-test.sa.noonpayments.com y https://api-test.eg.noonpayments.com. Solo el endpoint, sin /payment/v1. Las claves son distintas en cada entorno.
4. Instala el conector y consulta un pedido reciente con noon_payments_get_order_by_reference y el número de pedido de la tienda para comprobar la clave.

Id de pedido y referencia de pedido: order_id es el id numérico que noon devolvió al iniciar el pago, guardado con el pedido de la tienda (a menudo como id de transacción del pago). order_reference es tu propia referencia enviada en ese momento, normalmente el número de pedido de la tienda. Si varios pedidos comparten una referencia (reintentos), se devuelve el más reciente; el id de pedido da una coincidencia exacta.

Qué lee: un pedido por su id o por tu referencia, con su estado (INITIATED, AUTHORIZED, CAPTURED, PARTIALLY_CAPTURED, REFUNDED, REVERSED, CANCELLED, FAILED, MARKED_FOR_REVIEW y otros), monto y moneda, los totales autorizados, capturados, reembolsados, revertidos y pendientes, las transacciones (AUTHORIZATION, CAPTURE, REFUND y otras, cada una con estado, monto, hora e id), los datos de pago enmascarados y las siguientes acciones; los reportes programados que noon generó para un día o un mes, cada uno con un enlace temporal para descargar el ZIP (Excel o separado por tabulaciones); una suscripción recurrente con fecha de creación, estado, vigencia, monto y calendario; y la tarjeta enmascarada detrás de un token de tarjeta guardado (marca, número enmascarado, vencimiento, titular, estado).

Leer un pedido: resultCode 0 solo significa que la solicitud funcionó, no que el pago se completara. La IA juzga por el estado del pedido y nextActions.

Conciliación: ReconciliationSettlement es un reporte diario de las capturas y los reembolsos que hay que conciliar con la liquidación bancaria; ActiveSubscriptions, PaymentTokens, MerchantCommissions y MerchantCommissionDetails son mensuales. Para la liquidación de un día, la IA lista los reportes programados con report_type ReconciliationSettlement y ese día, y tú descargas el archivo desde ReportUrl antes de que caduque el enlace. Para conciliar no recorre los pedidos uno por uno, porque noon limita las consultas repetidas.

Desactivadas al instalar: noon_payments_capture_order (captura un pedido AUTHORIZED total o parcialmente para que los fondos pasen a la cuenta del comercio) y noon_payments_refund_order (reembolsa una captura a la tarjeta del cliente, con el id de la transacción CAPTURE del pedido; no se puede deshacer y requiere el rol Refund Manager). Ambas mueven dinero, así que un administrador las activa a propósito. Incluso entonces la IA te muestra el pedido, el monto y la moneda y espera tu sí, y pasa un transaction_reference para que un reintento no se ejecute dos veces.

Límites: no hay un endpoint para listar o buscar pedidos, así que la IA los consulta por id o referencia, o usa los reportes diarios. Las consultas de tokens de tarjeta no están pensadas para procesos masivos.

Errores comunes: los fallos vuelven como HTTP 4xx o 5xx con resultCode, message y classDescription. Rejected_Unauthenticated significa una clave o un entorno incorrectos; Rejected_AccessDenied (o 403) significa que a la application le falta el rol para esa llamada; Invalid_BadRequest apunta a un parámetro. 404 suele indicar que NOON_PAYMENTS_API_URL lleva una ruta, o que el pedido no existe en este entorno. 429 significa limitación: la IA espera antes de reintentar y no repite la misma solicitud fallida, porque noon puede bloquear el pedido o vetar la dirección.

El conector no inicia pagos, no autoriza, revierte ni cancela pedidos y no gestiona la revisión antifraude.

Paso 2 — Instalar el 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

Paso 3 — Añadir el conector en Microsoft Copilot

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de noon payments.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

Ejemplos de prompts

• "¿En qué estado está el pedido de noon payments de nuestro pedido 100245, y cuánto se ha capturado y reembolsado?"
• "¿Se capturó por completo el pedido 3108459210, o aún queda un monto pendiente?"
• "Trae el reporte ReconciliationSettlement de ayer de noon payments y dame el enlace de descarga."
• "Consulta esta suscripción y dime su estado, monto y calendario."
• "Reembolsa 75 AED de la captura del pedido 3108459210. Muéstrame antes el pedido y el monto."

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse