MCP server for the Cafe24 Admin API. Lets Claude, Cursor or ChatGPT manage a Cafe24 mall: list and edit products, set variant stock, read orders, post board articles — with human approval on writes.

카페24 쇼핑몰 MCP 서버. 에이전트가 상품·재고·주문·게시판을 직접 다룹니다.

Setup (one time)

Create an app at Cafe24 Developers (log in with your Cafe24 mall account → 파트너 가입 → App 관리 → ADD PRODUCT → Web).
- Redirect URI must be https:// on a domain you control — Cafe24 rejects http:// and IPs. Any page works, even one that 404s: the code arrives in the address bar (e.g. https://yourdomain.com/cafe24/callback).
- 권한선택 (쇼핑몰 운영자): 상품·주문·게시판 → 읽기+쓰기, 상점 → 읽기. 타임존 Asia/Seoul. 저장.
- Note the Client ID and Client Secret Key (인증정보 → 보기); your mall id is the subdomain of your admin ({mall_id}.cafe24.com).
Authorize once (stores a token in ~/.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
```
It opens the mall admin; click 동의함; the browser lands on your redirect URL with ?code=…. Paste that URL back into the terminal within 1 minute. (With an http://localhost redirect the CLI catches it automatically — local dev only.) Access tokens last 2 h and refresh themselves; the refresh token rotates and lasts 2 weeks, so if the server goes unused longer than that, run auth again.

Verified live against a real mall (2026-10): products, variants, inventory write, orders, boards, token refresh rotation. Writes are applied immediately but a read within ~1–2 s may still show the old value.

Install

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"
      }
    }
  }
}

Optional env: CAFE24_REFRESH_TOKEN (seed a token without the browser step), CAFE24_API_VERSION (default 2026-09-01; if Cafe24 retires it the client switches to the version Cafe24 names in its error and continues), CAFE24_SHOP_NO (default 1), CAFE24_REDIRECT_URI.

Tools

Tool	Access	What it does
`cafe24_list_products`	read	`GET /admin/products` with name/display/selling filters
`cafe24_get_product`	read	Product detail + variants (option codes, stock)
`cafe24_update_product`	write	Name, price, display, selling — only fields you pass
`cafe24_update_inventory`	write	Set a variant's stock (`PUT …/variants/{code}/inventories`)
`cafe24_list_orders`	read	Orders in a date range with items, buyer, receivers
`cafe24_list_boards`	read	Boards and their numbers
`cafe24_create_article`	write	Post to a board (notice, blog, Q&A answer)