Spree Commerce developer docs for AI agents
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
รันบนคลาวด์
harukibox
ใช้ทำอะไรได้
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
- ต่อแบบ คลาวด์หรือติดตั้งในเครื่อง
- บัญชีหรือคีย์ คลาวด์: ล็อกอินกับบริการตอนต่อ (OAuth) · ในเครื่อง: ต้องมี HARUKIBOX_TOKEN
- หมวด ร้านค้าออนไลน์และรับเงิน
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Run a Japan proxy-buying business from your AI: inventory, orders, buyers, shipping fee split.ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ผลตรวจผ่าน 5/5 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (harukibox.com)
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ต่อกับ Claude ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม
เปิดหน้า Connectors ของ Claude
CustomizeConnectors
กด “Add” → “Custom” → “Web” แล้วกรอก 2 ช่องนี้
คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue
Name · ชื่อกำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
Remote MCP server URL · ที่อยู่กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
กด Continue ผ่านหน้าตรวจการล็อกอินที่ Claude ตรวจเจอ · หัวข้อ Authentication เลือกตามที่ผู้ทำบอก (Sign in now, Sign in when needed หรือ No sign in) แล้วกด Add
เปิดใช้ในแชต
+Connectorsharukibox
ลองเลย
ใช้ harukibox บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude บอกว่ากำลังใช้ harukibox หรือมีชื่อเครื่องมือของ harukibox ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ ChatGPT ได้ ขึ้นกับแผน
MCP แบบเต็ม: ChatGPT Business, Enterprise หรือ Edu บนเว็บ · Pro: ต่อได้ด้วยสิทธิ์อ่านและดึงข้อมูล เครื่องมือที่แก้ข้อมูลอาจใช้ไม่ได้ · Plus: เอกสารยังไม่ยืนยัน ถ้าเห็นเมนูเพิ่ม MCP แบบกำหนดเองในหน้าปลั๊กอิน ลองตามขั้นตอนได้ · ใช้บนเว็บเท่านั้น
เปิดหน้าเพิ่ม MCP ของ ChatGPT บนเว็บ
Plugins+Add custom MCP server
กรอกชื่อและที่อยู่
ใส่ชื่อ แล้ววางที่อยู่ใต้ Connection ติ๊กยอมรับคำเตือน แล้วกด Create as a plugin
Name · ชื่อกำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
Connection · ที่อยู่กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
เลือก harukibox ในแชต
เปิดแชตใหม่แล้วเลือก harukibox จากรายการปลั๊กอินก่อนพิมพ์
ลองเลย
ใช้ harukibox บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า ChatGPT บอกว่ากำลังใช้ harukibox หรือมีชื่อเครื่องมือของ harukibox ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ OpenAI เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Claude Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
วางคำสั่งนี้แล้วกด Enter
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
พิมพ์ /mcp ใน Claude Code
ต้องเห็น harukibox ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ลองเลย
ใช้ harukibox บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude Code บอกว่ากำลังใช้ harukibox หรือมีชื่อเครื่องมือของ harukibox ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Cursor ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
กดปุ่มนี้เพื่อเปิด Cursor
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
เปิดแชตของ AI ใน Cursor โหมด Agent
ลองเลย
ใช้ harukibox บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Cursor บอกว่ากำลังใช้ harukibox หรือมีชื่อเครื่องมือของ harukibox ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ VS Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
กดปุ่มนี้เพื่อเปิด VS Code
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
เปิดแชตของ AI ใน VS Code โหมด Agent
ลองเลย
ใช้ harukibox บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า VS Code บอกว่ากำลังใช้ harukibox หรือมีชื่อเครื่องมือของ harukibox ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม
ที่อยู่สำหรับโปรแกรมที่ต่อผ่านเว็บ
ที่อยู่
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON
ต่อผ่านเว็บ
Claude Code
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
Cursor (~/.cursor/mcp.json)
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
VS Code (mcp.json)
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
ติดตั้งในเครื่อง
Claude Code
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
Claude Desktop (claude_desktop_config.json)
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
Cursor (~/.cursor/mcp.json)
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
VS Code (mcp.json)
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
ค่าที่ต้องใส่เอง
HARUKIBOX_TOKENความลับ จำเป็น envharukibox API token (hrk_live_…). 用 `harukibox login` 取得，或到 harukibox.com 設定頁產生。HARUKIBOX_BASE_URLenvSelf-hosted 或測試環境的 API base URL。留空即用官方 https://harukibox.com/api/agent。
คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
สรุป
- ดาวน์โหลดต่อสัปดาห์i
- 38/สัปดาห์
- โดเมนที่ยืนยัน
- ✓ harukibox.com
- การเชื่อมต่อ
- บนเครื่องหรือคลาวด์
- ช่องทาง (transport)
- stdio, streamable-http
- รุ่นล่าสุดi
- 0.2.1
- ส่งเข้า registryi
- 11 ส.ค. 2569
- แก้โค้ดล่าสุดi
- 11 ส.ค. 2569
- ผู้ทำ
- cosmopig
- แพ็กเกจ
npm: @harukibox/mcp- เว็บผู้ทำ
- harukibox.com
- สถานะใน registry
- ใช้งานอยู่
ใช้กับโปรแกรมไหนได้
ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ต่อผ่านคลาวด์ได้ใน
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
ติดตั้งบนเครื่องได้ใน
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
คู่มือที่เกี่ยวข้อง
ทำอะไรได้บ้าง
server ให้ล็อกอินก่อนจึงจะแสดงรายการเครื่องมือ
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 14 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันโดเมน harukibox.com แล้ว (registry ตรวจความเป็นเจ้าของโดเมน)
- ✓ ผ่าน
ยังมีคนดูแล
มีการแก้โค้ดล่าสุด 3 เดือนที่ผ่านมา
- ✓ ผ่าน
มีสัญญาอนุญาต (license)
ใช้ MIT
- ✓ ผ่าน
endpoint ตอบ
ตอบกลับใน 2156 ms (HTTP 401)
- ✓ ผ่าน
ล็อกอินแบบ OAuth
ประกาศวิธีล็อกอินแบบ OAuth ให้โปรแกรม AI พาไปล็อกอินเอง
- … ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
ยังไม่ได้ตรวจ เราอ่านรายการเครื่องมือตอนตรวจ endpoint
พูดคุย
ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
รีวิวจากผู้ใช้
ยังไม่มีรีวิว
เทียบกับตัวอื่นในหมวด ร้านค้าออนไลน์และรับเงินi
- ดาวมากกว่า 0% ของอีก 2783 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 21% ของอีก 2783 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 2783 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
harukibox ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 5 จาก 5 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
ต้องใส่ค่าเหล่านี้: HARUKIBOX_TOKEN
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
ได้ทั้งสองแบบ จะลงในเครื่องหรือต่อผ่านคลาวด์ก็ได้
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด 3 เดือนที่ผ่านมา และส่งรุ่นล่าสุด (0.2.1) เข้า registry 3 เดือนที่ผ่านมา
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT บนเว็บ (แบบเต็มในแผน Business ขึ้นไป · Pro แบบอ่านอย่างเดียว)
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability
ตัวอื่นในหมวดเดียวกัน
server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Stripe MCP
server ทางการของ Stripe ให้ AI ดูและจัดการลูกค้า สินค้า การชำระเงิน และใบแจ้งหนี้ ต่อผ่านคลาวด์ของ Stripe และล็อกอินแบบ OAuth
รันบนคลาวด์✓ เจ้าของบริการ · stripe.com
Sessy — Amazon SES observability
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
รันบนคลาวด์
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/cliharukibox 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