パンケーキPOS REST API を包むモデルコンテキストプロトコル (MCP) サーバーで、Claude のような AI アシスタントが 24 の専門ツールと 7 の参照リソースを使用して、ベトナム e コマース POS 操作を管理できるようにします。

概要

パンケーキPOS MCPは、パンケーキPOS API(https://pos.pages.fm/api/v1))をモデルコンテキストプロトコルツールとして公開し、Claudeや他のAIアシスタントがPOS管理を自動化できるようにします。

• 中心POS: 注文、製品、顧客、在庫
• **サプライ チェーン:**倉庫、サプライヤー、購入、転送、株式取得
• **販売:**リターン、交換、コンボ、プロモーション、バウチャー -CRM: 連絡先、取引、活動 -マルチチャネル: eコマース(買い物/Lazada/TikTok)、ライブストリームコマース
• 操作: 従業員、Webhooks、分析、店舗情報、住所検索

前提条件

• Bun (実行時間) — [https://bun.shからインストールします ([curl -fsSL https://bun.sh/install | bash))
• パンケーキPOS APIキー + ショップID - パンケーキPOSの資格を取得するを参照してください。 Note: これは、Pancake POS**(eコマース/在庫)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):