Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Bewertungen und Benutzerkonten folgen in einem späteren Schritt.
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

harukibox

von cosmopigVersion 0.2.1i★ –iComputer oder Cloud
Name in der Registrycom.harukibox/harukibox

Installieren

Ü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.

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:

  1. Öffne Settings → Connectors
  2. Tippe auf Add custom connector
  3. Füge die Adresse unten ein und tippe auf Add
  4. Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an
SettingsConnectors1+ Add2https://…3
https://harukibox.com/api/agent/mcp

Oder 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/mcp

Oder 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/mcp

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

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

In Cursor öffnen

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.

In VS Code öffnen

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

In VS Code öffnen

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:

  1. Öffne ChatGPT im Web → Settings → Connectors (Apps)
  2. Tippe auf Create oder Add (bei manchen Tarifen musst du zuerst Developer mode unter Advanced einschalten)
  3. Füge die Adresse unten ein, gib ihr einen Namen und speichere
  4. Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an
SettingsConnectors1+ Create2https://…3
https://harukibox.com/api/agent/mcp

Menü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_TOKEN geheim erforderlich env
    harukibox API token (hrk_live_…). 用 `harukibox login` 取得,或到 harukibox.com 設定頁產生。
  • HARUKIBOX_BASE_URL env
    Self-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

von stripe

MCP server integrating with Stripe - tools for customers, products, payments, and more.

Läuft in der Cloud★ 2.043MITAktualisiert vor 12 Monaten
Installieren

MCP Cn Commerce

von TonyWang-hub

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

Läuft auf deinem Computer★ 96MITAktualisiert vor 27 Tagen
Installieren

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_meme取得當前 user/organization/token info
haruki_list_productsproducts:read列出商品
haruki_get_productproducts:read取得單一商品
haruki_create_productproducts:write建立商品
haruki_list_registrationsregistrations:read列出訂單
haruki_list_buyersbuyers:read列出買家
haruki_list_shippingsshippings:read列出出貨
haruki_searchsearch全域搜尋

安全

  • 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

PopNx fragen