Skip to main content
Glama
rakuten-rms-mcp
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 をほぼ網羅)

  • ライブラリ利用: createServer() などを export(Remote MCP ラッパーから再利用可)

ChatGPT 本体から使う場合は、別途 HTTPS の Remote MCP が必要です(npm 公開だけでは足りません)。HTTP / OAuth 本体は別リポ(例: rakuten-rms-mcp-remote)に置き、本パッケージはツール実装の供給側にします。


できること

領域

例

受注運用

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

売上の把握

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

商品

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

在庫

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

クーポン

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

問い合わせ

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

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


Related MCP server: MCP Shopline

必要条件

  • Node.js 20 以上

  • RMS WEB SERVICE で発行した

    • serviceSecret(アプリ)

    • licenseKey(店舗)

  • 問い合わせ返信を使う場合は、あわせて 店舗 ID(RMS_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 でも起動できます(現状はローカルビルドを推奨)。

ライブラリとして使う(Remote ラッパー向け)

stdio を起動せず、ツール登録済みの McpServer だけ欲しい場合:

import { createServer, hasCredentials } from 'rakuten-rms-mcp';

const server = createServer(); // HTTP transport は呼び出し側で接続

公開 API(package.json の exports["."]):

export

説明

createServer

全 rms_* ツールを登録した MCP サーバを生成

createApis

RMS API クライアント一式

loadConfig / hasCredentials

環境変数から認証情報を読む

ローカル開発で未公開の本リポを参照する場合の例: "rakuten-rms-mcp": "file:../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.json の mcpServers に同様に追加

接続確認はツール 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

Available Tools

58 tools
rms_all_productsList all productsC

全商品の管理番号・商品名・価格の一覧を取得

Inputs: include_variants.

rms_bulk_get_inventoryBulk get inventoryD

在庫一括取得

Inputs: inventories (required).

rms_bulk_get_inventory_rangeBulk get inventory by rangeC

在庫数範囲での一括取得

Inputs: max_quantity, min_quantity.

rms_bulk_get_productsBulk get productsD

商品一括取得(items.bulk.get)

Inputs: manage_numbers (required).

rms_cancel_orderCancel orderA

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

Inputs: order_number (required), cancel_reason.

rms_cancel_order_after_shippingCancel order after shippingD

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

Inputs: order_number (required).

rms_cancel_rateCancel rateC

キャンセル率・件数

Inputs: end_date, start_date.

rms_confirm_orderConfirm ordersA

受注確認(注文確認待ち→楽天処理中へ進める)。バルク対応。

Inputs: order_numbers (required).

rms_daily_salesDaily sales summaryB

日別売上サマリー(件数・税・クーポン・送料)

Inputs: end_date, start_date.

rms_delete_couponDelete couponD

クーポン削除

Inputs: coupon_code (required).

rms_delete_productDelete productC

商品削除(items.delete)

Inputs: manage_number (required).

rms_delete_variant_inventoryDelete variant inventoryD

バリアント在庫削除

Inputs: variant_id (required), manage_number (required).

rms_get_couponGet couponC

クーポン個別取得

Inputs: coupon_code (required).

rms_get_inventoryGet inventoryB

指定商品の在庫情報を取得

Inputs: item_urls (required).

rms_get_order_itemsGet order itemsC

購入商品API: getOrderItem(公式リクエストボディをそのまま渡す)

Inputs: body (required).

rms_get_paymentGet paymentD

決済情報取得(getPayment)

Inputs: order_number (required).

rms_get_productGet productC

商品取得(items.get)

Inputs: manage_number (required).

rms_get_shipping_async_resultGet shipping async resultB

発送完了報告(非同期)の処理結果確認

Inputs: assertion_token (required).

rms_get_sub_status_listSub status listB

サブステータス一覧取得

Inputs: no named parameters.

rms_get_variant_inventoryGet variant inventoryD

バリアント在庫取得

Inputs: variant_id (required), manage_number (required).

rms_get_variant_listsGet variant listsC

商品のバリアント一覧(在庫)取得

Inputs: manage_number (required).

rms_healthRMS MCP health checkA

Check whether this MCP server can start and whether RMS credentials are present in the environment.

Inputs: no named parameters.

rms_inquiriesInquiry managementC

問い合わせ管理(件数確認・一覧・詳細・返信・既読・完了・未完了)

Inputs: action (required), page, limit, message, +6 more.

rms_inquiry_attachment_getGet inquiry attachmentD

問い合わせ添付ファイル取得

Inputs: path (required), label.

rms_inquiry_attachment_postUpload inquiry attachmentC

問い合わせ添付ファイル登録

Inputs: body (required).

rms_issue_couponIssue couponC

新規クーポンを発行する

Inputs: coupon_name (required), discount_type (required), coupon_end_date (required), discount_factor (required), +4 more.

rms_order_detailOrder detailA

注文番号指定で全詳細JSON

Inputs: order_numbers (required).

rms_patch_couponPatch couponC

クーポン部分更新(XML IF)

Inputs: fields (required).

rms_patch_productPatch productC

商品部分更新(items.patch)。patch_data に更新フィールドを指定。

Inputs: patch_data (required), manage_number (required).

rms_pending_shippingPending shippingC

発送待ち注文一覧(配送番号未登録のもの)

Inputs: end_date, start_date.

rms_product_rankingProduct rankingB

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

Inputs: top_n, end_date, start_date.

rms_search_couponsSearch couponsC

クーポン検索(発行済みクーポンの一覧)

Inputs: hits, page, coupon_name.

rms_search_order_itemsSearch order itemsD

購入商品API: searchOrderItem

Inputs: limit, end_date, date_type, start_date, +1 more.

rms_search_ordersSearch ordersC

受注検索(searchOrder)。注文番号リストを返す。

Inputs: end_date (required), start_date (required), date_type, progress_list.

rms_search_productsSearch productsC

商品検索(管理番号・商品名・ジャンルで絞り込み可)

Inputs: offset, genre_id, item_url, search_type.

rms_simulate_coupon_amountSimulate coupon amountC

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

Inputs: coupon_model (required).

rms_thanks_coupon_getGet thanks couponC

サンキュークーポン取得

Inputs: thanks_coupon_id (required).

rms_thanks_coupon_issueIssue thanks couponC

サンキュークーポン発行

Inputs: body (required).

rms_thanks_coupon_stopStop thanks couponD

サンキュークーポン停止

Inputs: thanks_coupon_id (required).

rms_thanks_coupon_updateUpdate thanks couponD

サンキュークーポン更新

Inputs: body (required), thanks_coupon_id (required).

rms_unconfirmed_ordersUnconfirmed ordersB

未確認(注文確認待ち)の注文一覧

Inputs: end_date, start_date.

rms_update_couponUpdate couponC

クーポン更新(XML IF)。fields にクーポン要素を渡す。

Inputs: fields (required).

rms_update_deliveryUpdate deliveryC

配送方法/お届け先情報更新

Inputs: delivery (required), order_number (required).

rms_update_inventoryUpdate inventoryB

在庫数を更新(バリアント単位、ABSOLUTE絶対値設定)

Inputs: updates (required).

rms_update_memoUpdate order memoC

注文メモ更新(店舗側内部メモ)

Inputs: memo (required), order_number (required).

rms_update_ordererUpdate ordererC

注文者情報更新

Inputs: orderer (required), order_number (required).

rms_update_priceUpdate product priceB

商品価格を変更(セール価格の設定・復元に使用)

Inputs: price (required), variant_id (required), manage_number (required).

rms_update_remarksUpdate order remarksC

備考情報更新(購入者に表示される備考)

Inputs: remarks (required), order_number (required).

rms_update_senderUpdate sender (before shipping)B

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

Inputs: sender (required), order_number (required).

rms_update_sender_after_shippingUpdate sender (after shipping)C

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

Inputs: sender (required), order_number (required).

rms_update_shippingUpdate shippingC

配送情報更新(配送業者・追跡番号の登録)。basketIdが必要。

Inputs: basket_id (required), order_number (required), shipping_list (required).

rms_update_shipping_asyncUpdate shipping asyncC

発送完了報告(非同期)。models は公式 IF の updateOrderShippingModels 形式。

Inputs: models (required).

rms_update_sub_statusUpdate sub statusC

サブステータス更新(出荷準備中・確認済み等)

Inputs: order_status_list (required).

rms_upsert_productUpsert productB

商品を新規登録または更新(管理番号でupsert)。title / price / genre などを指定。

Inputs: title (required), manage_number (required), tagline, genre_id, +5 more.

rms_upsert_variant_inventoryUpsert variant inventoryD

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

Inputs: quantity (required), variant_id (required), manage_number (required), mode.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.1/5.0

    Scored across 58 tools

    Disambiguation3/5

    Several tools have overlapping purposes, such as multiple inventory retrieval methods (rms_get_inventory, rms_get_variant_inventory, rms_bulk_get_inventory, rms_get_variant_lists) and product update methods (rms_update_price, rms_patch_product, rms_upsert_product). The rms_inquiries tool bundles count/list/detail/reply/read/complete operations into one, creating significant ambiguity for agents. While descriptions are clear, the sheer number of similar tools makes selection error-prone.

    Naming Consistency2/5

    Naming conventions are mixed: most tools follow a verb_noun pattern (e.g., rms_get_product, rms_update_orderer), but some place the verb at the end (rms_thanks_coupon_get, rms_inquiry_attachment_post). Noun-only names like rms_health and rms_inquiries, and adjective-noun names like rms_daily_sales, further break consistency. The irregular placement of actions across similar functions makes tool names unpredictable.

    Tool Count1/5

    With 58 tools, the server's tool count is excessively high, far beyond the typical range for an MCP server and making agent tool selection unwieldy. The broad domain coverage does not justify this count, as many tools could be consolidated (e.g., the inquiry operations could be split into separate tools or grouped). This is an extreme mismatch with recommended server scoping.

    Completeness4/5

    The server provides comprehensive coverage of core lifecycles for orders, products, inventory, coupons, and inquiries, including create, read, update, delete, and search operations. Notable features like payment info retrieval, shipping updates (sync and async), and analytics tools are present. Minor gaps exist (e.g., no explicit return/refund management), but overall the surface is well-rounded and functional.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Official remote MCP server for Color Me Shop (GMO Pepabo). Manage orders, products, customers, coupons, and inventory of your online store through natural language.
      49
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An open-source MCP server that wraps the Shopline Open API into 143 AI-callable tools for e-commerce data analysis, enabling AI agents to query orders, products, inventory, customer behavior, and promotions from Shopline stores through natural language.
      100
      21
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for the Shopline Open API. Exposes 140+ tools for querying and managing orders, products, customers, promotions, analytics, and store settings from your Shopline store via Claude.
      100
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      An MCP server that exposes marketplace seller operations (Shopee first) as tools Claude can call, enabling automation of product, pricing, inventory, customer service, and other seller tasks.
      32
      -