🧾 Kash MCP 서버

Kash MCP 서버는 2011년부터 수천 명의 상인이 신뢰해 온 무료 클라우드 기반 POS, 인보이스 발행, CRM 및 웹샵 플랫폼인 **Kash**를 위한 공식 Model Context Protocol (MCP) 서버입니다.

Kash 계정을 Claude, ChatGPT, n8n 또는 MCP 호환 AI에 연결하여 자연스러운 대화를 통해 비즈니스 전체를 관리하세요.

🟢 호스팅 서버: https://mcp.kash.click
📖 전체 문서: kash.click/cash-register-software

✨ 수행 가능한 작업

그저 대화하세요. 메뉴도, 클릭도 필요 없습니다.

"Record a sale of 2 coffees and 1 croissant at table 84"
"Show me this week's revenue report"
"Add a new item called Summer Tart at €4.50 in the Pastries department"
"Who are my best customers this month?"
"Create a Kash account for my restaurant"
"Record the card payment for order #1042"
"Add a Large size option to the Size variation"

Related MCP server: Itcons.app MCP Server

🚀 기능

🔐 계정 및 인증 — 설정 불필요

• 생성: 대화 중에 직접 새로운 Kash 계정 생성

• 목록: 이메일에 연결된 계정을 나열하여 기존 계정 존재 여부 확인

• OTP 로그인: 이메일로 일회용 비밀번호가 전송되므로 비밀번호가 필요 없음

• 로그아웃: 언제든지 세션 종료

🧾 판매 및 주문

• 판매 기록: 카탈로그 항목, 부서 라인 또는 자유 라인을 사용하여 판매 기록

• 주문 편집: 항목 추가, 고객 지정, 결제 기록, 인보이스로 검증

• 주문 목록: 날짜 범위, 검증 여부, 배송 방법별 필터링을 통한 주문 목록 조회

• 주문 상세 정보: 항목, 고객, 결제 및 합계에 대한 전체 내역 확인

📊 보고서

• 판매 보고서: 특정 일, 월 또는 전체 연도(기본값은 어제) 등 모든 기간에 대한 HTML 요약

📦 카탈로그 관리

• 항목 (PLU): 가격, 부서, VAT, 바코드, 재고, 변형 등을 포함하여 추가, 편집, 삭제

• 부서: VAT, 가격, 그룹, 변형 등을 포함하여 추가, 편집, 삭제

• 부서 그룹: 카탈로그 정리를 위해 추가, 편집, 삭제

• VAT 요율: 추가, 편집, 삭제

• 변형: 추가, 편집, 삭제 (예: "사이즈", "색상")

• 변형 선택지: 추가, 편집, 삭제 (예: "사이즈"에 대한 "S", "M", "L") 및 선택적 가격 차이 설정

👥 고객 관리 (CRM)

• 추가, 편집, 삭제: 전체 연락처 정보, 회사 세부 정보, VAT 번호, 바코드, 로열티 데이터, 개인 메모, 블랙리스트 상태 등을 포함한 고객 관리

📋 데이터 및 목록

상점에서 참조 데이터를 검색합니다:

🛠 사용 가능한 도구 (46)

⚙️ 필수 조건

Kash / free-cash-register.net 계정이 필요합니다.

계정이 없으신가요? account.create를 사용하여 대화 중에 직접 생성하거나 kash.click/free-pos-software에서 등록할 수 있습니다.

이미 계정이 있으신가요? 소프트웨어의 **설정 → 웹 서비스(Setup → Webservices)**에서 APIKEY와 SHOPID를 검색하거나 oAuth를 사용하여 연결하세요.

🔌 옵션 1 — 호스팅 서버 (권장)

가장 쉬운 방법: https://mcp.kash.click/mcp의 호스팅된 MCP 서버에 직접 연결합니다.

설치가 필요 없습니다. 인증은 PKCE를 사용하는 OAuth 2.0을 통해 처리됩니다.

Claude.ai

**설정 → 통합(Settings → Integrations)**에서 새 커넥터를 추가하세요:

ChatGPT

**설정 → 커넥터 → 커넥터 생성(Settings → Connectors → Create Connector)**에서:

Smithery

smithery.ai에서 이용 가능합니다 — Kash를 검색하세요.

💻 옵션 2 — 자체 호스팅 (STDIO)

Claude Desktop 또는 모든 STDIO 기반 MCP 클라이언트를 위해 서버를 로컬에서 실행하세요.

npx를 통한 빠른 시작

npx caisse-enregistreuse-mcp-server --shopid=YOUR_SHOPID --apikey=YOUR_APIKEY

Claude Desktop 설정

claude_desktop_config.json을 편집하세요:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "kash": {
      "command": "npx",
      "args": [
        "caisse-enregistreuse-mcp-server",
        "--shopid=YOUR_SHOPID",
        "--apikey=YOUR_APIKEY"
      ]
    }
  }
}

또는 환경 변수 사용:

{
  "mcpServers": {
    "kash": {
      "command": "node",
      "args": ["PATH_TO_BUILD/build/stdio.js"],
      "cwd": "PATH_TO_BUILD",
      "env": {
        "SHOPID": "YOUR_SHOPID",
        "APIKEY": "YOUR_APIKEY"
      }
    }
  }
}

소스에서 설치

# 1) Clone
git clone https://github.com/paracetamol951/caisse-enregistreuse-mcp-server.git
cd caisse-enregistreuse-mcp-server

# 2) Install dependencies
npm install

# 3) Create .env
echo "SHOPID=YOUR_SHOPID" > .env
echo "APIKEY=YOUR_APIKEY" >> .env

# 4) Build
npm run build

# 5) Run
node build/stdio.js

Docker (HTTP 모드)

HTTP 모드는 Redis가 필요합니다. Docker Compose를 사용하세요:

docker compose up

또는 수동으로 실행:

docker run -d -p 6379:6379 redis
npm run dev

🔐 인증 흐름

호스팅 서버 (OAuth)

Claude.ai, ChatGPT 또는 Smithery를 통해 연결하면 OAuth 2.0 + PKCE 흐름에 의해 인증이 자동으로 처리됩니다.

대화 내 인증 (OTP)

대화 내에서 직접 인증할 수도 있습니다 — 비밀번호가 필요 없습니다:

1. auth.request.otp(email)         → OTP sent to your inbox
2. auth.login.with_otp(email, otp) → session initialized ✓
3. auth.logout()                   → clear session when done

아직 계정이 없는 경우:

1. account.list(email)             → check existing accounts
2. account.create(email, title)    → create + session auto-initialized ✓

STDIO / 자체 호스팅

CLI 인수 또는 환경 변수(SHOPID 및 APIKEY)를 통해 자격 증명을 전달하세요.

📡 API 엔드포인트

🌍 국제화

도구 제목과 설명은 영어와 프랑스어로 제공되며, Accept-Language 헤더 또는 MCP_LANG 환경 변수에서 자동으로 결정됩니다.

로케일 파일: locales/en/common.json, locales/fr/common.json

데모 자격 증명

계정을 만들지 않고 도구를 사용해 보려면 다음 자격 증명을 사용할 수 있습니다

로그인: Demo15 비밀번호: demodemo

💻 호환 클라이언트

🏪 지원되는 비즈니스 유형

account.create로 계정을 생성할 때 configType을 사용하여 비즈니스에 맞춘 데이터 세트를 미리 로드하세요:

Bar · Bakery · Restaurant · Fast-food · Cafe · Coffee-shop · Pizzeria · Brewery · Food-truck · Snack · Florist · Retail · Pharmacy · Supermarket · Clothing-store · Ecommerce · Services · Beauty-institute · Coiffeur · Market · Library · Camping · 등...

🔗 링크

• 🌐 웹사이트: kash.click

• 📖 문서: kash.click/cash-register-software

• 🔧 API 참조: kash.click/cash-register-software/mcp

• 🆓 무료 등록: kash.click/free-pos-software

📋 라이선스

© 2025 Net-assembly. GNU General Public License v3.0