インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Shoptet をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
Shoptet ネットショップ（チェコ、スロバキア、ハンガリー）を読み取り専用で利用：履歴とメモ付きの注文、価格と在庫付きの商品とバリエーション、カテゴリー、ブランド、在庫数と在庫移動、顧客、請求書、プロフォーマ請求書、クレジットノート、支払方法と配送方法。
こう聞いてみよう
Shoptet のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Shoptet をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Shoptet + Gemini
Shoptet ネットショップ（チェコ、スロバキア、ハンガリー）を読み取り専用で利用：履歴とメモ付きの注文、価格と在庫付きの商品とバリエーション、カテゴリー、ブランド、在庫数と在庫移動、顧客、請求書、プロフォーマ請求書、クレジットノート、支払方法と配送方法。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
SHOPTET_API_TOKEN
ステップ 1 — 認証情報を取得
セットアップは約 3 分です。プライベート API は Premium でしか使えないため、Shoptet Premium のネットショップと、その管理画面へのアクセスが必要です。
- Shoptet の管理画面で Connections (Propojení), Private API を開き、トークンを作成します。
- AI に見せたい領域（注文、商品、在庫、顧客、書類）への読み取り権限をトークンに付与します。トークンが読めない領域は 403 を返します。
- トークンを
SHOPTET_API_TOKENに貼り付けます。スペースや引用符は付けず、トークンだけを入れてください。 - コネクターをインストールし、
shoptet_get_eshopを実行します。ショップ名、URL、通貨、言語、タイムゾーンが表示され、トークンが有効であることを確認できます。
1 つのトークンで 1 つのショップ: トークンは 1 つのネットショップにだけ属します。.cz と .sk のショップを運営している場合は、もう一方のショップのトークンでコネクターをもう一度インストールします。
読み取れるデータ: ショップの設定、請求先と配送先住所、明細、税込と税抜の価格、ステータス、入金済みフラグ、支払方法と配送方法、販売チャネル、メモ、追跡番号を含む注文、注文の全履歴（ステータス変更、送信されたメール、備考）、コード、EAN、価格、税率、在庫状況、在庫数（必要なら倉庫別）を含む商品とバリエーション、カテゴリーとブランド、注文で引き当て済みの数量を含む在庫数と在庫移動、住所、会社番号と VAT 番号、顧客グループを含む登録顧客、バリアブルシンボル、支払期日、VAT 内訳を含む請求書、プロフォーマ請求書、理由付きのクレジットノート（opravné daňové doklady）、そして支払方法と配送方法です。
まずショップの設定から: 注文ステータス、注文ソース、倉庫、カテゴリー、ブランドはショップごとに異なります。そのため AI はまず shoptet_list_order_statuses や shoptet_list_stocks などでショップの ID を読み取り、それを使って絞り込みます。商品は、管理画面や注文に表示されるコード（SKU）から shoptet_get_product_by_code で探せます。
ページ、時刻、価格: 注文は新しい順に 1 ページ最大 50 件、商品は 1 ページ 1 から 100 件、クレジットノートは 1 ページ最大 20 件です。各一覧には総ページ数が含まれ、AI は必要なときだけ次のページを取得します。時刻は 2026-10-20T00:00:00+0200 のようにオフセット付きで、チェコとスロバキアのショップは Europe/Prague 時間です。価格は CZK や EUR などショップの通貨で返ります。
読み取り専用: このコネクターには何かを変更するツールがありません。注文やそのステータス、商品、価格、在庫、顧客を変更できないため、AI があなたに確認を求める操作はありません。
制限: Shoptet ではトークンごとに同時に 3 リクエストまで送れ、集中したアクセスは 429 で抑えられます。その場合 AI は数秒待ってから再試行し、ショップ全体をページ送りせず必要なものだけを取得します。
よくあるエラー: 401 の expired-token または invalid-token は、トークンが削除されたか期限切れであることを示します。新しいトークンを作成してください。403 の invalid-token-no-rights は、トークンにその領域へのアクセス権がないことを示します。Private API で権限を編集してください。404 は、そのコードの注文、商品、書類が存在しないことを示します。
このコネクターは、注文、商品、価格、在庫、顧客の作成や変更、請求書やクレジットノートの発行、顧客へのメール送信は行いません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Gemini にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、
geminiを再起動します。 - Gemini CLI で
/mcpを実行します（またはシェルでgemini mcp list）。anythingmcpが接続済みとして表示されるはずです。 - プロンプトを入力しましょう。Gemini CLI が
Shoptetのツールを呼び出せるようになりました。
利用可能なツール
| Tool | What it does |
|---|---|
shoptet_get_eshop | Get the e-shop's own settings: name, URL, contact and billing details, VAT payer, time zone, default price list, currencies and languages.… |
shoptet_list_orders | List orders, newest first, at most 50 per page: code, creation and change time, customer name, e-mail and phone, status, paid flag, total… |
shoptet_get_order | Get one order by its code (order number): billing and delivery address, items with code, name, amount, unit price and VAT, prices, status… |
shoptet_get_order_history | Get the history of an order: every status change, e-mail sent, remark and system event with time, text and the user who did it |
shoptet_list_order_statuses | List the order statuses of the shop (they differ from shop to shop): id, name, whether it is a system status, whether it marks the order… |
shoptet_list_order_sources | List the order sources of the shop (e-shop, cash desk, marketplaces, imports) with id and name |
shoptet_list_products | List products, 1 to 100 per page: guid, name, type, visibility, default category, brand, supplier, URL and rating |
shoptet_get_product | Get one product by guid with its variants: code, EAN, price, VAT rate, stock amount, availability, weight and parameters per variant… |
shoptet_get_product_by_code | Get a product by the code of the product or of one of its variants (the SKU shown in the admin and on orders), with the same details and… |
shoptet_list_categories | List the product categories: guid, name, parent guid, visibility and URL |
shoptet_list_brands | List the brands (manufacturers) of the shop: guid, code, name, web and whether they show in the brand list |
shoptet_list_stocks | List the stocks (warehouses) of the shop with id, title and whether they are a pickup point, plus the default stock id |
shoptet_list_stock_supplies | List the stock levels in one stock: product guid, code, amount in stock, claimed amount (reserved by orders) and storage location |
shoptet_list_stock_movements | List stock movements in one stock, oldest first: product code, amount after the change, the change, time and who or what changed it (an… |
shoptet_list_customers | List registered customers: guid, billing name and company, creation and change time and admin link |
shoptet_get_customer | Get one registered customer: billing and delivery addresses, company id and VAT id, customer group, price ratio, remark and account e-mails |
shoptet_list_customer_groups | List the customer groups (e.g. retail, wholesale, VIP) with id, name, default price list and maximum discount |
shoptet_list_invoices | List invoices: code, order code, issue, due and tax dates, billing name and company, variable symbol, paid flag and price |
shoptet_get_invoice | Get one invoice by its code: items, prices and VAT breakdown, billing and delivery address, payment method, due date, paid flag and symbols |
shoptet_list_credit_notes | List credit notes (opravné daňové doklady): code, invoice and order code, date, billing name, reason and price |
shoptet_list_proforma_invoices | List proforma invoices (advance invoices): code, order code, date, billing name, paid flag and price |
shoptet_list_payment_methods | List the payment methods of the shop with guid, name, type, visibility and whether they are for wholesale or in-person payment |
shoptet_list_shipping_methods | List the shipping methods of the shop with guid, name, carrier, tracking URL and visibility |
プロンプトの例
- 「昨日の注文のうちまだ入金されていないものはどれですか。それぞれの合計を CZK で教えてください。」
- 「注文 2026000123 の履歴を見せてください。ステータスがいつ変わったか、顧客にどのメールが送られたか、追跡番号も知りたいです。」
- 「メイン倉庫で在庫が少なくなっている商品はどれですか。それぞれ注文で引き当て済みの数量も教えてください。」
- 「[email protected] の今年の注文をすべて探して、まだ支払われていない請求書を教えてください。」
- 「今月発行したクレジットノートを、理由、金額、対応する請求書と一緒に一覧にしてください。」
FAQ
Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。
次のステップ
このガイドは役に立ちましたか?
