Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
harukibox
Überblick
Beschreibung vom Entwickler (englisches Original)
Run a Japan proxy-buying business from your AI: inventory, orders, buyers, shipping fee split.
Die drei Säulen von PopNx MCP
Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.
- Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
- Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
- NutzungiNoch nicht gemessen★ –
Was du damit machen kannst
Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.
- Verbindung: Computer oder Cloud
- Transport: stdio, Streamable HTTP
- Kategorie: Onlineshops & Zahlungen
- Das musst du eintragen: HARUKIBOX_TOKEN
Installation
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Bevor du installierst
- Basischecks: 1 von 1 bestanden
- Läuft auf dem Server des Entwicklers: Was du fragst, läuft über dessen Server.
- Das trägst du selbst ein:
HARUKIBOX_TOKEN,HARUKIBOX_BASE_URL
Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.
Du brauchst
- Läuft in der CloudNichts zu installieren; die Verbindung läuft übers Internet
- npmNode.js installiert (für den Befehl npx)
Welche App nutzt du?
Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.
Funktioniert in Claude im Web, auf dem Desktop und auf dem Handy:
- Öffne Settings → Connectors
- Tippe auf Add custom connector
- Füge die Adresse unten ein und tippe auf Add
- Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an
https://harukibox.com/api/agent/mcpOder führ ihn auf deinem Computer aus
Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein
{
"mcpServers": {
"harukibox": {
"command": "npx",
"args": [
"-y",
"@harukibox/mcp"
],
"env": {
"HARUKIBOX_TOKEN": "your-value",
"HARUKIBOX_BASE_URL": "your-value"
}
}
}
}Führe das in deinem Terminal aus
claude mcp add --transport http harukibox https://harukibox.com/api/agent/mcpOder führ ihn auf deinem Computer aus
claude mcp add harukibox --env HARUKIBOX_TOKEN=your-value --env HARUKIBOX_BASE_URL=your-value -- npx -y @harukibox/mcpTrag die leeren Werte ein, bevor du ihn startest.
Oder kopier die Einstellungen selbst
In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen
{
"mcpServers": {
"harukibox": {
"url": "https://harukibox.com/api/agent/mcp"
}
}
}Oder führ ihn auf deinem Computer aus
Oder kopier die Einstellungen selbst
In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen
{
"mcpServers": {
"harukibox": {
"command": "npx",
"args": [
"-y",
"@harukibox/mcp"
],
"env": {
"HARUKIBOX_TOKEN": "your-value",
"HARUKIBOX_BASE_URL": "your-value"
}
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
Oder kopier die Einstellungen selbst
In .vscode/mcp.json in deinem Projekt einfügen
{
"servers": {
"harukibox": {
"type": "http",
"url": "https://harukibox.com/api/agent/mcp"
}
}
}Oder führ ihn auf deinem Computer aus
Oder kopier die Einstellungen selbst
In .vscode/mcp.json in deinem Projekt einfügen
{
"servers": {
"harukibox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@harukibox/mcp"
],
"env": {
"HARUKIBOX_TOKEN": "your-value",
"HARUKIBOX_BASE_URL": "your-value"
}
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
ChatGPT verbindet sich nur mit Servern im Internet:
- Öffne ChatGPT im Web → Settings → Connectors (Apps)
- Tippe auf Create oder Add (bei manchen Tarifen musst du zuerst Developer mode unter Advanced einschalten)
- Füge die Adresse unten ein, gib ihr einen Namen und speichere
- Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an
https://harukibox.com/api/agent/mcpMenünamen können sich je nach Tarif und mit der Zeit leicht unterscheiden.
Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.
Werte, die du selbst einträgst
- harukibox API token (hrk_live_…). 用 `harukibox login` 取得,或到 harukibox.com 設定頁產生。
HARUKIBOX_BASE_URLenvSelf-hosted 或測試環境的 API base URL。留空即用官方 https://harukibox.com/api/agent。
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Was er kann
Die Tool-Liste dieses Servers haben wir noch nicht gelesen; wir prüfen die Endpunkte reihum.
Basischecksi
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 6. Nov. 2026
- ✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde über die Domain harukibox.com bestätigt (die Registry prüft, wem die Domain gehört)
- … Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
- … Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
- … Noch nicht geprüft
Endpunkt antwortet
Noch nicht geprüft; wir prüfen die Endpunkte reihum
- … Noch nicht geprüft
Anmeldung mit OAuth
Noch nicht geprüft; wir prüfen die Endpunkte reihum
- … Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen
Im Vergleich mit anderen in Onlineshops & Zahlungeni
- Mehr Sterne als 0 % der anderen 1743 Server in dieser Kategorie
- Neuer in der Registry veröffentlicht als 27 % der anderen 1743 Server in dieser Kategorie
- Basischecks gleich gut wie oder besser als bei 100 % der anderen 1743 Server in dieser Kategorie
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Häufige Fragen
Ist harukibox sicher?
Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Welche Schlüssel oder Codes braucht er?
Das musst du eintragen: HARUKIBOX_TOKEN
Läuft er auf meinem Computer oder in der Cloud?
Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.
Wird er noch gepflegt?
Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.2.1) kam vor 3 Monaten in die Registry.
Welche Apps können ihn nutzen?
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL, also funktionieren auch Apps, die Remote-MCP-Server akzeptieren, zum Beispiel ChatGPT im Entwicklermodus.
Was kann ich stattdessen nutzen?
In derselben Kategorie: Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
Alternativen
Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.
So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
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 vom Entwickler
README öffnen
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
@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