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 分