rakuten-rms-mcp-remote

rakuten-rms-mcp の Remote MCP ホストです。

• Transport: Streamable HTTP（/mcp）

• Auth: OAuth 2.1 + PKCE（共有パスコード）および任意の 静的 Bearer

• ツール実装はコアパッケージを依存として利用（このリポに RMS ロジックは置きません）

Claude.ai / ChatGPT などの「URL を貼る」系クライアント向けです。Cursor のローカル stdio はコア側を使ってください。

必要条件

• Node.js 20+

• RMS の serviceSecret / licenseKey

• 次のどちらか（または両方）

  • RMS_MCP_OAUTH_PASSCODE … OAuth 認可画面の共有パスコード

  • RMS_MCP_API_KEY … Authorization: Bearer … を直接書けるクライアント用

Related MCP server: shopline-mcp

セットアップ

git clone https://github.com/moneyan9/rakuten-rms-mcp-remote.git
cd rakuten-rms-mcp-remote
cp .env.example .env   # 値を編集
npm install
npm run build
npm start

ローカルではコア未公開でも動くように、必要なら package.json の依存を一時的に:

"rakuten-rms-mcp": "file:../rakuten-rms-mcp"

に差し替えて npm install してください。

エンドポイント

ChatGPT / Claude への接続

1. このサーバを HTTPS で公開（Railway / Render / Fly など）

2. ALLOWED_HOSTS に公開ホスト名を入れる（例: my-app.up.railway.app）

3. ChatGPT: Developer Mode → カスタムコネクタに https://…/mcp を追加（OAuth）

4. Claude.ai: Connectors → カスタムコネクタに同様に追加

5. 認可画面で RMS_MCP_OAUTH_PASSCODE を入力

ヘッダを書けるクライアント（一部の MCP クライアント）向け:

{
  "mcpServers": {
    "rakuten-rms": {
      "url": "https://YOUR_HOST/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_RMS_MCP_API_KEY"
      }
    }
  }
}

環境変数

注意: 現状は 1 プロセス = 1 店舗の RMS 鍵（サーバ env）です。個人事業主ごとの鍵分離はまだありません。

Vercel

Express アプリとしてデプロイします（src/app.ts の default export）。

1. このリポを Vercel に Import（または npx vercel）

2. Environment Variables に少なくとも次を設定

   • RMS_SERVICE_SECRET / RMS_LICENSE_KEY

   • RMS_MCP_OAUTH_PASSCODE（自分で決めた共有パスコード）

3. Deploy 後の MCP URL: https://<project>.vercel.app/mcp

4. ChatGPT カスタムコネクタにその URL を追加し、認可画面でパスコードを入力

ALLOWED_HOSTS は任意（未設定でも VERCEL_URL 系を自動許可）。カスタムドメイン利用時は本番ホスト名を追加してください。

OAuth トークンはサーバレス上では原則 /tmp（インスタンス内）。コールドスタートで消えることがあるので、再認可が必要になる場合があります。

開発

npm run typecheck
npm test
npm run build

License

MIT