Skip to main content
Glama
NSSseta4177

楽楽販売 MCPサーバー

by NSSseta4177
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
JavaScript
Remote

楽楽販売 MCPサーバー

楽楽販売(RAKUS)のAPI連携マニュアル(2025/02, 第15版)に基づき、以下のAPIをClaudeの「カスタムコネクタ」から呼び出せるようにするMCPサーバーです。

  • ファイルアップロード / CSVファイルインポート / CSVデータインポート / CSVインポート状況確認 / CSVエクスポート

  • レコード登録 / 更新 / 削除 / 参照

事前準備(楽楽販売 側)

  1. API連携オプション契約 ＋ IPアクセス制限の設定が必須です(マニュアル1章・5章)。 デプロイ先サーバーの送信元IPを、管理者設定＞セキュリティ設定タブ＞IPアクセス制限に関する設定 で許可してください。 (Renderなど固定IPを持たないPaaSの場合、静的Outbound IPアドオンの利用が必要になることがあります)

  2. ユーザ設定画面でAPIトークンを発行・確定します(マニュアル3章)。

  3. 各DBの「dbSchemaId」「importId」「項目ID」などは、管理者設定＞メンテナンス機能タブ＞APIパラメータ情報 から確認してください。

デプロイ手順(Render・詳細版)

初めてPaaSを使う方向けに、GitHubへのpushからClaudeへの接続まで一気通貫の手順を RENDER_DEPLOY.md にまとめています。まずはこちらをご覧ください。 render.yaml を使ったBlueprintデプロイに対応しています。

要点だけ書くと:

  1. このフォルダをGitHubリポジトリにpush

  2. RenderでBlueprint(render.yaml)からWeb Serviceを作成(プランはstarter以上)

  3. 環境変数に RAKURAKU_DOMAIN / RAKURAKU_ACCOUNT / RAKURAKU_API_TOKEN / MCP_SHARED_SECRET を設定

  4. Settings画面で「Static Outbound IP Addresses」を有効化し、表示された固定IPを楽楽販売のIPアクセス制限に登録

  5. https://<デプロイ先>.onrender.com/mcp をClaudeのコネクタURLとして登録

Render以外(Railway / Fly.io / 自前VPS + PM2 など)でも、Node.js 18以上が動く環境であれば同様の手順でデプロイできます。

Claude側のコネクタ設定

  1. Claude.aiの設定画面で「カスタムコネクタを追加」を開きます。

  2. 各項目を入力します。

    • 名前: 任意(例: 楽楽販売)

    • リモートMCPサーバーURL: https://<デプロイ先>/mcp

    • OAuth Client ID / Secret: 空欄でOK(このサーバーは簡易な共有シークレット方式のため)

  3. MCP_SHARED_SECRET を設定した場合は、コネクタがヘッダ Authorization: Bearer <MCP_SHARED_SECRET> を送信できるように設定してください (現在のClaude.aiのカスタムコネクタUIでは追加ヘッダを直接指定できないことがあります。その場合は MCP_SHARED_SECRET を空にして運用するか、 IPアクセス制限や独自の認証ミドルウェアで保護してください)。

  4. 「追加」をクリックして接続します。

ローカル動作確認

npm install
cp .env.example .env
# .env を編集して RAKURAKU_DOMAIN / RAKURAKU_ACCOUNT / RAKURAKU_API_TOKEN を設定
npm start

別ターミナルから疎通確認:

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

提供ツール一覧

ツール名

対応API

説明

rakuraku_file_upload

ファイルアップロードAPI

一時領域にファイルをアップロード(fileId取得)

rakuraku_csv_file_import

CSVファイルインポートAPI

アップロード済みファイルをインポート予約

rakuraku_csv_data_import

CSVデータインポートAPI

アップロードと予約を同時実行

rakuraku_csv_import_status

CSVインポート状況確認API

インポート進捗・結果確認

rakuraku_csv_export

CSVエクスポートAPI

レコードをCSVで取得

rakuraku_record_create

レコード登録API

レコード新規登録

rakuraku_record_update

レコード更新API

レコード更新(明細行更新含む)

rakuraku_record_delete

レコード削除API

レコード削除

rakuraku_record_get

レコード参照API

レコード1件参照

注意事項

  • レコード登録/更新API等の values に指定する項目ID(例: "105110")は、DBごとに異なります。事前に「APIパラメータ情報」画面で確認し、 Claudeに「このDBの項目IDは〇〇です」と伝えてから操作を依頼してください。

  • 楽楽販売APIには1分間20リクエストの制限があります(マニュアル5章)。大量データを扱う際はご注意ください。

  • RAKURAKU_API_TOKEN は第三者に共有しないでください。デプロイ先の環境変数(Secret)機能を使い、コードやGitリポジトリに直接書かないことを推奨します。