Nexi XPay

nexi-xpay-mcp-server

Nexi XPay Back Office API用のMCP サーバーです。AI アシスタント（Claude、Cursor など）が、Nexi XPay加盟店アカウントの注文、取引の詳細、警告／異常、および決済方法を照会できるようにします。

ツール

ツール	説明
list_orders	フィルター（日付範囲、チャネル、ステータス、取引コード）を指定して注文を一覧表示します
order_details	特定の取引の詳細を表示します
warnings	警告／異常を取得します（デフォルト：過去7日間）
payment_methods	加盟店で有効な決済方法を一覧表示します

前提条件

• Python >= 3.10
• Back Office API にアクセスできる Nexi XPay加盟店アカウント
• API 認証情報：Alias、API Key、Secret Key（Nexi Back Office から取得）

インストール

uvx nexi-xpay-mcp-server

.mcp.json での使用方法

MCP 設定ファイル（Claude Code の場合は .mcp.json、Claude Desktop の場合は claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "nexi": {
      "command": "uvx",
      "args": ["nexi-xpay-mcp-server"],
      "env": {
        "NEXI_ALIAS": "your_alias",
        "NEXI_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

複数の加盟店

加盟店ごとに異なるキーを使用して、インスタンスを1つずつ起動します。

{
  "mcpServers": {
    "nexi-acme": {
      "command": "uvx",
      "args": ["nexi-xpay-mcp-server"],
      "env": {
        "NEXI_ALIAS": "acme_merchant",
        "NEXI_SECRET_KEY": "acme_secret_key"
      }
    },
    "nexi-globex": {
      "command": "uvx",
      "args": ["nexi-xpay-mcp-server"],
      "env": {
        "NEXI_ALIAS": "globex_merchant",
        "NEXI_SECRET_KEY": "globex_secret_key"
      }
    }
  }
}

環境変数

変数	必須	デフォルト	説明
NEXI_ALIAS	はい	—	加盟店のエイリアス（API キーとしても使用）
NEXI_SECRET_KEY	はい	—	MAC 計算用のシークレットキー
NEXI_TEST	いいえ	false	テスト環境を使用するには true に設定します

開発

git clone https://github.com/stucchi/nexi-xpay-mcp-server.git
cd nexi-xpay-mcp-server
uv sync

ローカルでの実行：

NEXI_ALIAS=your_alias NEXI_SECRET_KEY=your_secret uv run nexi-xpay-mcp-server

ライセンス

MIT