Cafe24

本地服务

appmonster.co.kr商业与营销06 天前更新

代码仓库访问官网

关于 Cafe24

Cafe24 是连接 Cafe24 Admin API 的 MCP 服务，供商城运营者通过 AI Agent 查询和修改商品、变体库存、订单及公告文章。写入操作可通过人工审批钩子确认。

主要功能

01按条件查询商品
02查看商品详情与变体
03修改商品信息及变体库存
04查询订单与公告板
05向公告板发布文章

适用场景

01检查商品及变体库存
02调整商品价格或展示状态
03查看日期范围内的订单
04发布通知或博客文章

MCP 相关

该服务将 Cafe24 Admin API 的商品、库存、订单和公告板操作作为 MCP 工具提供；写入工具支持人工审批。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "groove79-mcp-cafe24": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-cafe24"
      ],
      "env": {
        "CAFE24_MALL_ID": "<CAFE24_MALL_ID>",
        "CAFE24_CLIENT_ID": "<CAFE24_CLIENT_ID>",
        "CAFE24_CLIENT_SECRET": "<CAFE24_CLIENT_SECRET>",
        "CAFE24_REFRESH_TOKEN": "<CAFE24_REFRESH_TOKEN>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>",
        "KMCP_WRITE_MODE": "<KMCP_WRITE_MODE>"
      }
    }
  }
}

启动命令npx -y @appmonster/mcp-cafe24

需要配置的环境变量

CAFE24_MALL_IDMall id (subdomain of your Cafe24 admin)

CAFE24_CLIENT_IDApp client id from developers.cafe24.com

CAFE24_CLIENT_SECRET密钥App client secret

CAFE24_REFRESH_TOKEN密钥Optional: seed refresh token instead of running `mcp-cafe24 auth`

OKAGENT_API_KEY密钥OK Agent key (free at okagent.kr) — writes then wait for your OK on KakaoTalk. Unset: writes ask for confirmation in the chat first.

KMCP_WRITE_MODEapproval | confirm | direct (default: approval if OKAGENT_API_KEY is set, else confirm)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@appmonster/mcp-cafe240.2.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
limit	integer	否
offset	integer	否
display	enum	否	T = 在商城中显示，F = 隐藏T \| F
selling	enum	否	T = 在售，F = 販売停止T \| F
product_no	array	否	指定的商品编号
product_name	string	否	名称部分匹配

详细介绍

@appmonster/mcp-cafe24

Cafe24 Admin API 的 MCP 服务。让 Claude、Cursor 或 ChatGPT 管理 Cafe24 商城：列出和编辑商品、设置规格库存、读取订单、发布公告——写入操作需经人工批准。

Cafe24 商城 MCP 服务。Agent 可直接处理商品、库存、订单和公告。

一次性设置

在 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）。
授权一次（令牌会保存到 ~/.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
```
系统会打开商城管理后台；点击 동의함；浏览器会跳转到你的重定向 URL，并附带 ?code=…。请在 1 分钟内将该 URL 粘贴回终端。（如果使用 http://localhost 重定向，CLI 会自动捕获授权码——仅限本地开发。）访问令牌有效期为 2 小时，并会自动刷新；刷新令牌会轮换，有效期为 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`	写入	在公告板上发布文章（公告、博客、问答回复）