Claude Media
Claude NoibuプラグインでECの売上に響くエラーを拾う手順

Claude NoibuプラグインでECの売上に響くエラーを拾う手順

Noibuプラグインは、ECサイトのセッション・エラー・コンバージョンのデータをClaudeにつなぎ、売上に響く問題を拾います。Cowork・Claude Desktop・Claude Codeの入れ方と、導入後の聞き方をまとめます。

Noibuプラグインは、ECサイトの計測サービスNoibuのセッション・エラー・コンバージョンのデータをClaudeにつなぎ、「売上を押し下げている問題」を会話で拾うためのプラグインです。入れ方は3通りあります。Coworkのプラグインディレクトリから入れる方法、Claude Desktopにzipを手動で上げる方法、Claude Codeのマーケットプレイスから入れる方法です。

先に押さえておきたいのは、プラグインを入れただけでは何も見えないことです。データの出どころはNoibuのアカウントとサイトに置いた計測スクリプトで、Claudeとの接続は別にコネクタ(MCPサーバー)で行います。この記事では、前提、3つの導入経路、導入後の聞き方、更新の挙動、チームへの配り方を順に説明します。

3つの導入経路は何が違うか

提供元のリポジトリには、Claude DesktopとClaude Codeの2通りが書かれています。ヘルプ記事はCoworkのプラグインディレクトリ経由の手順です。違いは次のとおりです。

経路入れ方更新
Cowork(ディレクトリ)入れ方Pluginsページで検索して追加更新自動
Claude Desktop(手動)入れ方noibu.zip をCustomizeから上げる更新再インストールが必要
Claude Code入れ方/plugin marketplace add で追加して入れる更新マーケットプレイスの設定次第

どの経路でも、データを引くにはNoibuのMCPサーバー(コネクタ)への接続と、Noibuアカウントでの認証が要ります。

導入の前に済ませる5つの前提

ヘルプ記事は、プラグインの前に終えておく項目を挙げています。順番に確かめます。

手順

プラグインより先に終えること

  1. 1

    Noibuのアカウントを作る

    Noibuが会社とドメインを設定すると、ウェルカムメールが届きます。そのリンクからアカウントの設定を終えます。

  2. 2

    サイトにNoibuのスクリプトを入れる

    セッションとページ訪問のデータは、サイトに置いたスクリプトが集めます。早く入れるほど、プラグインを使い始める時点で見られるデータが増えます。

  3. 3

    Claudeのデスクトップアプリを入れる

    プラグインはCowork上で動きます。Claude Pro・Max・Team・Enterpriseのいずれかのアカウントが必要です。

  4. 4

    Windowsなら対応エディションを確かめる

    Windowsでは、仮想化機能(Hyper-V)が有効なPro・Enterprise・Educationが対象です。Homeは対象外です。

  5. 5

    TeamとEnterpriseは組織側の設定を見る

    Coworkへのアクセスとスキルが組織で有効になっている必要があります。

Windowsで Missing HCS services: HNS, vmcompute, vfpext と出るときは、Noibuのヘルプ記事が案内するCoworkが無効と表示される問題の手順に進みます。

Coworkに入れる手順(ヘルプ記事の経路)

ヘルプ記事の手順は、プラグインの追加とコネクタの有効化の2段です。

手順1: プラグインを追加する

ClaudeのPluginsページでNoibuを検索し、Addを押します。導入済みの確認メッセージが出たら次に進みます。TeamやEnterpriseのプランでは、管理者権限が要る場合があります。

手順2: Noibuコネクタを有効にする

ここが分かれ道です。プランによって操作する人が違います。

くらべる

コネクタを有効にする人はプランで変わる

本人が操作

Pro / Max

ConnectorsページでNoibuを選び、Connectを押します。求められたらNoibuのアカウントで認証します。

管理者 → 各ユーザー

Team / Enterprise

OwnerかPrimary Ownerが、Admin SettingsのConnectorsで組織向けにNoibuを有効にします。権限がない人の画面にはRequestボタンが出て、押すと管理者に承認が飛びます。有効になったあと、各ユーザーが自分のNoibuアカウントでConnectします。

コネクタ一覧では、NoibuはCommunityコネクタとして表示されます。ヘルプ記事によると、Communityコネクタは自動チェックを通ったもので、接続後の動作は検証済みコネクタと変わりません。ラベルはレビューの深さを表すだけです。組織側でコネクタを絞っている場合の考え方はClaude Enterpriseでコネクタを制限し社外アカウントの接続を防ぐ設定で扱っています。

Claude Desktopにzipで手動インストールする

プラグインディレクトリを使わない場合は、リポジトリのリリースからzipを取ります。

  1. https://github.com/Noibu/ai-plugin/releases/latest/download/noibu.zip をダウンロードする
  2. Claude DesktopでCustomizeを開く
  3. Create pluginからUpload pluginを選ぶ
  4. noibu.zip を上げる

この経路で入れたあとも、コネクタは別に接続します。ヘルプ記事は、手動でアップロードして独自コネクタを設定した場合の更新について、プラグインの再インストールを勧めています。既存のコネクタはそのまま動くので、やり直しは要りません。

Claude Codeにマーケットプレイスから入れる

Claude Codeでは、ダウンロードなしでリポジトリをマーケットプレイスとして追加します。

/plugin marketplace add Noibu/ai-plugin
/plugin install noibu@noibu-plugins
/reload-plugins

1行目がリポジトリの登録、2行目がインストール、3行目が読み込み直しです。noibu@noibu-plugins の後半は、マーケットプレイスの名前です。Claude Codeの仕様では、セッション内の /plugin install はその場で入れず、プラグインの詳細パネルを開いてスコープを選ばせます。選んだあと、再読み込みが必要な状態なら Run /reload-plugins to apply. と表示されます。

シェルから入れるなら、同じ内容を claude plugin で書けます。セットアップ用のスクリプトに組み込むときに向いています。

claude plugin marketplace add Noibu/ai-plugin
claude plugin install noibu@noibu-plugins

入れたプラグインがどれだけコンテキストを使うかは、claude plugin details で測れます。測り方はclaude plugin detailsでプラグインのコンテキスト消費を測るにあります。

Claude Codeでの認証については、リポジトリの開発手順に「Noibuで認証する」とあるだけで、画面の流れは書かれていません。claude.aiのコネクタをClaude Codeで読み込ませたくない環境では、disableClaudeAiConnectorsでClaude Codeのコネクタを一括無効化の設定が効きます。

導入後に何を聞けば売上に響くエラーが出るか

接続できたら、会話で分析を始めます。ヘルプ記事は、コンバージョン、導線の離脱、集客、ファネルの進行、ユーザー体験、技術的なエラーなどを探れると説明しています。

プラグインには、よく使う分析のスキルが入っています。

  • ストアの健全性チェック
  • チェックアウトのファネル分析
  • セグメントと商品の深掘り

呼び出し方は3つあります。チャット欄の下の + ボタン、スラッシュコマンド、目的に合う質問を投げる方法です。一覧とそれぞれの説明は、Customizeメニューのプラグイン画面で見られます。

最初にやっておきたいのは、スキルのBuild Business Contextです。ヘルプ記事は、実行を強く勧めています。自社の事業の仕組みを先に伝えておくと、一般的なECの想定ではなく、自社の実情に沿った分析になるためです。

リポジトリの例文から選ぶ

リポジトリのREADMEには、用途別の指示文の例が6つ載っています。エラーを拾う目的に近いのは次の3つです。

目的指示文の趣旨
技術的な問題の特定指示文の趣旨売上を最も損なっているエラーとパフォーマンスの問題を挙げ、解決を手伝わせる
チェックアウトの改善指示文の趣旨離脱の場所、使われた支払い・配送方法、コンバージョンを下げる技術的な問題を調べ、上位の修正に取り組ませる
利用者のつまずきの発見指示文の趣旨セッションリプレイと収益ヒートマップから、買い物客が困っている場所を挙げさせる

READMEの例では、残りに「毎週月曜に収益機会の上位を出させる」「閲覧されても売れていない商品を診断する」「キャンペーン別の流入の質を見て予算を動かす」があります。

エラーの優先度は、件数ではなく売上への影響で並べさせるのが、このプラグインの狙いに沿います。READMEの例文も、「最も売上を損なっているもの」という聞き方です。たとえば次のように頼みます。

直近7日間でチェックアウトの完了率を下げているエラーを、
推定の売上への影響が大きい順に5件挙げてください。
それぞれ、発生している画面と、直すときの最初の一手も添えてください。

これは筆者が組んだ聞き方の一例で、READMEの例文を土台にしています。Noibuのデータにどの指標が入っているかは、接続後にClaudeへ「使えるデータの項目を一覧にして」と聞くと確かめられます。

プラグインの更新はどう効くか

更新のされ方は、入れ方で変わります。

  • プラグインディレクトリから入れた場合: 自動で更新されます。何もしなくて構いません
  • zipを手動で上げた場合: 再インストールで最新にします。コネクタはそのまま使えます
  • Claude Codeのマーケットプレイスから入れた場合: リポジトリが更新を配る方式です

最後の方式には仕掛けがあります。READMEによると、plugin.json にはあえてバージョン欄を置いていません。バージョン欄が無いと、マーケットプレイスはコミットのSHAでバージョンを判断するため、mainへのマージのたびに新バージョンとして扱われます。READMEは、これでClaude Codeが自動更新されると説明しています。

ここで一点、注意があります。Claude Codeの設定リファレンスでは、extraKnownMarketplaces の autoUpdate を省略したとき、公式のAnthropicのマーケットプレイスは既定で true、サードパーティのマーケットプレイスは既定で false と書かれています。個人で /plugin marketplace add して入れた場合、更新の通知や反映がどう見えるかは、/plugin の画面で確かめるのが確実です。更新を確実に追わせたいなら、次の配布設定のように autoUpdate を明示します。

チームのClaude Codeに配る

READMEには、MDMで管理設定の managed-settings.json を配る案内があります。マーケットプレイスの追加と、プラグインの有効化を一度に済ませる方法です。設定リファレンスのキー構造に合わせると、例えば次の形になります(READMEの記述を設定の書式に写したもので、noibu-plugins はマーケットプレイスの名前です)。

{
  "extraKnownMarketplaces": {
    "noibu-plugins": {
      "source": { "source": "github", "repo": "Noibu/ai-plugin" },
      "autoUpdate": true
    }
  },
  "enabledPlugins": {
    "noibu@noibu-plugins": true
  }
}

この設定で、マーケットプレイスの登録とプラグインの有効化がチームの全員に届きます。配布前に、導入済みの一覧は claude plugin list --json で棚卸しできます。出力の読み方はclaude plugin list --jsonで導入済みプラグインを棚卸しするに載せています。

なお、リポジトリは次の2つの経路に配られています。Claude Codeはこの公開リポジトリから直接入り、Coworkは非公開のミラーリポジトリから配られます。mainにプッシュされるたび、パッチバージョンが上がったzipがリリースされます。

つまずいたときの切り分け

導入でよく止まる箇所を、症状から引けるようにまとめます。

切り分け

Noibuに質問しても数字が返らないとき

  1. QNoibuのスクリプトはサイトに入っていますか?
    答えが先にサイトへの設置を終える

    データはスクリプトが集めます。設置が遅いと、見られるデータが少ないままです。

    答えがはい
  2. QConnectorsでNoibuは接続済みですか?
    答えがConnect を押して認証する

    TeamとEnterpriseでは、組織側の有効化が先です。Requestボタンが出ているなら管理者の承認待ちです。

    答えがはい
  3. QClaude Codeなら、プラグインを読み込み直しましたか?
    答えが/reload-plugins を実行する

    入れた直後は、読み込み直すまでスキルが並びません。

    質問を、チェックアウトやエラーなど対象を絞った形に変えます。Build Business Contextを済ませているかも確かめます。

プラグインの導入そのものが失敗するときは、症状ごとの記事が参考になります。パッケージ未導入の警告は「packages are not installed」と出るClaude Codeプラグインの対処、改ざん検知のエラーは「archive integrity check」の対処で扱っています。

導入を決める前に押さえる条件

最後に、費用と権限の面で決めておく点を挙げます。

  • Noibuの契約とスクリプトの設置が前提で、Claude側のプランだけでは完結しません
  • CoworkはPro・Max・Team・Enterpriseのアカウントが条件です
  • TeamとEnterpriseでは、コネクタの有効化に管理者の手が要ります
  • 利用すると、NoibuのMCP利用規約とプライバシーポリシーへの同意が前提になります

ECの売上に響く問題を探すのは、「どのエラーが、どの画面で、どれだけ収益を削っているか」を言葉で聞ける点が強みです。反対に、数字の出どころはNoibuのデータだけです。Claudeが読み取れるのは、スクリプトが集めた範囲に限られます。

この記事を共有:XはてブLinkedIn