MercaderIA
Comprar
インストールガイド

MercaderIA をステップバイステップで導入

技術知識は不要です。各段階で画面に何が表示されるか、表示されない場合はどうするかを正確にお伝えします。おかしく見えることの多くは正常です。そのつど説明します。

ステップ 0: 何をインストールするのか、なぜか

MercaderIA は4つの部品の上で動きます。仕組みを理解する必要はなく、揃っていれば十分です:

  • Node.js: 裏側のツールを動かすエンジンです。
  • Git: それらのツールが内部で使うユーティリティです。
  • Claude Code: あなたのストアで働く人工知能です。
  • MercaderIA: ストア全体を自動化するエージェント型システムです。

このページで最も重要なこと

MercaderIA は Git と Claude Code を代わりに入れますが、Node.js だけは先にご自身でインストールしてください。順序を飛ばすとアプリが「不足しています」と表示します。ステップ1から始めてください。

ステップ 1: Node.js をインストール(必ず最初)

これは MercaderIA のダウンロードより前に行います。公式サイトで LTS と書かれたバージョンをダウンロードしてください。

Node.js LTS をダウンロード

LTS は「長期サポートの安定版」という意味です。ボタンが2つある場合は必ず LTS を選び、「Current」は選ばないでください。

インストールは次へ、次へ、次へ。何も変更せず、すべて既定のまま進めます。

すべてのターミナルを閉じてパソコンを再起動

Node を初めて入れる場合は再起動してください。システムが新しいプログラムに「気づく」まで時間がかかり、再起動が確実な方法です。これでインストール中もっとも多いエラーを防げます。

動作確認:

Terminalを開いて(開き方はステップ2)、次を入力します:

zsh — Terminal
node --version

v22.14.0 のような表示が返れば成功です。

“command not found: node” と表示される場合はインストールされていないか再起動していません。再起動してもう一度試してください。

ステップ 2: ターミナルの開き方

ターミナルは、文字で命令を書いて Enter を押すとプログラムが応答する窓です。それだけです。壊れることはありません。

macOS

  1. Cmd + スペースを押します。
  2. terminal と入力します。
  3. Enter を押します。

Windows

  1. Windows キーを押します。
  2. powershell と入力します。
  3. Windows PowerShell を開きます。
maria@MacBook ~ % node --version
v22.14.0
maria@MacBook ~ %

文字が並んだ黒や青の画面はまったく正常です。開いたばかりのターミナルはこう見えます。

コピー&ペーストは推奨です

手入力は不要です。このガイドの各ブロックのコピーボタンを使い、Cmd + V でターミナルに貼り付けてください。

今後のための豆知識:ターミナルがパスワードを求めるとき、入力しても画面には何も表示されません(点もアスタリスクも)。これは保護機能で、故障ではありません。MercaderIA では起こりませんが、知っておくと安心です。

ステップ 3: Claude Code をインストール

方法は2つ。どちらでも構いません:

方法A — ターミナルから手動で (推奨)

Terminalを開いて、この1行を貼り付けます:

zsh — Terminal
curl -fsSL https://claude.ai/install.sh | bash

方法B — MercaderIA に任せる

MercaderIA を初めて開くと、アシスタントが不足分を検出して Git と Claude Code を自動で導入します。もっとも簡単ですが、反映に時間がかかり、アプリを一度閉じて開き直す必要がある場合があります。パソコンを再起動するか数分待てば自動的につながります。これは最初だけで、接続後は二度と起こりません。

画面に大量の文字が流れます。正常です。入力行($)が再び現れたら完了です。

ステップ 4: PATH の問題

Claude Code を入れた後、ターミナルで claude と打つとこう返ります:

zsh: command not found: claude

ご安心ください。想定内であり、珍しい不具合ではありません。プログラムは確かに入っていますが、ターミナルの検索リストに載っていないフォルダに置かれています。家に本はあるのに、いつも見る棚にないのと同じ。場所をパソコンに教えてあげます。

macOS — この2行を順番に貼り付けます:

zsh — Terminal
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

zsh — Terminal
source ~/.zshrc

1行目はフォルダ(例:/Users/maria/.local/bin)を恒久的にリストへ追加します。2行目は再起動せずにターミナルへ即時反映させます。

次で確認します:

zsh — Terminal
claude --version

それでも動かなくても大きな問題ではありません

MercaderIA は多くのフォルダを探すため、ターミナルから見えなくてもたいてい見つけます。先に進んでアプリを試してください。

ステップ 5: Claude にサインイン

Claude Code にはアカウントが必要です。初回はサインインを求められます。ブラウザのタブが開き、Claude アカウントでログインして承認し、アプリに戻ります。

Claude Code を初めて導入した直後は、MercaderIA がそのタブを自動で開きます。以前から Claude が入っていた場合はサインイン済みとみなして開きません。もし未サインインなら、ターミナルを開いて次を入力すれば解決します:

zsh — Terminal
claude

…そのあと画面の指示に従ってください。

この2つは別物です。混同しないでください

有効なプランの Claude アカウントと、別途 MercaderIA のライセンスが必要です。一方が他方を含むことはありません。

ステップ 6: MercaderIA をダウンロードして導入

.dmg をダウンロード(macOS)Windows 版(.exe)もあります

macOS が「開発元を確認できません」と表示する場合

.dmg を開き、MercaderIA をアプリケーションフォルダへドラッグします。開くときに警告が出たら、アプリを右クリック → 開く → 開く。Apple の署名がまだないためで、危険だからではありません。

ステップ 7: 初回起動:依存関係アシスタント

Git、Claude Code、Node.js の状態が並んだ一覧が表示され、足りないものをアプリが自動で導入します。

  • Node.js検出済み — v22.14.0
  • Gitインストール中…
  • Claude Code見つかりません

インストール後も「見つかりません」のままの場合

MercaderIA を完全に終了して開き直してください。アプリは起動時にシステムのプログラム一覧を引き継ぐため、起動中に入れたものは次回起動まで見えません。不具合ではなく仕様です。まっさらなパソコンでは、すべて緑になるまでアプリを1〜2回再起動するのが普通です。

一覧が固まって見えるときは確認中です

各プログラムの確認は最大10秒待ちます。少し待ってください。

ステップ 8: Shopify ストアを接続

アプリがストアのアドレスを次の形式で尋ねます:

ストアのアドレス
mitienda.myshopify.com

注意:これはストアの独自ドメインではありません。Shopify 管理画面 → 設定 → ドメインで、Shopify 内部ドメインとして表示される .myshopify.com のアドレスです。

続いてブラウザに Shopify の権限承認画面が開きます。項目が多いのは正常です。アシスタントが代わりに働くには、商品・注文・在庫・配送・返品の閲覧と編集が必要だからです。内容を確認して承認してください。

以前にストアを接続していた場合

新しいバージョンの権限を追加するため、再度承認を求められることがあります。想定内でエラーではありません。

ステップ 9: すべて動作するか確認

各項目にチェックを入れてください。5つ揃えば、ストアと会話しながら作業を始められます。

よくある問題

claude: command not found /「コマンドとして認識されません」

プログラムは入っていますが、ターミナルが探す場所を知りません。ステップ4(PATH)の修正を適用し、claude --version を再試行してください。Windows では PowerShell を閉じて開き直します。

Node を入れたのに node: command not found

パソコンを再起動してください。新しいプログラムの登録には再起動が必要です。その後 node --version を試します。

導入済みなのにアプリが不足と表示する

MercaderIA を完全に終了して開き直してください。アプリは起動時に環境を読み取るため、起動中に入れたものは次回まで見えません。

Shopify の権限画面でエラーになる

タブを閉じ、アプリから接続をやり直してください。続く場合はスクリーンショットを添えてご連絡ください。

macOS がアプリを開かせてくれない

アプリケーション内の MercaderIA を右クリック → 開く → 開く。未署名アプリの警告で、実際の危険ではありません。

Windows がプログラムは安全でないと表示する

詳細情報 → 実行。SmartScreen は新しいインストーラーにこの警告を出します。

新しいパソコンで何も検出されない

通常の状態です。正しい順序:Node.js を入れる → パソコン再起動 → MercaderIA を開いて Git と Claude Code を入れさせる → アプリ再起動。すべて緑になります。

まだ解決しませんか?

ご連絡ください。動くまで伴走します。どのステップで、画面に何が出たかをお知らせください(スクリーンショットが大変助かります)。

todo@mercaderia.co