如何通过 MCP 将 noon payments 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → noon payments、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

noon payments + Cursor

noon payments 支付网关（阿联酋、沙特阿拉伯、埃及）：按订单 ID 或商户参考号查询订单状态，包括已授权、已扣款和已退款总额及交易，定期生成的结算和佣金报表，订阅以及卡令牌。扣款和退款已包含在内，但安装时为关闭状态。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

NOON_PAYMENTS_API_URL, NOON_PAYMENTS_AUTH_KEY

步骤 1 — 获取凭证

设置大约需要 5 分钟。你需要能访问 noon payments 的 Merchant Portal。

1. 在 Merchant Portal 中打开 Account Settings > Applications。新建一个应用或使用已有应用，只授予它需要的角色：查询订单用 Payment Integrator 或 Refund Manager，报表用 Financial Auditor，卡令牌用 Token Manager。
2. 拼出密钥 BusinessIdentifier.ApplicationIdentifier:ApplicationKey：开通邮件中的 business identifier、一个点、application identifier、一个冒号和 application key。将其进行 Base64 编码，例如用 printf '%s' 'mybusiness.myapp:KEY' | base64，然后只把 Base64 文本粘贴到 NOON_PAYMENTS_AUTH_KEY，不要带 Key 这个词。连接器会发送 Authorization: Key <该文本>。
3. 把 NOON_PAYMENTS_API_URL 设为 https://api.noonpayments.com（全球，正式）或 https://api-test.noonpayments.com（测试）。地区端点为 https://api.sa.noonpayments.com 和 https://api.eg.noonpayments.com，测试版本为 https://api-test.sa.noonpayments.com 和 https://api-test.eg.noonpayments.com。只填端点，不带 /payment/v1。每个环境的密钥不同。
4. 安装连接器，用 noon_payments_get_order_by_reference 和商店订单号查询一笔最近的订单，以检查密钥。

订单 ID 和订单参考号：order_id 是发起付款时 noon 返回的数字订单 ID，与商店订单一起保存（通常作为付款交易 ID）。order_reference 是当时发送的你自己的参考号，通常是商店订单号。如果多笔订单共用一个参考号（重试），会返回最新的一笔；用订单 ID 可精确匹配。

可读取的内容：按 ID 或你的参考号查询的订单，包括状态（INITIATED、AUTHORIZED、CAPTURED、PARTIALLY_CAPTURED、REFUNDED、REVERSED、CANCELLED、FAILED、MARKED_FOR_REVIEW 等）、金额和币种、已授权、已扣款、已退款、已撤销和剩余总额、交易（AUTHORIZATION、CAPTURE、REFUND 等，每笔都有状态、金额、时间和 ID）、脱敏后的支付信息和后续操作；noon 按天或按月生成的定期报表，每份都附有下载 ZIP（Excel 或制表符分隔）的限时链接；定期订阅的创建日期、状态、有效期、金额和计划；以及已保存卡令牌背后的脱敏卡信息（卡组织、脱敏卡号、有效期、持卡人、状态）。

如何解读订单：resultCode 为 0 只表示请求成功，并不表示付款成功。AI 会根据订单状态和 nextActions 判断。

对账：ReconciliationSettlement 是每日报表，列出需要与银行结算核对的扣款和退款；ActiveSubscriptions、PaymentTokens、MerchantCommissions 和 MerchantCommissionDetails 为月度报表。对于某一天的结算，AI 会用 report_type ReconciliationSettlement 和该日期列出定期报表，你在链接过期前从 ReportUrl 下载文件。对账时它不会逐笔查询订单，因为 noon 会限制重复查询。

安装时关闭：noon_payments_capture_order（对 AUTHORIZED 订单全额或部分扣款，使资金进入商户账户）和 noon_payments_refund_order（使用订单中 CAPTURE 交易的 ID，把扣款退回客户的卡；无法撤销，需要 Refund Manager 角色）。两者都会动用资金，因此由管理员有意开启。即使开启后，AI 也会先向你展示订单、金额和币种并等待你确认，并传入 transaction_reference，避免重试时重复执行。

限制：没有列出或搜索订单的接口，因此 AI 按 ID 或参考号查询订单，或使用每日报表。卡令牌查询不适合批量运行。

常见错误：失败会以 HTTP 4xx 或 5xx 返回，并带有 resultCode、message 和 classDescription。Rejected_Unauthenticated 表示密钥或环境错误；Rejected_AccessDenied（或 403）表示应用缺少该调用所需的角色；Invalid_BadRequest 指向某个参数。404 通常表示 NOON_PAYMENTS_API_URL 中带了路径，或该环境中不存在这笔订单。429 表示被限流：AI 会等待后再重试，且不会重复同一个失败的请求，因为 noon 可能会锁定订单或封禁地址。

该连接器不会发起付款，不会授权、撤销或取消订单，也不处理欺诈审核。

步骤 2 — 安装 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

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

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

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 noon payments 的工具。

可用工具

示例提示

• “我们商店订单 100245 对应的 noon payments 订单是什么状态？已扣款和已退款分别是多少？”
• “订单 3108459210 是否已全额扣款，还是仍有剩余金额？”
• “从 noon payments 获取昨天的 ReconciliationSettlement 报表，并给我下载链接。”
• “查询这个订阅，告诉我它的状态、金额和计划。”
• “从订单 3108459210 的扣款中退款 75 AED。先给我看订单和金额。”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Gemini
• 连接到 Meta Muse
• 连接到 Microsoft Copilot