Pancake POS REST API를 감싸는 모델 Context Protocol (MCP) 서버는 Claude와 같은 AI 조수를 사용하여 24 개의 전문 도구와 7 개의 참조 리소스를 사용하여 베트남 전자 상거래 POS 운영을 관리합니다.

개요

Pancake POS MCP는 Pancake POS API (https://pos.pages.fm/api/v1)]]를 Model Context Protocol 도구로 노출하여 Claude 및 기타 AI Assistant를 통해 POS 관리를 자동화합니다.

• ** 코어 POS:** 주문, 제품, 고객, 재고
• ** 공급 체인 : ** 창고, 공급 업체, 구매, 송금, Stocktaking -Sales: 반품, 교환, 콤보, 프로모션, 바우처
• CRM: 연락처, 거래, 활동
• Multi-Channel: 전자상거래 (Shopee/Lazada/TikTok), Livestream 상업
• 영업: 직원, Webhooks, Analytics, 매장 정보, 주소 조회

필수품

-Bun (런타임) - https://bun.sh에서 설치 ([T2]) -Pancake POS API Key +Shop ID - 아래 Pancake POS 자격 증명을 확인하세요. 참고 : 이것은 ** Pancake POS ** (e-commerce / 재고) API, Pancake user/social-inbox API - 다른 제품, 다른 키.

• Node.js 18+ (선택 사항, 개발 도구)

빠른 시작

Pancake POS MCP

Model Context Protocol (MCP) server wrapping the Pancake POS REST API, enabling AI assistants like Claude to manage Vietnamese e-commerce POS operations with 24 specialized tools and 7 reference resources.

Overview

Pancake POS MCP exposes the Pancake POS API (https://pos.pages.fm/api/v1) as Model Context Protocol tools, allowing Claude and other AI assistants to automate POS management across:

• Core POS: Orders, Products, Customers, Inventory
• Supply Chain: Warehouses, Suppliers, Purchases, Transfers, Stocktaking
• Sales: Returns, Exchanges, Combos, Promotions, Vouchers
• CRM: Contacts, Deals, Activities
• Multi-Channel: eCommerce (Shopee/Lazada/TikTok), Livestream Commerce
• Operations: Employees, Webhooks, Analytics, Shop Info, Address Lookup

Prerequisites

• Bun (runtime) — install from https://bun.sh (curl -fsSL https://bun.sh/install | bash)
• Pancake POS API Key + Shop ID — see Getting Pancake POS credentials below. Note: this is the Pancake POS (e-commerce / inventory) API, not the Pancake user/social-inbox API — different products, different keys.
• Node.js 18+ (optional, for development tooling)

Quick Start

Get from zero to a working MCP server in ~5 minutes:

# 1. Clone the repo
git clone https://github.com/nguyennguyenit/pancake-pos-mcp.git
cd pancake-pos-mcp

# 2. Install dependencies
bun install

# 3. Configure credentials
cp .env.example .env
# Open .env and fill in PANCAKE_POS_API_KEY + PANCAKE_POS_SHOP_ID
# (See "Getting Pancake POS credentials" section below)

# 4. Verify it runs
bun run src/index.ts
# Expected output:
#   [pancake-pos-mcp] Server started on stdio transport
# Press Ctrl+C to stop.

# 5. Connect Claude Desktop — see "Stdio Transport" section below

If step 4 prints an error, double-check your .env values and that you ran bun install. Common issues are listed in Troubleshooting.

Getting Pancake POS credentials

⚠️ Pancake POS ≠ Pancake (social inbox). This MCP only works with the Pancake POS product at https://pos.pages.fm — the e-commerce / inventory / order-management system. The Pancake user/inbox API at pages.fm is a different product with a different API key and is not supported here.

You need two values from your Pancake POS account:

1. PANCAKE_POS_SHOP_ID — the numeric ID of your shop
   • Log in to https://pos.pages.fm and check the URL or shop settings to find the numeric shop ID
2. PANCAKE_POS_API_KEY — your Pancake POS API token
   • Pancake POS Dashboard → Cài đặt (Settings) → API → Generate API key
   • Copy the key immediately — it is only shown once

Keep both values secret. Never commit them to git. The .gitignore already excludes .env and .dev.vars.

Configuration

Required (set in Quick Start):