これが失敗するとき、たいてい静かです。手順書どおりに JSON をクライアント設定へ貼り、再起動すると動きます。ツール一覧が現れ、接続は緑。そこで「昨日の注文はどうだった」と尋ねると、役に立つ答えが返らず、理由も分かりません。
原因は、Shopify が二つの異なる MCP サーバーを出しており、簡単に入るほうはあなたの店を見られないことです。
二つのサーバー
Shopify は 2026 年 4 月に AI Toolkit をオープンソース化し、公式の MCP サーバー群、エージェントスキル、Claude Code 用プラグインを一つの名前空間にまとめました。その中に、しばしば混同される二つがあります。
Dev MCP はローカルで動き、ログイン不要で、アシスタントに Shopify の開発者ドキュメントと API スキーマを渡します。Shopify アプリを書く人のためのもので、その仕事には本当に向いています。昨日の注文を読むことも商品を編集することもありません。設計上、稼働中のストアに触れないからです。
Admin MCP が実際のストアデータを扱うほうで、Admin API のトークンを必要とします。そのトークンが違いのすべてであり、設定コストのすべてでもあります。
Shopify 上で開発しているなら、Dev MCP を入れてここで読むのをやめて構いません。無料で公式で、この記事はそれを置き換えようとしていません。ストアを運営していて、それについて質問したいなら、必要なのはもう一方です。
Admin 経路が実際に求めるもの
自分のストア管理画面でカスタムアプリを作り、必要な Admin API のアクセススコープを付与し、得られたトークンを保管します。ここに、判断を誤りやすい三点があります。
一つ目はスコープの広さです。狭すぎれば、失敗は後になって呼び出し時に、チャット応答の中の読み取りにくい認可エラーとして現れます。すべて与えれば、カタログを書き換えられるトークンをノート PC の設定ファイルの中に作ったことになります。
二つ目はトークンの置き場所です。JSON 設定に平文で書くのは多くの手順書が示す既定で、書く指示として最短だからです。商品を公開できる資格情報に対して、自分から選ぶやり方ではありません。
三つ目は更新です。トークンは、作った理由より長く生き残ります。設定手順の中に、それを思い出させるものはありません。
読み取りと書き込みは同じリスクではない
先週どの SKU が売り切れたかを尋ねるのは読み取りです。安価で可逆で、答えが違っていても気づいて先へ進めます。
価格の変更、商品説明の編集、販売チャネルへの公開。これらは今まさに客が買い物をしている稼働中のストアに対して走ります。プロトコルはこの区別について意見を持ちません。MCP はツールとその引数を記述しますが、「これは取り消せない」という概念は運びません。
つまりゲートはクライアント側にある必要があります。モデルがツール呼び出しを出した瞬間に実行するクライアントなら、読み違えた指示と価格が書き換わったカタログの間に立っているのは、モデルの調子が良いことだけです。誰も意図してそのリスクの形を選びません。手順書から受け継いでしまうのです。
他のどのプラットフォームでも同じ形
eBay、Etsy、WooCommerce にもコミュニティ製の MCP サーバーがあり、話はほぼそのまま繰り返されます。自分で生成するトークンか鍵ペア、スコープの判断、動かし続けるローカルプロセス、そして書き込みを任せられるだけ信頼しなければならないクライアント。四つのプラットフォームで売るセラーがこの道を選ぶと、最後には四つの小さなサービスを運用し、四つの資格情報を保管することになります。誰も計画に入れなかった、実在する仕事です。
この話における Orkas の位置
Orkas は MCP クライアントなので、上記のどのサーバーも他のクライアントと同じように使えます。独自の Shopify Admin コネクタも同梱しており、商店主が所有する Dev Dashboard アプリの上に構築されています。要点は二つの細部にあります。
スコープは接続時に検証されます。呼び出しが失敗してからではありません。Orkas は必要なスコープを一つずつ確認します。商品、注文、顧客、在庫、ロケーション、下書き注文、返品、割引、公開、および該当するフルフィルメント注文のスコープ。会話を一往復費やして突き止める前に、欠けているものを伝えます。資格情報は設定ファイルではなく、ご自身の端末内で暗号化されます。
そして書き込みのゲートはプロンプトではなくクライアントにあります。書き込み・削除・課金・稼働中ストアへの操作はすべて許可確認を通り、取り消せない操作は通常の操作とは別のゲートを通ります。同じコネクタカタログが eBay、Etsy、Walmart Marketplace、WooCommerce、Amazon セラーセントラル、そして中国系プラットフォームまでをカバーするため、「四つのサービス」問題が店舗ごとに再発することはありません。
この記事が扱っていない範囲
以上のどれも、Orkas をストア管理システムにするものではありません。在庫を保持せず、注文をルーティングせず、自動価格改定もしません。それが必要なら ERP はそのままに。置き換わるのは、自分のストアに問いを立て、その答えに基づいて動くために本来組み上げることになる小さな統合の山です。そして「動く」側については、モデルの調子が良ければ十分だという前提です。