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 "Install 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-mcpWhat 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 をほぼ網羅)
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(店舗)
問い合わせ返信を使う場合は、あわせて 店舗 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 でも起動できます(現状はローカルビルドを推奨)。
環境変数
変数 | 必須 | 説明 |
| はい | アプリの 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
Maintenance
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
AlicenseAqualityCmaintenanceOfficial remote MCP server for Color Me Shop (GMO Pepabo). Manage orders, products, customers, coupons, and inventory of your online store through natural language.Last updated491MIT- AlicenseAqualityCmaintenanceMCP server for managing WooCommerce stores through AI assistants like Claude. Provides 101 tools covering products, orders, customers, coupons, shipping, taxes, webhooks, settings, reports, and more.Last updated1001031MIT
- AlicenseAqualityBmaintenanceAn 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.Last updated10019MIT
- AlicenseCqualityCmaintenanceMCP Server for the LINE Shopping API, enabling AI agents and tools to interact with LINE Shopping data and operations via the Model Context Protocol.Last updated2223MIT
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
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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