BigCommerce
Claude Codeに渡せる権限の範囲と、つなぎ方を、公式の資料から読み取れる範囲でまとめました。
← ラボ / 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件
- isaacgounton/bigcommerce-api-mcp(作者: 個人・最終更新: 未確認(最終コミット日は読めず。コミット15、スター5))
書き込み・削除: READMEに、読み取り(商品・顧客・注文・カテゴリ・ブランド等)と、書き込み(create_product/update_product/create_customer/update_customer/update_order)とある。削除ツールの記載なし、注文作成なし。読み取り専用の仕組みあり: 書き込みツールは BIGCOMMERCE_ENABLE_WRITES=true にしない限り登録されない(既定は読み取りのみ)。
MIT。BIGCOMMERCE_STORE_HASH と BIGCOMMERCE_API_KEY(管理画面で作ったAPIアカウント)を使う。HTTP で動かす場合は MCP_AUTH_TOKEN、HOST の既定は 127.0.0.1。
https://github.com/isaacgounton/bigcommerce-api-mcp
第三者製のMCPは、サービスの運営元が作ったものではありません。作者と中身を確かめてから使うかどうかを決めてください。ここに載せているのは、公式のレジストリやGitHubで見つかったものを、書かれている範囲でまとめたもので、おすすめではありません。
探した場所(4件)
- WebSearch「BigCommerce MCP server official developer docs」の検索結果一覧(CData など第三者の名前が出たが個別ページは開いていない)
- registry.modelcontextprotocol.io の検索(取得エラーで読めず)
- https://github.com/isaacgounton/bigcommerce-api-mcp
- https://glama.ai/mcp/servers/@isaacgounton/bigcommerce-api-mcp/…(robots により取得不可。GitHub本体で代替)
できる操作
読み取りでできる操作
- 【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件)
- BigCommerce MCP Server(BigCommerce)(確認日 2026-10-16)
- MCP Server Overview(BigCommerce)(確認日 2026-10-16)
- AI Agent Setup(BigCommerce)(確認日 2026-10-16)
- API accounts(BigCommerce)(確認日 2026-10-16)
- Stencil CLI Options and Commands(BigCommerce)(確認日 2026-10-16)
- Pricing(BigCommerce)(確認日 2026-10-16)
- Storefront MCP Is Now Live(BigCommerce 公式ブログ、2026-05-11付)(確認日 2026-10-16)
- isaacgounton/bigcommerce-api-mcp(GitHub・第三者製)(確認日 2026-10-16)
この台帳は、公式の資料を読んだ範囲のことで、動かして確かめたものではありません。確認日: 2026年10月16日。
ラボの資料は、公式の文書を読んでまとめたもので、実際に使って確かめた記録ではありません。日付や仕様は変わるので、使う前に各ページの出典で確かめてください。事実と「僕らの見立て」は、分けて書いています。