MCP 経由で noon payments を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → noon payments をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

noon payments + Cursor

UAE、サウジアラビア、エジプト向けの決済ゲートウェイ noon payments に対応します。注文 ID または加盟店の参照番号による注文ステータス（オーソリ済み、キャプチャ済み、返金済みの合計とトランザクション）、定期生成される精算レポートと手数料レポート、サブスクリプション、カードトークンを扱えます。キャプチャと返金も含まれますが、インストール時はオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

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）、Key という語を付けずに Base64 のテキストだけを NOON_PAYMENTS_AUTH_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 は繰り返しの照会を制限するため、照合のために注文を 1 件ずつ照会することはしません。

インストール時はオフ: noon_payments_capture_order（AUTHORIZED の注文を全額または一部キャプチャし、資金を加盟店口座に移す）と noon_payments_refund_order（注文の CAPTURE トランザクション ID を使い、キャプチャ分を顧客のカードに返金。取り消しはできず、Refund Manager ロールが必要）です。どちらもお金が動くため、管理者が意図的にオンにします。オンにした後も、AI は注文、金額、通貨を示してあなたの同意を待ち、再試行が二重に実行されないよう transaction_reference を渡します。

制限: 注文を一覧表示または検索するエンドポイントはないため、AI は ID か参照番号で照会するか、日次レポートを使います。カードトークンの照会は大量処理向けではありません。

よくあるエラー: 失敗は resultCode、message、classDescription を含む HTTP 4xx または 5xx で返ります。Rejected_Unauthenticated はキーまたは環境の誤り、Rejected_AccessDenied（または 403）はアプリケーションにその呼び出しのロールがないこと、Invalid_BadRequest はパラメータの問題を示します。404 はたいてい NOON_PAYMENTS_API_URL にパスが含まれているか、その環境に注文が存在しないことを意味します。429 はスロットリングです。noon が注文をロックしたりアドレスを遮断したりすることがあるため、AI は再試行の前に待ち、失敗したのと同じリクエストを繰り返しません。

このコネクタは、決済の開始、注文のオーソリ、取り消し、キャンセル、不正審査は行いません。

ステップ 2 — アダプターをインストール

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 サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Gemini に接続
• Meta Muse に接続
• Microsoft Copilot に接続