Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
harukibox
Resumen
Descripción del creador (original en inglés)
Run a Japan proxy-buying business from your AI: inventory, orders, buyers, shipping fee split.
Los tres pilares de PopNx MCP
Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.
- Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
- Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
- UsoiAún sin medir★ –
Qué puedes hacer con él
Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.
- Conexión: Computadora o nube
- Transporte: stdio, Streamable HTTP
- Categoría: Tiendas en línea y pagos
- Debes completar: HARUKIBOX_TOKEN
Instalación
Elige la app de IA que usas y copia la configuración.
Antes de instalar
- Revisiones básicas: 1 de 1 superadas
- Se ejecuta en el servidor del creador: lo que le pidas pasa por su servidor.
- Debes completar tú:
HARUKIBOX_TOKEN,HARUKIBOX_BASE_URL
Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.
Necesitas
- Se ejecuta en la nubeNo hay nada que instalar; se conecta por internet
- npmNode.js instalado (para el comando npx)
¿Qué app usas?
Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.
Funciona en Claude para web, escritorio y móvil:
- Abre Settings → Connectors
- Presiona Add custom connector
- Pega la dirección de abajo y presiona Add
- Si te pide iniciar sesión, inicia sesión en el servicio del creador
https://harukibox.com/api/agent/mcpO ejecútalo en tu computadora
Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json
{
"mcpServers": {
"harukibox": {
"command": "npx",
"args": [
"-y",
"@harukibox/mcp"
],
"env": {
"HARUKIBOX_TOKEN": "your-value",
"HARUKIBOX_BASE_URL": "your-value"
}
}
}
}Ejecuta esto en tu terminal
claude mcp add --transport http harukibox https://harukibox.com/api/agent/mcpO ejecútalo en tu computadora
claude mcp add harukibox --env HARUKIBOX_TOKEN=your-value --env HARUKIBOX_BASE_URL=your-value -- npx -y @harukibox/mcpCompleta los valores vacíos antes de ejecutarlo.
O copia la configuración tú
Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json
{
"mcpServers": {
"harukibox": {
"url": "https://harukibox.com/api/agent/mcp"
}
}
}O ejecútalo en tu computadora
O copia la configuración tú
Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json
{
"mcpServers": {
"harukibox": {
"command": "npx",
"args": [
"-y",
"@harukibox/mcp"
],
"env": {
"HARUKIBOX_TOKEN": "your-value",
"HARUKIBOX_BASE_URL": "your-value"
}
}
}
}Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.
O copia la configuración tú
Pégalo en .vscode/mcp.json de tu proyecto
{
"servers": {
"harukibox": {
"type": "http",
"url": "https://harukibox.com/api/agent/mcp"
}
}
}O ejecútalo en tu computadora
O copia la configuración tú
Pégalo en .vscode/mcp.json de tu proyecto
{
"servers": {
"harukibox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@harukibox/mcp"
],
"env": {
"HARUKIBOX_TOKEN": "your-value",
"HARUKIBOX_BASE_URL": "your-value"
}
}
}
}Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.
ChatGPT solo se conecta a servidores en internet:
- Abre ChatGPT en la web → Settings → Connectors (Apps)
- Presiona Create o Add (en algunos planes primero hay que activar Developer mode en Advanced)
- Pega la dirección de abajo, ponle un nombre y guarda
- Si te pide iniciar sesión, inicia sesión en el servicio del creador
https://harukibox.com/api/agent/mcpLos nombres de los menús pueden variar un poco según el plan y con el tiempo.
Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.
Valores que debes completar
- harukibox API token (hrk_live_…). 用 `harukibox login` 取得,或到 harukibox.com 設定頁產生。
HARUKIBOX_BASE_URLenvSelf-hosted 或測試環境的 API base URL。留空即用官方 https://harukibox.com/api/agent。
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Qué puede hacer
Todavía no hemos leído la lista de herramientas de este servidor; revisamos los endpoints por turnos.
Revisiones básicasi
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 6 nov 2026
- ✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con el dominio harukibox.com (el registro comprueba quién es dueño del dominio)
- … Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
- … Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
- … Aún sin revisar
El endpoint responde
Aún sin revisar; revisamos los endpoints por turnos
- … Aún sin revisar
Inicio de sesión con OAuth
Aún sin revisar; revisamos los endpoints por turnos
- … Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Aún sin revisar; leemos la lista de herramientas cuando revisamos el endpoint
Comparado con otros en Tiendas en línea y pagosi
- Más estrellas que el 0% de los otros 1744 servidores de esta categoría
- Publicado en el registro más recientemente que el 27% de los otros 1744 servidores de esta categoría
- Revisiones básicas iguales o mejores que el 100% de los otros 1744 servidores de esta categoría
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Preguntas frecuentes
¿Es seguro harukibox?
Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
¿Qué claves o códigos necesita?
Debes completar: HARUKIBOX_TOKEN
¿Se ejecuta en mi computadora o en la nube?
Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.
¿Sigue en mantenimiento?
El repo de GitHub cambió por última vez –, y la última versión (0.2.1) llegó al registro hace 3 meses.
¿Qué apps pueden usarlo?
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también funcionan las apps que aceptan servidores MCP remotos, como ChatGPT en modo desarrollador.
¿Qué puedo usar en su lugar?
En la misma categoría: Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
Alternativas
Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.
Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Stripe MCP
MCP server integrating with Stripe - tools for customers, products, payments, and more.
MCP Cn Commerce
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
README del creador
Abrir el README
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
@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