Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
harukibox
ภาพรวม
คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)
Run a Japan proxy-buying business from your AI: inventory, orders, buyers, shipping fee split.
สามเสาของ PopNx MCP
สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน
- เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
- ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
- การใช้งานiยังไม่ได้วัด★ –
ใช้ทำอะไรได้
ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry
- การเชื่อมต่อ: บนเครื่องหรือคลาวด์
- ช่องทาง (transport): stdio, Streamable HTTP
- หมวด: ร้านค้าออนไลน์และรับเงิน
- ต้องใส่ค่าเหล่านี้: HARUKIBOX_TOKEN
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ก่อนติดตั้ง
- ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
- รันบนเครื่องของผู้ทำ สิ่งที่คุณถามจะผ่านเครื่องของเขา
- ค่าที่คุณต้องใส่เอง:
HARUKIBOX_TOKEN,HARUKIBOX_BASE_URL
ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต
ต้องเตรียมก่อน
- รันบนคลาวด์ไม่ต้องลงโปรแกรมเพิ่ม ต่อผ่านอินเทอร์เน็ตได้เลย
- npmติดตั้ง Node.js (มีคำสั่ง npx) ในเครื่อง
คุณใช้แอปไหน
เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”
ใช้ได้ทั้ง Claude บนเว็บ แอปคอมพิวเตอร์ และมือถือ:
- เปิด Settings → Connectors
- กด Add custom connector
- วางที่อยู่ด้านล่างแล้วกด Add
- ถ้าให้ล็อกอิน ให้ล็อกอินกับผู้ทำ
https://harukibox.com/api/agent/mcpหรือรันในเครื่องคุณ
เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json
{
"mcpServers": {
"harukibox": {
"command": "npx",
"args": [
"-y",
"@harukibox/mcp"
],
"env": {
"HARUKIBOX_TOKEN": "ใส่ค่าของคุณ",
"HARUKIBOX_BASE_URL": "ใส่ค่าของคุณ"
}
}
}
}พิมพ์คำสั่งนี้ใน Terminal
claude mcp add --transport http harukibox https://harukibox.com/api/agent/mcpหรือรันในเครื่องคุณ
claude mcp add harukibox --env HARUKIBOX_TOKEN='ใส่ค่าของคุณ' --env HARUKIBOX_BASE_URL='ใส่ค่าของคุณ' -- npx -y @harukibox/mcpเติมค่าที่เว้นว่างไว้ก่อนรัน
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json
{
"mcpServers": {
"harukibox": {
"url": "https://harukibox.com/api/agent/mcp"
}
}
}หรือรันในเครื่องคุณ
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json
{
"mcpServers": {
"harukibox": {
"command": "npx",
"args": [
"-y",
"@harukibox/mcp"
],
"env": {
"HARUKIBOX_TOKEN": "ใส่ค่าของคุณ",
"HARUKIBOX_BASE_URL": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .vscode/mcp.json ของโปรเจกต์
{
"servers": {
"harukibox": {
"type": "http",
"url": "https://harukibox.com/api/agent/mcp"
}
}
}หรือรันในเครื่องคุณ
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .vscode/mcp.json ของโปรเจกต์
{
"servers": {
"harukibox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@harukibox/mcp"
],
"env": {
"HARUKIBOX_TOKEN": "ใส่ค่าของคุณ",
"HARUKIBOX_BASE_URL": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
ChatGPT ต่อได้เฉพาะ server ที่อยู่บนอินเทอร์เน็ต:
- เปิด ChatGPT บนเว็บ → Settings → Connectors (Apps)
- กด Create หรือ Add (บางแพ็กเกจต้องเปิด Developer mode ใน Advanced ก่อน)
- วางที่อยู่ด้านล่าง ตั้งชื่อ แล้วบันทึก
- ถ้าให้ล็อกอิน ให้ล็อกอินกับผู้ทำ
https://harukibox.com/api/agent/mcpชื่อเมนูอาจต่างกันเล็กน้อยตามแพ็กเกจและรุ่นของแอป
ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี
ค่าที่ต้องใส่เอง
- harukibox API token (hrk_live_…). 用 `harukibox login` 取得,或到 harukibox.com 設定頁產生。
HARUKIBOX_BASE_URLenvSelf-hosted 或測試環境的 API base URL。留空即用官方 https://harukibox.com/api/agent。
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
ทำอะไรได้บ้าง
ยังไม่ได้อ่านรายการเครื่องมือของตัวนี้ เราตรวจ endpoint ทีละชุดวนไป
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 6 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันโดเมน harukibox.com แล้ว (registry ตรวจความเป็นเจ้าของโดเมน)
- … ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- … ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- … ยังไม่ตรวจ
endpoint ตอบ
ยังไม่ได้ตรวจ เราตรวจ endpoint ทีละชุดวนไป
- … ยังไม่ตรวจ
ล็อกอินแบบ OAuth
ยังไม่ได้ตรวจ เราตรวจ endpoint ทีละชุดวนไป
- … ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
ยังไม่ได้ตรวจ เราอ่านรายการเครื่องมือตอนตรวจ endpoint
เทียบกับตัวอื่นในหมวด ร้านค้าออนไลน์และรับเงินi
- ดาวมากกว่า 0% ของอีก 1743 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 27% ของอีก 1743 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 1743 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
harukibox ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
ต้องใส่ค่าเหล่านี้: HARUKIBOX_TOKEN
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
ได้ทั้งสองแบบ จะลงในเครื่องหรือต่อผ่านคลาวด์ก็ได้
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.2.1) เข้า registry 3 เดือนที่ผ่านมา
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT ที่เปิดโหมดนักพัฒนา
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
ตัวที่ใช้แทนได้
server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว
อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Stripe MCP
server ทางการของ Stripe ให้ AI ดูและจัดการลูกค้า สินค้า การชำระเงิน และใบแจ้งหนี้ ต่อผ่านคลาวด์ของ Stripe และล็อกอินแบบ OAuth
MCP Cn Commerce
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
@harukibox/mcp
Model Context Protocol server for harukibox — let your AI agent manage your 代購 inventory, orders, buyers and shipments through the official Agent API.
協定版本
實作 MCP 2026-07-28(stateless、server/discover、resultType、cacheable tools/list),同時維持 dual-era:舊版的 initialize handshake 照樣回應。
也就是說現在的 Claude Desktop / Claude Code(仍在 2025-11-25 以前)不用改任何設定 就能繼續用;等 client 升級到 2026-07-28 後會自動走新路徑,一樣不用改設定。
@modelcontextprotocol/sdk最新的 1.30.0 仍停在2025-11-25,沒有
server/discover/resultType/CacheableResult,所以本 server 直接輸出 wire
format 而不透過 SDK(也因此本套件零 runtime 相依)。SDK 支援新版後會換回去。
安裝
npm install -g @harukibox/mcp
或在專案內:
npm install @harukibox/mcp
取得 API token
透過 @harukibox/cli 跑 OAuth 取得(90 天有效):
npm install -g @harukibox/cli
harukibox login # PKCE,預設打開瀏覽器
或無 GUI 環境:
harukibox login --device # device flow,顯示 user_code 讓你在瀏覽器輸入
跑完 token 會寫進 ~/.config/harukibox/config.json(mode 0600)。把該 token 設成 HARUKIBOX_TOKEN 即可。
Claude Desktop 設定
編輯 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": { "harukibox": { "command": "harukibox-mcp", "env": { "HARUKIBOX_TOKEN": "hrk_live_your_token_here" } } } }
Refresh token (進階, 預設關閉)
如果你跑 long-lived MCP process(不常重啟),可開 refresh:
"env": {
"HARUKIBOX_TOKEN": "hrk_live_...", "HARUKIBOX_ENABLE_REFRESH": "1", "HARUKIBOX_REFRESH_TOKEN": "hrk_refresh_..." }
⚠️ 限制:refresh rotation 後新 refresh 只在 process memory;process 重啟時 env 仍是舊 refresh,server 會視為 reuse 並撤該 user 所有 token。重啟前請手動執行 harukibox login 取新 token。建議 production 不開此選項,依賴 90 天到期後 re-OAuth。
Claude Code 設定
claude mcp add harukibox --command harukibox-mcp --env HARUKIBOX_TOKEN=hrk_live_your_token_here
可用工具
| Tool | 必要 scope | 說明 |
|---|---|---|
haruki_me | me | 取得當前 user/organization/token info |
haruki_list_products | products:read | 列出商品 |
haruki_get_product | products:read | 取得單一商品 |
haruki_create_product | products:write | 建立商品 |
haruki_list_registrations | registrations:read | 列出訂單 |
haruki_list_buyers | buyers:read | 列出買家 |
haruki_list_shippings | shippings:read | 列出出貨 |
haruki_search | search | 全域搜尋 |
安全
- Token 一律以環境變數提供,不會寫入磁碟
- 所有請求走 HTTPS 並帶 sha256 hash 驗證
- 過期 / 撤銷 / IP allowlist 不符時請求會立刻被拒
- 每次呼叫會被寫入伺服器端 audit log(沒有 web UI 查詢;如需匯出請與服務方聯繫)
自架 / 私有部署
HARUKIBOX_BASE_URL=https://your-instance.example.com/api/agent \
HARUKIBOX_TOKEN=hrk_live_... \ harukibox-mcp
License
MIT