rakuten-rms-mcp
Provides integration with Rakuten RMS (Rakuten Market Store Management System) to manage orders, products, inventory, coupons, and inquiries via the official WEB SERVICE APIs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@rakuten-rms-mcp What were today's total sales?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 | 説明 |
| 全 |
| RMS API クライアント一式 |
| 環境変数から認証情報を読む |
ローカル開発で未公開の本リポを参照する場合の例: "rakuten-rms-mcp": "file:../rakuten-rms-mcp"。
環境変数
変数 | 必須 | 説明 |
| はい | アプリの serviceSecret |
| はい | 店舗の licenseKey |
| 返信時 | 問い合わせ返信 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 です(省略時は今日基準のデフォルト)。
受注・購入商品
ツール | 説明 |
| 受注検索。条件に合う注文番号リストを返す |
| 注文番号から注文詳細を取得 |
| 決済情報を取得 |
| 受注確認(確認待ち → 楽天処理中) |
| 発送完了報告(同期) |
| 発送完了報告(非同期・大量向け) |
| 非同期発送の処理結果を確認 |
| サブステータス定義の一覧 |
| サブステータスを更新 |
| 店舗側のひとことメモを更新 |
| 購入者向け備考を更新 |
| 送付先情報を更新(発送前) |
| 送付先情報を更新(発送後) |
| 注文者情報を更新 |
| 配送/お届け先情報を更新 |
| 注文キャンセル(発送前) |
| 注文キャンセル(発送後) |
| クーポン利用額のシミュレーション |
| 注文確認待ち(progress=100)の一覧 |
| 発送待ち(progress=300)の一覧 |
| 購入商品 API: 検索 |
| 購入商品 API: 詳細取得 |
売上集計(Order API の結果を集計)
専用の「売上 API」はなく、受注データをこのサーバ側で集計します。
ツール | 説明 |
| 日別の件数・売上・税・クーポン・送料 |
| 商品別の数量・売上・平均単価ランキング |
| 期間内のキャンセル件数と率 |
商品(ItemAPI 2.0)
ツール | 説明 |
| 商品検索(ページ単位) |
| 全商品をページング取得して一覧化 |
| 管理番号で 1 商品を取得 |
| 複数管理番号の一括取得 |
| 商品の新規登録/更新(upsert) |
| 商品の部分更新 |
| バリアント価格の変更(よく使う PATCH の短縮形) |
| 商品削除 |
| 在庫関連設定の取得 |
| 在庫関連設定の更新 |
在庫(InventoryAPI 2.1)
ツール | 説明 |
| 指定商品のバリアント在庫を一覧 |
| バリアント 1 件の在庫取得 |
| バリアント在庫の更新(単体) |
| バリアント在庫の削除 |
| 在庫の一括更新(ABSOLUTE) |
| 在庫の一括取得 |
| 在庫数の範囲指定で一括取得 |
| 商品のバリアント一覧取得 |
クーポン(CouponAPI / ThanksCoupon)
通常クーポンは XML IF、サンキュークーポンは REST 形式です。
ツール | 説明 |
| クーポン検索 |
| クーポンコードで取得 |
| クーポン発行 |
| クーポン更新 |
| クーポン部分更新 |
| クーポン削除 |
| サンキュークーポン発行 |
| サンキュークーポン更新 |
| サンキュークーポン停止 |
| サンキュークーポン取得 |
| サンキュークーポン検索 |
問い合わせ(InquiryManagementAPI)
ツール | 説明 |
|
|
| 添付ファイルの登録 |
| 添付ファイルの取得 |
reply には shop_id 引数、または環境変数 RMS_SHOP_ID が必要です。
その他
ツール | 説明 |
| サーバ起動と認証環境変数の設定有無を確認 |
開発コマンド
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 toolsrms_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_searchSearch thanks couponsD
サンキュークーポン検索
Inputs: query.
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
Scored across 58 tools
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 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.
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.
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
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.
Hosted Shopify MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted Magento MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
AlicenseAqualityDmaintenanceOfficial remote MCP server for Color Me Shop (GMO Pepabo). Manage orders, products, customers, coupons, and inventory of your online store through natural language.491MIT- AlicenseAqualityDmaintenanceAn 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.10021MIT
- AlicenseAqualityDmaintenanceMCP 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.100MIT
- FlicenseAqualityCmaintenanceAn 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-