gmo-mulpay-mcp

非公式 — LULL Inc. によるコミュニティ MCP サーバーです。SMBC GMO PAYMENT 株式会社とは無関係です。

SMBCマルチペイメントサービスの開発者向け MCP サーバー。プロトコルタイプ（JSON/idPass）・リンクタイプPlus・OpenAPIタイプに対応。

すべての情報は SMBCマルチペイメント 公式ドキュメント からリアルタイムで取得します。 パッケージ内に API 仕様やエラーコードなどの静的データは含みません。

リポジトリ: https://github.com/lull-project/gmo-mulpay-mcp

使い方

--type 引数で接続タイプを指定します。省略時は protocol-json がデフォルトです。

| --type 値 | 内容 | |------------|------| | protocol-json | プロトコルタイプ JSON（デフォルト） | | protocol-idpass | プロトコルタイプ idPass | | link-plus | リンクタイプPlus | | openapi | OpenAPIタイプ |

Cursor（.cursor/mcp.json または Cursor Settings → MCP）

{
  "mcpServers": {
    "gmo-protocol-json": {
      "command": "npx",
      "args": ["-y", "gmo-mulpay-mcp", "--type=protocol-json"],
      "env": {
        "PATH": "/Users/you/.nvm/versions/node/v22.0.0/bin:/opt/homebrew/bin:/usr/bin:/bin"
      }
    }
  }
}

複数タイプを同時に使う場合:

{
  "mcpServers": {
    "gmo-protocol-json": {
      "command": "npx",
      "args": ["-y", "gmo-mulpay-mcp", "--type=protocol-json"]
    },
    "gmo-protocol-idpass": {
      "command": "npx",
      "args": ["-y", "gmo-mulpay-mcp", "--type=protocol-idpass"]
    },
    "gmo-link-plus": {
      "command": "npx",
      "args": ["-y", "gmo-mulpay-mcp", "--type=link-plus"]
    },
    "gmo-openapi": {
      "command": "npx",
      "args": ["-y", "gmo-mulpay-mcp", "--type=openapi"]
    }
  }
}

環境変数での指定

--type 引数の代わりに SMBC_API_TYPE 環境変数でも指定できます（後方互換で GMO_API_TYPE も可）。

{
  "mcpServers": {
    "gmo-mcp": {
      "command": "npx",
      "args": ["-y", "gmo-mulpay-mcp"],
      "env": {
        "SMBC_API_TYPE": "protocol-json"
      }
    }
  }
}

提供ツール

| ツール | 説明 | |--------|------| | list_doc_pages | 公式ドキュメント全ページ一覧（llms.txt、キーワード絞り込み可） | | list_api_pages | API 一覧（llms-apis.txt、キーワード絞り込み可） | | fetch_doc | 指定ページの内容を取得（topic ショートカットまたは URL） | | list_local_docs | ローカル仕様書ファイル一覧（DOCS_DIR、オプション） | | read_local_doc | ローカル仕様書の読み込み（オプション） |

fetch_doc の topic ショートカット

全 --type 共通:

| topic | 内容 | |-------|------| | introduction-overview | サイト全体の「はじめに」（/docs/introduction/overview） |

プロトコルタイプ JSON（--type=protocol-json）

| topic | 内容 | |-------|------| | intro | APIリファレンスはじめに | | credit | 会員・カード登録（クレカ払い） | | pay | Pay払い（d払いなど） | | bank | 口座直結決済 | | cvs | コンビニ決済 | | postpay | 後払い | | fraud | 不正防止 | | changelog | APPENDIX |

プロトコルタイプ idPass（--type=protocol-idpass）

| topic | 内容 | |-------|------| | intro | はじめに | | credit | クレカ払い | | pay | Pay払い | | bank | 口座払い | | emoney | 電子マネー | | cvs | 現金払い（コンビニ） | | postpay | 後払い | | prepaid | プリペイド | | fraud | 不正防止 | | common | 共通 | | changelog | APPENDIX |

リンクタイプPlus（--type=link-plus）

| topic | 内容 | |-------|------| | overview | リンクタイプPlus概要（接続方式） | | api | APIでURL生成（キー型URL） | | common-parameters | 共通パラメータ仕様 | | errorcode | エラーコード一覧 | | authentication | 本人認証 | | card-edit | カード編集機能 | | notification | 結果通知（Webhook） | | iframe | iframeタグの利用 | | 3ds | 3DS2.0 認証必須項目 | | credit | クレジットカード決済仕様 | | cvs | コンビニ決済仕様 | | paypay | PayPay決済仕様 | | parameter-type | パラメータ型URL生成 | | test-environment | テスト環境情報 |

introduction-overview（サイト全体のはじめに）と overview（リンクタイプPlus概要）は別ページです。

OpenAPIタイプ（--type=openapi）

| topic | 内容 | |-------|------| | overview | 概要 | | request-spec | リクエスト仕様 | | auth | 認証・セキュリティ | | webhook | コールバック Webhook | | operations | オペレーション・バージョニング | | error | エラー仕様 | | flow-credit | クレジット決済フロー | | flow-wallet | ウォレット決済フロー | | flow-cash | 現金決済フロー | | flow-deferred | 後払いフロー | | flow-verify | 本人確認フロー | | changelog | 変更履歴 |

ローカル仕様書の活用（オプション）

管理画面からダウンロードした公式仕様書 PDF をテキスト変換して配置すると、エージェントが参照できます。

pdftotext spec.pdf /path/to/docs/spec.txt

{
  "mcpServers": {
    "gmo-protocol-json": {
      "command": "npx",
      "args": ["-y", "gmo-mulpay-mcp", "--type=protocol-json"],
      "env": {
        "DOCS_DIR": "/path/to/your/docs"
      }
    }
  }
}

開発

npm install
npm run build
npm start -- --type=protocol-json

免責事項

• 本パッケージは非公式のコミュニティプロジェクトです。SMBC GMO PAYMENT 株式会社とは無関係です。
• 情報の正確性・最新性は必ず 公式サイト でご確認ください。
• 本サーバーは公式ドキュメントへのアクセスを行います。短時間に大量のリクエストを送らないでください。

セキュリティ

脆弱性の報告は GitHub Issues からお願いします。

License

MIT — Copyright (c) LULL Inc.