harukibox

Name: harukibox
Author: cosmopig

by cosmopigversion 0.2.1i★ 0iComputer or cloud

Registry namecom.harukibox/harukibox

How to install

What it does

Run a Japan proxy-buying business from your AI: inventory, orders, buyers, shipping fee split.

Connects Computer or cloud
Account or key Cloud: Sign in to the service when you connect (OAuth) · Local: Needs HARUKIBOX_TOKEN
Category Online shops & payments

Install

Pick the AI app you use, then copy the settings.

Passed 5/5 checks · What you ask goes through the maker’s server (harukibox.com) · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

ClaudeWeb · app · phoneChatGPTWebClaude CodeTerminalCursorCode editorVS CodeCode editorOtherOther apps

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

Open Claude’s Connectors page
CustomizeConnectors
Done
Click “Add” → “Custom” → “Web” and fill in these 2 fields
Copy each value into the field with the same name in Claude, then click Continue
Name · Nameharukibox
Remote MCP server URL · Addresshttps://harukibox.com/api/agent/mcp
Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add
Done
Turn it on in a chat
+Connectorsharukibox
Done
Try it
Use harukibox and tell me what you can do for me, then show me one thing
✓ If Claude says it is using harukibox or shows a harukibox tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

Open ChatGPT’s add-MCP page on the web
Plugins+Add custom MCP server
Done
Fill in the name and address
Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin
Name · Nameharukibox
Connection · Addresshttps://harukibox.com/api/agent/mcp
Done
Pick harukibox in a chat
Start a new chat and pick harukibox from your plugins before typing
Done
Try it
Use harukibox and tell me what you can do for me, then show me one thing
✓ If ChatGPT says it is using harukibox or shows a harukibox tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Done

Paste this command and press Enter

claude mcp add --transport http --scope user harukibox https://harukibox.com/api/agent/mcp

Done

Type /mcp in Claude Code
You should see harukibox listed as connected
Done
Try it
Use harukibox and tell me what you can do for me, then show me one thing
✓ If Claude Code says it is using harukibox or shows a harukibox tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

Click this button to open Cursor
Open in Cursor
Cursor asks you to confirm; click Install
Done
Open the AI chat in Cursor in Agent mode
Done
Try it
Use harukibox and tell me what you can do for me, then show me one thing
✓ If Cursor says it is using harukibox or shows a harukibox tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

Click this button to open VS Code
Open in VS Code
VS Code asks you to confirm; click Install
Done
Open the AI chat in VS Code in Agent mode
Done
Try it
Use harukibox and tell me what you can do for me, then show me one thing
✓ If VS Code says it is using harukibox or shows a harukibox tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://harukibox.com/api/agent/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use harukibox💬 Discussion →

For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user harukibox https://harukibox.com/api/agent/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "harukibox": {
      "url": "https://harukibox.com/api/agent/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "harukibox": {
      "type": "http",
      "url": "https://harukibox.com/api/agent/mcp"
    }
  }
}

Installed on your computer

Claude Code

claude mcp add --scope user harukibox --env HARUKIBOX_TOKEN=your-value -- npx -y @harukibox/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "harukibox": {
      "command": "npx",
      "args": [
        "-y",
        "@harukibox/mcp"
      ],
      "env": {
        "HARUKIBOX_TOKEN": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "harukibox": {
      "command": "npx",
      "args": [
        "-y",
        "@harukibox/mcp"
      ],
      "env": {
        "HARUKIBOX_TOKEN": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "harukibox": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@harukibox/mcp"
      ],
      "env": {
        "HARUKIBOX_TOKEN": "your-value"
      }
    }
  }
}

Values you fill in

HARUKIBOX_TOKEN secret required env
harukibox API token (hrk_live_…). 用 `harukibox login` 取得，或到 harukibox.com 設定頁產生。
HARUKIBOX_BASE_URL env
Self-hosted 或測試環境的 API base URL。留空即用官方 https://harukibox.com/api/agent。

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

GitHub stars i: 0
Downloads per weeki: 38/wk
Verified domain: ✓ harukibox.com
Licence i: MIT
Connection: Computer or cloud
Transport: stdio, streamable-http
Latest versioni: 0.2.1
Categoryi: Online shops & payments
Published to registryi: Aug 11, 2026
Code last changedi: Aug 11, 2026
Maker: cosmopig
Packages: npm: @harukibox/mcp
Repo: cosmopig/harukibox-agent
Website: harukibox.com
Registry status: Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

Claude ChatGPT Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Open WebUI Raycast

Run on your computer in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

All apps, with pros and cons →

What it can do

The server asks you to sign in before it lists its tools.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 14, 2026

✓ Pass
Maker matches the repo
The registry name was verified against the domain harukibox.com (the registry checks domain ownership)
✓ Pass
Still maintained
Code last changed 3 months ago
✓ Pass
Has a licence
Uses MIT
✓ Pass
Endpoint responds
Responded in 2156 ms (HTTP 401)
✓ Pass
Sign-in with OAuth
Declares OAuth sign-in, so your AI app can take you to log in
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

User reviews

No reviews yet

Compared with others in Online shops & paymentsi

More stars than 0% of the other 2789 servers in this category
Published to the registry more recently than 21% of the other 2789 servers in this category
Basic checks equal to or better than 100% of the other 2789 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is harukibox safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: HARUKIBOX_TOKEN

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 3 months ago, and the latest version (0.2.1) reached the registry 3 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability

Others in the same category

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spree Commerce developer docs for AI agents

Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.

by spreeWidely used★ 15.8K Stars for the whole repoUpdated 15 days ago

Runs in the cloud

How to connect

Stripe MCP

Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.

by stripeWidely used★ 2.1KUpdated 13 months ago

Runs in the cloud✓ service owner · stripe.com

How to connect

Sessy — Amazon SES observability

Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.

by marckohlbruggeGrowing★ 945Updated 4 months ago

Runs in the cloud

How to connect

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

@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

harukibox

What it does

Install

Open Claude’s Connectors page

Click “Add” → “Custom” → “Web” and fill in these 2 fields

Turn it on in a chat

Try it

Open ChatGPT’s add-MCP page on the web

Fill in the name and address

Pick harukibox in a chat

Try it

Open Terminal

Paste this command and press Enter

Type /mcp in Claude Code

Try it

Click this button to open Cursor

Open the AI chat in Cursor in Agent mode

Try it

Click this button to open VS Code

Open the AI chat in VS Code in Agent mode

Try it

Over the web

Installed on your computer

Values you fill in

At a glance

Which apps can use it

Related guides

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Discussion

User reviews

Compared with others in Online shops & paymentsi

Common questions

Others in the same category

Spree Commerce developer docs for AI agents

Stripe MCP

Sessy — Amazon SES observability

README from the maker

@harukibox/mcp

協定版本

安裝

取得 API token

或無 GUI 環境：

Claude Desktop 設定

Refresh token (進階, 預設關閉)

Claude Code 設定

可用工具

安全

自架 / 私有部署

License