インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、noon payments をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
UAE、サウジアラビア、エジプト向けの決済ゲートウェイ noon payments に対応します。注文 ID または加盟店の参照番号による注文ステータス（オーソリ済み、キャプチャ済み、返金済みの合計とトランザクション）、定期生成される精算レポートと手数料レポート、サブスクリプション、カードトークンを扱えます。キャプチャと返金も含まれますが、インストール時はオフです。
こう聞いてみよう
noon payments のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → noon payments をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
noon payments + Microsoft Copilot
UAE、サウジアラビア、エジプト向けの決済ゲートウェイ noon payments に対応します。注文 ID または加盟店の参照番号による注文ステータス（オーソリ済み、キャプチャ済み、返金済みの合計とトランザクション）、定期生成される精算レポートと手数料レポート、サブスクリプション、カードトークンを扱えます。キャプチャと返金も含まれますが、インストール時はオフです。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
NOON_PAYMENTS_API_URL, NOON_PAYMENTS_AUTH_KEY
ステップ 1 — 認証情報を取得
セットアップは約 5 分です。noon payments の Merchant Portal へのアクセスが必要です。
- Merchant Portal で Account Settings > Applications を開きます。必要なロールだけを持つアプリケーションを作成するか、既存のものを使います。注文の照会には Payment Integrator または Refund Manager、レポートには Financial Auditor、カードトークンには Token Manager です。
- キー
BusinessIdentifier.ApplicationIdentifier:ApplicationKeyを組み立てます。セットアップメールにある business identifier、ドット、application identifier、コロン、application key の順です。これを Base64 でエンコードし（例:printf '%s' 'mybusiness.myapp:KEY' | base64）、Key という語を付けずに Base64 のテキストだけをNOON_PAYMENTS_AUTH_KEYに貼り付けます。コネクタはAuthorization: Key <そのテキスト>を送ります。 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は付けません。キーは環境ごとに異なります。- コネクタをインストールし、
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 — Microsoft Copilot にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name（例:
AnythingMCP）、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
noon paymentsのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
noon_payments_get_order | Get a noon payments order by its order id: order status (INITIATED, AUTHORIZED, CAPTURED, PARTIALLY_CAPTURED, REFUNDED, REVERSED… |
noon_payments_get_order_by_reference | Get a noon payments order by your own order reference (order.reference sent at INITIATE, e.g. the shop order number) with the same details… |
noon_payments_list_scheduled_reports | List the scheduled reports noon generated for a day or month, each with ReportName, ReportType and a time-limited ReportUrl to download the… |
noon_payments_get_subscription | Get a recurring subscription by its identifier: creation date, status, validity, amount and schedule |
noon_payments_get_card_token | Get the masked card behind a saved card token (brand, masked number, expiry, holder name, status) |
noon_payments_capture_order | Capture an AUTHORIZED order in full or in part so the funds move to the merchant account |
noon_payments_refund_order | Refund a captured order in full or in part back to the customer card |
プロンプトの例
- 「ショップの注文 100245 に対応する noon payments の注文のステータスと、キャプチャ済みと返金済みの額を教えてください。」
- 「注文 3108459210 は全額キャプチャされましたか？それともまだ残額がありますか？」
- 「noon payments から昨日の ReconciliationSettlement レポートを取得して、ダウンロードリンクをください。」
- 「この定期購読を調べて、ステータス、金額、スケジュールを教えてください。」
- 「注文 3108459210 のキャプチャから 75 AED を返金してください。先に注文と金額を見せてください。」
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?