OK Agent

카페24 MCP 서버 — 카페24 쇼핑몰 AI 관리

카페24 Admin API를 MCP로 연결해, AI 에이전트가 상품 조회·수정, 옵션 재고 변경, 주문 조회, 게시판 글 작성을 할 수 있게 해 주는 무료 오픈소스 서버입니다. 토큰은 자동으로 갱신됩니다.

@appmonster/mcp-cafe24무료 · MIT 오픈소스GitHub →

무엇을 할 수 있나

도구하는 일
cafe24_list_products상품 목록
cafe24_get_product상품 상세
cafe24_update_product상품 정보 수정결재 필요
cafe24_update_inventory옵션(품목) 재고 변경결재 필요
cafe24_list_orders주문 조회
cafe24_list_boards게시판 목록
cafe24_create_article게시판 글 작성결재 필요

설치 (1분)

Node.js 20 이상이 필요합니다. 따로 내려받을 것 없이 npx가 실행할 때 가져옵니다.

Claude Desktop · Cursor · Windsurf

MCP 설정 파일(claude_desktop_config.json, .cursor/mcp.json 등)에 넣습니다.

{
  "mcpServers": {
    "cafe24": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-cafe24"
      ],
      "env": {
        "CAFE24_MALL_ID": "…",
        "CAFE24_CLIENT_ID": "…",
        "CAFE24_CLIENT_SECRET": "…"
      }
    }
  }
}

Claude Code

claude mcp add cafe24 -e CAFE24_MALL_ID=… -e CAFE24_CLIENT_ID=… -e CAFE24_CLIENT_SECRET=… -- npx -y @appmonster/mcp-cafe24

리프레시 토큰은 2주 동안 쓰지 않으면 만료되므로, 오래 쉬었다면 auth를 다시 실행하세요.

필요한 키와 발급처

필수
CAFE24_MALL_ID — 쇼핑몰 아이디(관리자 주소의 서브도메인)
필수
CAFE24_CLIENT_ID — 앱 Client ID
필수
CAFE24_CLIENT_SECRET — 앱 Client Secret
선택
CAFE24_REFRESH_TOKEN — 선택: auth 명령 대신 직접 넣는 리프레시 토큰

발급: 카페24 개발자센터. 앱을 만들어 Client ID/Secret을 받은 뒤, 처음 한 번 `npx -y @appmonster/mcp-cafe24 auth`로 쇼핑몰 권한을 연결합니다.

이렇게 시켜 보세요

쓰기 작업은 사람이 결재합니다

상품 정보 수정, 옵션(품목) 재고 변경, 게시판 글 작성은(는) 되돌리기 어려운 작업이라 바로 실행되지 않습니다. 기본으로는 바뀔 내용을 먼저 보여주고 대화창에서 확인을 받습니다. 설정에 OKAGENT_API_KEY를 넣으면 승인 요청이 휴대폰 카카오톡으로 와서, 자리를 비워도 탭 한 번으로 승인하거나 거부할 수 있고 기록도 남습니다.

카카오로 무료 시작OK Agent 알아보기월 200건 무료 · 카드 등록 없음

자주 묻는 질문

카페24 앱 심사가 필요한가요?

본인 쇼핑몰에서만 쓰는 비공개 앱이면 개발자센터에서 앱을 만들어 바로 테스트할 수 있습니다.

토큰이 계속 만료되지 않나요?

액세스 토큰(2시간)은 서버가 자동 갱신합니다. 리프레시 토큰은 2주간 미사용 시 만료되니 그때만 auth를 다시 실행하면 됩니다.

상품 수정도 바로 되나요?

수정·재고 변경·게시글 작성은 쓰기 도구라 실행 전에 확인을 받습니다. OK Agent를 연결하면 카카오톡 승인 후 실행됩니다.

함께 쓰면 좋은 서버