← ラボ / Claude Code ガイド / 連携台帳

BigCommerce Holdings, Inc.・ネットショップ・海外 公式サイト
BigCommerce が提供するSaaS型のネットショップ(EC)プラットフォーム。公式の開発者サイトに、REST/GraphQL API、Stencil CLI、MCP サーバー(ストアフロント用・ドキュメント検索用)がある。

Claude Codeに、どこまで権限を渡せるか

読み取り専用で渡せるか あり
API: store-level/account-level のAPIアカウントは、スコープの多くに read-only 版と modify 版があり、read-only は GET/HEAD だけに制限される(例: store_v2_products_read_only、store_v2_orders_read_only)。https://docs.bigcommerce.com/developer/docs/overview/api-fundamentals/api-accounts 。ストアフロント用MCPは管理データ(注文・顧客・在庫の変更)を扱わず、確認できたツールは商品検索・商品詳細・カート作成/更新・チェックアウトリンク作成。ドキュメント用MCPはドキュメント検索のみで、ストアの読み取りも変更もできない(公式)。
権限(スコープ)を選べるか あり
store-level APIアカウントは作成時にOAuthスコープを選び、作成後はトークンもスコープも変更できない。app-level はスコープをあとから変更でき、変更するとトークンが更新される。公式は『必要最小限のスコープに』と記載。ストアフロント用MCPはスコープの記載なし(ストアオーナーがコントロールパネルでオン/オフ)。
危険な操作の既定
ストアフロント用MCP: 削除・支払いのツールが一覧にない。チェックアウトリンクを出すまでで、決済実行の記載なし。MCP側の確認プロンプトの記載なし(クライアントの手動許可はクライアント側の機能)。API/CLI: スコープ次第で、既定の確認の記載なし。
削除ができるか できる
今回確認できた範囲: Stencil CLI の push --delete(上限到達時に最も古い非アクティブのプライベートテーマを削除)、APIアカウントの削除、account-level の Users スコープの delete。REST APIでの商品・注文の削除は今回のページでは未確認。ストアフロント用MCPとドキュメント用MCPには削除ツールなし。
取り消し方(キー・接続)
store-level: 『アクセストークンは時間で失効せず、手動で無効化できない』ため、そのAPIアカウントを削除する(削除は復元できない)。app-level: 手動の取り消し・再発行はできず、アプリのスコープ変更やストアオーナーのメール変更でトークンが更新される。account-level: コントロールパネルのアクション列から Delete。ストアフロント用MCPは、有効化した設定(Settings → Early Access / MCP settings)をストアオーナーがオフにする、と読めるが取り消し手順の明記は未確認。

根拠のページ

つなぎ方(公式の資料にある範囲)

公式MCP あり

公式に2種類ある。(1) ストアフロント用 MCP サーバー: 公式の3つの出典で書かれていることが食い違う。【beta ページ(https://developer.bigcommerce.com/beta/mcp-server)】「currently in Private Beta via the AI Labs program」「Access is required before you can enable」とあり、利用にはアクセス権が必要。ストアは有効で取引(transactional)でないことが条件。コントロールパネルの Settings → Advanced → Early access で有効化すると店舗固有のURLが表示される。認証は不要でゲストのみ。ツールは商品検索・商品詳細・カート作成・カート更新・チェックアウトリンク作成。クライアントは Claude Desktop/Cursor/Warp/自作エージェント(Claude Code のコマンドの記載なし)。更新日の記載なし。【overview ページ(https://docs.bigcommerce.com/developer/api-reference/mcp/overview)】Private Beta の記載なし。「store owner が Storefront MCP のトグルをオンにし、規約に同意」とある。B2C はゲストとログイン済み、B2B は Buyer Portal の認証済みユーザー(ショッピングリスト・見積)。Stencil 店舗は同期トークン(X-Bc-Storefront-Sync-Token)、エンドポイントは POST /api/mcp。個別のツール名は書かれていない。Claude Code のコマンドの記載なし。更新日の記載なし。【BigCommerce 公式ブログ「Storefront MCP Is Now Live」(https://www.bigcommerce.com/blog/storefront-mcp/、2026-05-11付)】「now available to every store on the platform」とあり、store owner が Settings → Early Access でオプトインする。「any live store that processes transactions can opt in」と書かれ、beta ページの「取引ストアでないこと」と条件が逆。開始時はゲストのみで「Coming next is authenticated shopping」(ログイン済みは次の対応)。B2B の記載なし。決済はチェックアウトURLを渡して引き継ぐのみ。beta ページ・overview ページ・ブログのどれが現行かは、公式ページからは判断できない(beta ページは Private Beta、ブログは全ストアに提供と書いている。ログイン済み・B2B対応は overview ページだけの記載)。最新の状態は、店舗のコントロールパネル(Settings → Early Access)で有効化できるかで確認する必要がある。 (2) 開発者ドキュメント検索用 MCP: 『ドキュメント検索のみ。ストア・注文・カタログ・アカウント設定の読み取り・変更はできない』と公式にある。

つなぎ方(公式の記載)
ドキュメント検索用(公式ページの記載): claude mcp add --transport http docs-bigcommerce-com https://docs.bigcommerce.com/_mcp/server(全プロジェクトなら --scope user を付ける)。ストアフロント用MCPは、Claude Code の追加手順はどの公式ページにも記載なし(beta ページに Claude Desktop 向けの npx mcp-remote <YOUR_MCP_SERVER_URL> の設定のみ。Node 18 以上)。ai-agent-setup ページには、ストアフロントに対しては BigCommerce MCP Server を参照するとの記載がある。

根拠のページ

公式CLI あり

Stencil CLI。ストアフロントのテーマを開発・デプロイするコマンドラインツール(init / start / bundle / pull / download / push / release)。push でテーマをアップロードし、チャンネルで有効化でき、--delete で『上限に達した場合に最も古い非アクティブのプライベートテーマを削除』する。商品・注文などストアデータの管理ツールではない。Catalyst 用CLI等は今回未確認。

根拠のページ

公式API あり

REST/GraphQL Admin API 等。V3 API は OAuth でのみ利用可(公式)。APIアカウントは store-level/app-level/account-level の3種。スコープは多くが read-only と modify の2段階で、商品・注文・顧客・カート・チェックアウト・コンテンツ・決済関連(payments methods、stored payment instruments、payment access token creation)などがある。

根拠のページ

第三者製MCP(公式ではない) 1件

第三者製のMCPは、サービスの運営元が作ったものではありません。作者と中身を確かめてから使うかどうかを決めてください。ここに載せているのは、公式のレジストリやGitHubで見つかったものを、書かれている範囲でまとめたもので、おすすめではありません。

探した場所(4件)

できる操作

読み取りでできる操作

  • 【MCP】商品検索、商品詳細の取得(ストアフロント用)。ドキュメント検索(ドキュメント用)
  • 【MCP】B2B: ショッピングリスト・見積(overview ページのみの記載。beta ページ・ブログはゲストのみ、ブログはログイン済みを「次に対応」と書く)
  • 【API】store-level APIアカウントのスコープで、商品・注文・顧客などの読み取り(read-only スコープ)
  • 【CLI】Stencil CLI の download / pull で、ライブテーマのファイル・設定をローカルへ取得

書き込みでできる操作

  • 【MCP】カートの作成・更新、チェックアウトリンクの作成(購入の確定ではなくリンクの提示。公式のツール名: creating a cart, updating a cart, creating a checkout link)
  • 【API】modify スコープでの商品・注文・顧客などの更新
  • 【CLI】Stencil CLI の push でテーマをアップロード・チャンネルで有効化

管理者操作(削除・課金・設定変更など)

  • 【CLI】push --delete: 上限に達した場合に最も古い非アクティブのプライベートテーマを削除
  • 【API】store-level APIアカウントの削除は永続的で、Webhook も残らない(公式)。account-level は Users スコープに read-only/write/delete がある
  • 【MCP】ストアフロント用は削除ツールが一覧にない。ドキュメント用はストアを変更できない(公式)

制限

  • ストアフロント用MCP(beta ページ): Private Beta(AI Labs)でアクセス権が必要。ストアが有効状態で取引(transactional)でないことが条件と記載。有効化後、使えるまで最大10分。一方、2026-05-11付の公式ブログは「全ストアに提供」「取引を行うライブストアがオプトインできる」と書き、Private Beta・取引ストアの条件は beta ページと逆。どちらが現行かは不明
  • ドキュメント用MCPはドキュメント検索のみ(公式)
  • legacy API アカウントは新規ストアには発行されない(公式)
注意
  • ストアフロント用MCPは公式の出典3つで説明が食い違う: beta ページは『Private Beta・ゲストのみ・認証なし・取引ストアでないこと』、overview ページは『Private Beta の記載なし・B2C/B2B・ログイン済み・同期トークン』、2026-05-11付の公式ブログは『全ストアに提供・取引を行うライブストアがオプトイン・開始時はゲストのみ(ログイン済みは次に対応)』。どれが現行かは確認できていない
  • チェックアウトリンクの作成までで、決済実行の可否は公式ページに記載なし
  • store-level APIアカウントの削除は永続的で、Webhookも残らない(公式)

認証・料金・日本語・実機検証

認証方式
【MCP】ストアフロント用: beta ページは認証なし(ゲストのみ)、ブログも開始時はゲストのみ。overview ページは B2C はゲストとログイン済み、B2B は認証済み Buyer Portal ユーザー、セッション連携に X-Bc-Storefront-Sync-Token ヘッダーと記載(この点は beta ページ・ブログと食い違う)。【API】OAuth(APIアカウント、X-Auth-Token ヘッダー)。【CLI】APIトークン(--token)。
公表されている料金(2026年10月16日確認)
BigCommerce 料金ページ(米ドル・税別・2026-10-16確認): Core 月払い $39/年払い換算 $29/月、Growth $105/$79、Scale $399/$299、Performance は年払いで $1,499/月〜のカスタム。15日間の無料トライアル(クレジットカード不要)。Core・Growth・Scale は契約なしで解約可、Performance のみ契約。 料金ページ
日本語対応
未確認。検索結果で日本語の公式ページ(bigcommerce.jp 等)は確認できなかった。開発者ドキュメントに日本語版があるかも未確認(Localizing Stores の英語ページが出たのみ)。管理画面の日本語対応も未確認。
Claude Code実機検証
未検証(この台帳は、動かして確かめた記録ではありません。Akiraが試したときは、検証日つきで書き換えます)
確認できていない点(7件)
  • API accounts ページの末尾約13,000文字は未読
  • REST API での商品・注文・顧客の削除の記載、レート制限、返金・決済まわりのAPIは未確認
  • Stencil CLI のインストール手順、必要スコープは未確認。Catalyst 関連のCLIは未確認
  • ストアフロント用MCPの3つの出典(beta ページ・overview ページ・2026-05-11付ブログ)の食い違いの解消は未確認(Private Beta か全ストア提供か、取引ストアの条件、ログイン済み・B2B対応の有無)。beta ページ・overview ページには更新日の記載なし
  • 日本語対応は未確認
  • 対応プラン・地域の制限は記載を確認できなかった
  • 第三者製MCPは isaacgounton/bigcommerce-api-mcp の1件のみ確認(網羅的な調査ではない)
出典(8件)

この台帳は、公式の資料を読んだ範囲のことで、動かして確かめたものではありません。確認日: 2026年10月16日。

ラボの資料は、公式の文書を読んでまとめたもので、実際に使って確かめた記録ではありません。日付や仕様は変わるので、使う前に各ページの出典で確かめてください。事実と「僕らの見立て」は、分けて書いています。