Cafe24

io.github.groove79由 GitHub 帳號 groove79 發布v0.2.0更新於 Oct 29, 2026

Cafe24 mall MCP: products, variant stock, orders, board posts. 카페24 쇼핑몰 MCP 서버.

已驗證STDIO僅桌面效率與工作流商業與電商

概覽

AI 產生的概覽

面向 Cafe24 Admin API 的 MCP 伺服器,讓助理在 Cafe24 商城查詢與修改商品、設定規格庫存、讀取訂單並張貼看板文章。

可以做什麼
  • 分頁篩選列出商品,並查看單一商品及其規格、價格與庫存
  • 修改商品名稱、價格、顯示或販售狀態,並設定某個規格的庫存數量
  • 依日期區間列出訂單,含品項、買家與收件人,可依狀態篩選
  • 列出商城看板並張貼文章,內容允許 HTML
適用情境
適合經營 Cafe24 商店、希望助理直接回答商品與近期訂單問題、調整價格或庫存、發布公告與看板文章而不必每次登入後台的情況。
執行需求
透過 npx 以 stdio 在本機執行(需 Node.js)。需在 Cafe24 Developers 建立應用程式,提供 Client ID、Client Secret 與商店 id,並完成一次瀏覽器授權,權杖會存於本機檔案;重新導向 URI 必須是自有網域下的 https 位址。選用變數可預先提供更新權杖、指定 API 版本、商店編號或重新導向 URI,OK Agent 金鑰可啟用 KakaoTalk 核准。
安裝前請注意
需要應用程式的 Client Secret 與更新權杖,存於本機設定檔,且每兩週輪換。商品、庫存與文章寫入不可復原,且直接作用於線上商店;寫入模式預設為核准或聊天確認,但 direct 模式會立即生效。訂單資料包含買家與收件人資訊,選用的 OK Agent 金鑰會將寫入核准經第三方服務傳送。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Cafe24,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@appmonster/mcp-cafe24

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)

  1. 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).
  2. Authorize once (stores a token in ~/.config/kmcp/cafe24/<mall_id>.json):
    bash
    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):

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

ToolAccessWhat it does
cafe24_list_productsreadGET /admin/products with name/display/selling filters
cafe24_get_productreadProduct detail + variants (option codes, stock)
cafe24_update_productwriteName, price, display, selling — only fields you pass
cafe24_update_inventorywriteSet a variant's stock (PUT …/variants/{code}/inventories)
cafe24_list_ordersreadOrders in a date range with items, buyer, receivers
cafe24_list_boardsreadBoards and their numbers
cafe24_create_articlewritePost to a board (notice, blog, Q&A answer)

Write tools carry destructiveHint: true and honour an approveWrite hook.

Example prompts

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

MIT © Appmonster

來源:packages/cafe24/README.md,提交 53af4ba

工具

7

cafe24_list_products

List products in the Cafe24 mall with paging and filters (name, display/selling status, product numbers). 카페24 상품 목록을 조회합니다. Use first to find product_no before reading or changing a product. Needs nothing.

輸入參數limitoffsetdisplaysellingproduct_noproduct_name

cafe24_get_product

Get one product with its variants (options), prices, stock and status by product_no. 상품 상세(옵션·재고 포함)를 조회합니다. Use before cafe24_update_inventory to get variant_code. Needs product_no.

輸入參數product_no必填

cafe24_update_product

Change a product's name, price, display or selling status. Only the fields you pass are changed. 상품의 이름·가격·진열·판매 상태를 수정합니다. IRREVERSIBLE: changes the live store. Needs product_no + at least one field.

輸入參數pricedisplaysellingproduct_no必填product_nameconfirm_token

cafe24_update_inventory

Set the stock quantity of one variant (option) of a product. 옵션(품목) 재고 수량을 변경합니다. IRREVERSIBLE. Needs product_no + variant_code (from cafe24_get_product → variants[].variant_code) + quantity.

輸入參數quantity必填product_no必填variant_code必填confirm_token

cafe24_list_orders

List orders in a date range (default: last 7 days) with items and buyer, optionally filtered by status. 주문 목록을 조회합니다(품목·구매자 포함). Use for 'any new orders?'. Needs nothing; max 3-month range per call.

輸入參數limitoffsetend_datestart_dateorder_status

cafe24_list_boards

List the mall's boards (notice, Q&A, review, free) with their board_no. 게시판 목록을 조회합니다. Use before posting. Needs nothing.

無需輸入參數。

cafe24_create_article

Post an article to a board (e.g. a notice or blog-style post). HTML allowed in content. 게시판에 글을 등록합니다. IRREVERSIBLE: publishes to the live site. Needs board_no (from cafe24_list_boards), title, content.

輸入參數title必填writercontent必填displayboard_no必填confirm_token

版本歷史

2
  1. v0.2.0最新Oct 23, 2026
  2. v0.1.1Oct 21, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分