Cafe24

@appmonster/mcp-cafe24

Cafe24 Admin API 用の MCP サーバーです。Claude、Cursor、ChatGPT から Cafe24 モールを管理できます。商品一覧の取得・編集、バリエーション在庫の設定、注文の確認、掲示板への記事投稿が可能です。書き込み時には人による承認が必要です。

Cafe24 ショッピングモール用 MCP サーバーです。エージェントが商品・在庫・注文・掲示板を直接扱います。

セットアップ（初回のみ）

1. Cafe24 Developers でアプリを作成します（Cafe24 モールアカウントでログイン → パートナー 가입 → App 관리 → ADD PRODUCT → Web）。
   • Redirect URI には、自分が管理するドメインの https:// を指定する必要があります。Cafe24 は http:// と IP アドレスを拒否します。404 になるページでもかまいません。コードはアドレスバーに届きます（例：https://yourdomain.com/cafe24/callback）。
   • 권한선택 (쇼핑몰 운영자)：商品・注文・掲示板 → 読み取り＋書き込み、店舗 → 読み取り。タイムゾーンは Asia/Seoul に設定します。保存します。
   • Client ID と Client Secret Key（인증정보 → 보기）を控えてください。mall id は管理画面のサブドメインです（{mall_id}.cafe24.com）。
2. 一度認証します（トークンは ~/.config/kmcp/cafe24/<mall_id>.json に保存されます）。

   CAFE24_MALL_ID=yourmall CAFE24_CLIENT_ID=... CAFE24_CLIENT_SECRET=... \
   CAFE24_REDIRECT_URI=https://yourdomain.com/cafe24/callback npx -y @appmonster/mcp-cafe24 auth
   

   モールの管理画面が開くので、동의함 をクリックします。ブラウザーは ?code=… が付いたリダイレクト URL に移動します。その URL を1分以内にターミナルに貼り付けてください。http://localhost のリダイレクトを使う場合は、CLI が自動的に受け取ります（ローカル開発専用）。 アクセストークンの有効期間は2時間で、自動的に更新されます。リフレッシュトークンはローテーションされ、有効期間は2週間です。その期間を超えてサーバーを使わなかった場合は、再度 auth を実行してください。

実際のモールで動作を確認済みです（2026-10）：商品、バリエーション、在庫の書き込み、注文、掲示板、トークンの更新ローテーション。書き込みはすぐに反映されますが、約1～2秒以内に読み取ると、古い値が表示される場合があります。

インストール

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "cafe24": {
      "command": "npx",
      "args": ["-y", "@appmonster/mcp-cafe24"],
      "env": {
        "CAFE24_MALL_ID": "yourmall",
        "CAFE24_CLIENT_ID": "your-client-id",
        "CAFE24_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

任意の環境変数：CAFE24_REFRESH_TOKEN（ブラウザー手順を省略してトークンを設定）、CAFE24_API_VERSION（デフォルトは 2026-09-01。Cafe24 がこのバージョンの提供を終了した場合、クライアントはエラーで Cafe24 が指定するバージョンに切り替えて処理を続行します）、CAFE24_SHOP_NO（デフォルトは1）、CAFE24_REDIRECT_URI。

ツール

ツール	アクセス	説明
cafe24_list_products	読み取り	商品名・表示・販売状況のフィルターを使って GET /admin/products を実行します
cafe24_get_product	読み取り	商品の詳細とバリエーション（オプションコード、在庫）を取得します
cafe24_update_product	書き込み	商品名、価格、表示、販売状況を更新します。指定したフィールドのみが対象です
cafe24_update_inventory	書き込み	バリエーションの在庫を設定します（PUT …/variants/{code}/inventories）
cafe24_list_orders	読み取り	指定した期間の注文を、商品、購入者、受取人の情報とともに取得します
cafe24_list_boards	読み取り	掲示板とその番号を取得します
cafe24_create_article	書き込み	掲示板に投稿します（お知らせ、ブログ、Q&A の回答）

書き込みツールには destructiveHint: true が設定され、approveWrite フックに従って動作します。

プロンプトの例

• 「이번 주 신규 주문 몇 건이야? 미발송 건만 보여줘」
• 「'전동 드릴' 상품 가격을 89,000원으로 바꿔줘」
• 「공지사항 게시판에 추석 배송 안내 올려줘」

MIT © Appmonster