Skip to main content
Glama
moneyan9
by moneyan9

rakuten-rms-mcp

楽天市場 RMS(RMS WEB SERVICE)の公式 API を、AI から使えるようにする Model Context Protocol(MCP)サーバです。

  • 言語: TypeScript

  • SDK: MCP TypeScript SDK v2@modelcontextprotocol/server

  • 接続方式: いまは stdio(Cursor / Claude Desktop 向け)

  • 対象 API: 受注・購入商品・商品・在庫・クーポン・問い合わせ(公式 IF をほぼ網羅)

ChatGPT 本体から使う場合は、別途 HTTPS の Remote MCP が必要です(npm 公開だけでは足りません)。


できること

領域

受注運用

注文検索、確認、発送報告、メモ/備考、キャンセル、決済情報

売上の把握

日別売上、商品ランキング、キャンセル率

商品

検索、取得、登録/更新、価格変更、削除

在庫

バリアント単位の取得・更新・一括操作

クーポン

検索・発行・更新・削除、サンキュークーポン

問い合わせ

件数・一覧・詳細・返信・既読/完了、添付

認証は RMS の ESA 方式です(Authorization: ESA Base64(serviceSecret:licenseKey))。


Related MCP server: mcp-server-woocommerce

必要条件

  • Node.js 20 以上

  • RMS WEB SERVICE で発行した

    • serviceSecret(アプリ)

    • licenseKey(店舗)

  • 問い合わせ返信を使う場合は、あわせて 店舗 IDRMS_SHOP_ID

キーの取得・アプリ登録は、RMS の「WEB SERVICE」メニュー(サービス一覧・アプリ登録)を参照してください。


インストール

git clone https://github.com/moneyan9/rakuten-rms-mcp.git
cd rakuten-rms-mcp
npm install
npm run build

将来 npm に公開されたあとは、npx -y rakuten-rms-mcp でも起動できます(現状はローカルビルドを推奨)。


環境変数

変数

必須

説明

RMS_SERVICE_SECRET

はい

アプリの serviceSecret

RMS_LICENSE_KEY

はい

店舗の licenseKey

RMS_SHOP_ID

返信時

問い合わせ返信 API で使う数値の店舗 ID

サンプルは .env.example にあります。Secret / Key を Git にコミットしないでください。


Cursor / Claude Desktop への接続

ローカルで動かす例:

{
  "mcpServers": {
    "rakuten-rms": {
      "command": "node",
      "args": ["/絶対パス/rakuten-rms-mcp/dist/index.js"],
      "env": {
        "RMS_SERVICE_SECRET": "your_service_secret",
        "RMS_LICENSE_KEY": "your_license_key",
        "RMS_SHOP_ID": "123456"
      }
    }
  }
}
  • Cursor: MCP 設定に上記を追加

  • Claude Desktop: claude_desktop_config.jsonmcpServers に同様に追加

接続確認はツール rms_health(認証環境変数の有無チェック)が便利です。


ツール一覧

ツール名はすべて rms_ で始まります。日付は基本的に YYYY-MM-DD です(省略時は今日基準のデフォルト)。

受注・購入商品

ツール

説明

rms_search_orders

受注検索。条件に合う注文番号リストを返す

rms_order_detail

注文番号から注文詳細を取得

rms_get_payment

決済情報を取得

rms_confirm_order

受注確認(確認待ち → 楽天処理中)

rms_update_shipping

発送完了報告(同期)

rms_update_shipping_async

発送完了報告(非同期・大量向け)

rms_get_shipping_async_result

非同期発送の処理結果を確認

rms_get_sub_status_list

サブステータス定義の一覧

rms_update_sub_status

サブステータスを更新

rms_update_memo

店舗側のひとことメモを更新

rms_update_remarks

購入者向け備考を更新

rms_update_sender

送付先情報を更新(発送前)

rms_update_sender_after_shipping

送付先情報を更新(発送後)

rms_update_orderer

注文者情報を更新

rms_update_delivery

配送/お届け先情報を更新

rms_cancel_order

注文キャンセル(発送前)

rms_cancel_order_after_shipping

注文キャンセル(発送後)

rms_simulate_coupon_amount

クーポン利用額のシミュレーション

rms_unconfirmed_orders

注文確認待ち(progress=100)の一覧

rms_pending_shipping

発送待ち(progress=300)の一覧

rms_search_order_items

購入商品 API: 検索

rms_get_order_items

購入商品 API: 詳細取得

売上集計(Order API の結果を集計)

専用の「売上 API」はなく、受注データをこのサーバ側で集計します。

ツール

説明

rms_daily_sales

日別の件数・売上・税・クーポン・送料

rms_product_ranking

商品別の数量・売上・平均単価ランキング

rms_cancel_rate

期間内のキャンセル件数と率

商品(ItemAPI 2.0)

ツール

説明

rms_search_products

商品検索(ページ単位)

rms_all_products

全商品をページング取得して一覧化

rms_get_product

管理番号で 1 商品を取得

rms_bulk_get_products

複数管理番号の一括取得

rms_upsert_product

商品の新規登録/更新(upsert)

rms_patch_product

商品の部分更新

rms_update_price

バリアント価格の変更(よく使う PATCH の短縮形)

rms_delete_product

商品削除

rms_get_inventory_related_settings

在庫関連設定の取得

rms_update_inventory_related_settings

在庫関連設定の更新

在庫(InventoryAPI 2.1)

ツール

説明

rms_get_inventory

指定商品のバリアント在庫を一覧

rms_get_variant_inventory

バリアント 1 件の在庫取得

rms_upsert_variant_inventory

バリアント在庫の更新(単体)

rms_delete_variant_inventory

バリアント在庫の削除

rms_update_inventory

在庫の一括更新(ABSOLUTE)

rms_bulk_get_inventory

在庫の一括取得

rms_bulk_get_inventory_range

在庫数の範囲指定で一括取得

rms_get_variant_lists

商品のバリアント一覧取得

クーポン(CouponAPI / ThanksCoupon)

通常クーポンは XML IF、サンキュークーポンは REST 形式です。

ツール

説明

rms_search_coupons

クーポン検索

rms_get_coupon

クーポンコードで取得

rms_issue_coupon

クーポン発行

rms_update_coupon

クーポン更新

rms_patch_coupon

クーポン部分更新

rms_delete_coupon

クーポン削除

rms_thanks_coupon_issue

サンキュークーポン発行

rms_thanks_coupon_update

サンキュークーポン更新

rms_thanks_coupon_stop

サンキュークーポン停止

rms_thanks_coupon_get

サンキュークーポン取得

rms_thanks_coupon_search

サンキュークーポン検索

問い合わせ(InquiryManagementAPI)

ツール

説明

rms_inquiries

action で操作を切替: count / list / detail / reply / mark_read / mark_complete / mark_incomplete

rms_inquiry_attachment_post

添付ファイルの登録

rms_inquiry_attachment_get

添付ファイルの取得

reply には shop_id 引数、または環境変数 RMS_SHOP_ID が必要です。

その他

ツール

説明

rms_health

サーバ起動と認証環境変数の設定有無を確認


開発コマンド

npm run typecheck   # 型チェック
npm test            # 単体テスト
npm run build       # dist へビルド
npm start           # stdio で MCP サーバ起動

注意事項

  • 本リポジトリは 非公式 です。楽天の仕様変更に追随できない場合があります。

  • 書き込み系ツール(キャンセル、削除、価格変更など)は本番店舗に影響します。先にテスト店舗での確認を推奨します。

  • QPS 制限や公式 IF の制約は、RMS WEB SERVICE の各 IF 定義に従ってください。

  • ChatGPT Developer Mode 向けの Remote MCP(HTTP)は未実装です。


ライセンス

MIT

Install Server
A
license - permissive license
C
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.

  • Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.

  • MCP server for AI dialogue using various LLM models via AceDataCloud

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/moneyan9/rakuten-rms-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server