概要
AI から Loja Integrada のストアを運営します。商品の検索、在庫と価格の更新、商品・カテゴリー・ブランドの作成、注文の確認、注文ステータスの変更、追跡番号の登録、顧客の検索ができます。公式 API v1 を使用します。
ガイド付きセットアップ
Loja Integrada を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Loja Integrada を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Loja Integrada のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Loja Integrada をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Loja Integrada + Microsoft Copilot
AI から Loja Integrada のストアを運営します。商品の検索、在庫と価格の更新、商品・カテゴリー・ブランドの作成、注文の確認、注文ステータスの変更、追跡番号の登録、顧客の検索ができます。公式 API v1 を使用します。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
LOJA_INTEGRADA_API_KEY, LOJA_INTEGRADA_APP_KEY
ステップ 1 — 認証情報を取得
両方のキーがそろえば、セットアップは約 5 分です。ただし、アプリケーションキーが届くまでに 5〜10 営業日かかります。有料プランの Loja Integrada ストアとそのストア管理画面へのアクセス、そして Loja Integrada が連携用に発行するアプリケーションキー（chave de aplicação）が必要です。
- ストア管理画面で Configurações → Chave para API を開き、Cadastrar nova chave をクリックして、20 文字のキーを
LOJA_INTEGRADA_API_KEYにコピーします。chave_apiを付けず、キーだけを貼り付けてください。API キーは有料プランでのみ利用できます（Loja Integrada のヘルプ）。 - このヘルプ記事 にあるインテグレーター向けフォームで、Loja Integrada にアプリケーションキー（chave de aplicação）を申請します。フォームには API を呼び出す IP アドレスを記入します。セルフホストならサーバーのアドレス、AnythingMCP Cloud なら、Cloud がすべての呼び出しに使う固定の IPv4 アドレス
104.248.242.235です。送信元アドレスはコネクタのセットアップページにも表示されます。Loja Integrada からの回答には 5〜10 営業日かかります。 - アプリケーションキー（
dc6049f0-1234-...のような UUID）をLOJA_INTEGRADA_APP_KEYに入力します。aplicacaoを付けず、キーだけを貼り付けてください。 - コネクターをインストールし、
loja_integrada_list_order_statusesで接続を確認してください。
アプリケーションキーは登録した IP アドレスからしか使えません: Loja Integrada は、キーに登録されていないアドレスからの呼び出しを拒否します。アドレスが変わる場合（新しいサーバー、Cloud への移行や Cloud からの移行など）は、呼び出しが失敗し始めないよう、切り替える前に同じフォームで新しいリストを送ってください。
Cloud とセルフホストは同じ手順です: 違うのは、アプリケーションキーに登録する IP アドレスだけです。
2 つのキーは 1 つのヘッダーで送られます: すべての呼び出しは Authorization: chave_api <API key> aplicacao <application key> を送信し、AnythingMCP が 2 つの変数からこれを組み立てます。Personal Token によるログイン（Authorization: Basic ...）はこのコネクターでは使いません。
レート制限: Loja Integrada が許可するのはストアごとに 1 分あたり 100 リクエストまでで、それを超えると 429 を返します。呼び出しを繰り返すのではなく、一覧をページごとに読み取らせてください。429 が返ったら 1 分待ちます。
ID と参照: 商品、カテゴリー、ブランド、顧客には数値の ID（202591789）があり、注文は注文番号（numero、例: 164）で指定します。レコード同士は /api/v1/categoria/15246059 のような URI（resource_uri フィールド）で参照し合い、商品の categorias、marca、pai にはそのまま渡します。id_externo を 1 にすると、商品や価格を自社の外部 ID で検索します。
ページ送り、価格、日付: 一覧はデフォルトで 1 ページ 20 件、最大 50 件で、meta.next が null になるまで limit と offset でページ送りします。meta.total_count が総件数です。価格は BRL で、"32.83" のような文字列で返ります。日付フィルターは YYYY-MM-DD 形式で、時刻の指定は任意です。
商品、バリエーション、在庫、価格: バリエーションのある商品は、親商品（tipo atributo）と、バリエーションごとの子商品（tipo atributo_opcao、pai に親を指定）で構成されます。loja_integrada_list_grids と loja_integrada_get_grid で、サイズや色などのバリエーショングリッドの値を確認できます。価格と在庫は別のレコードで、商品を作成した後に設定します。在庫は差分ではなく絶対数で、バリエーションごとに設定します。更新は商品全体を置き換えるため、AI はまず商品を読み取り、すべての項目を送り直します。省いた項目は空になることがあります。
よくあるエラー: 401 は Loja Integrada がキーを拒否したことを示します。LOJA_INTEGRADA_API_KEY、LOJA_INTEGRADA_APP_KEY、そしてアプリケーションキーがコネクターの IP アドレスに登録されているかを確認してください。403 はキーは読み取られたもののアクセスが拒否されたことを示し、アプリケーションキーに登録されていないアドレスから呼び出されています。429 はレート制限です。
読み取れるデータ: SKU、種類（通常商品、バリエーションのある親商品、バリエーション）、カテゴリー、ブランド、サイズと重量、NCM と GTIN、画像、バリエーショングリッドを含む商品、引当数と有効在庫数を含む在庫、定価、セール価格、原価、カテゴリー、ブランド、値を含むバリエーショングリッド、顧客、請求先と配送先の住所、明細、支払い、追跡番号付きの発送、ステータス、合計を含む注文、注文ごとのステータス履歴、ストアの注文ステータスと支払方法、そしてメールアドレス、CPF または CNPJ、電話番号、住所を含む顧客です。
書き込みツールはインストール時からオンです: オフになっているツールはありません。コネクターは商品、カテゴリー、ブランドの作成、商品の編集、在庫と価格の設定、注文ステータスの変更、追跡番号の登録を行い、いずれも本番のストアに反映されます。ステータスを変更すると購入者にメールが送られることがあり、キャンセルのような最終ステータスは元に戻せません。不要なものはコネクターのページでオフにしてください。AI は変更のたびに事前にあなたの確認を取ります。
削除は行いません: データを削除するツールや注文を作成するツールはありません。商品画像、クーポン、SEO、Webhook、請求書（NF）、マーケティング、Enviali の配送ラベルもこのコネクターでは扱いません。
ステップ 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 — Microsoft Copilot にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name（例:
AnythingMCP）、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
Loja Integradaのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
loja_integrada_list_products | List the store's products, 20 per page: id, sku, nome, tipo (normal, atributo = parent with variations, atributo_opcao = variation), ativo… |
loja_integrada_get_product | Read one product by its Loja Integrada id (or by your id_externo): name, SKU, type, active and featured flags, categories, brand… |
loja_integrada_create_product | Create a product. tipo normal is a simple product; atributo creates a parent for variations, and each variation is then created with tipo… |
loja_integrada_update_product | Update a product |
loja_integrada_list_stock | List the stock records of all products, 20 per page: produto URI, quantidade (quantity), quantidade_reservada (reserved by orders)… |
loja_integrada_get_stock | Read the stock of one product or variation: quantity, reserved and available quantity, whether stock is managed, and the availability… |
loja_integrada_update_stock | Set the stock of one product or variation: quantidade (absolute quantity, not a delta), gerenciado (track stock) and the availability ids… |
loja_integrada_list_prices | List the prices of all products, 20 per page: produto URI, cheio (list price), promocional (sale price), custo (cost) and sob_consulta… |
loja_integrada_get_price | Read the prices of one product or variation: cheio (list price), promocional (sale price, null when none), custo (cost) and sob_consulta |
loja_integrada_update_price | Change the prices of one product or variation: cheio (list price), promocional (sale price; send 0 or null to remove it), custo (cost) and… |
loja_integrada_list_categories | List the store's categories: id, nome, descricao, categoria_pai (parent URI), id_externo, url and resource_uri |
loja_integrada_create_category | Create a category, optionally below a parent category |
loja_integrada_list_brands | List the store's brands: id, nome, apelido, descricao, id_externo and resource_uri |
loja_integrada_create_brand | Create a brand |
loja_integrada_list_grids | List the variation grids (grades, e.g |
loja_integrada_get_grid | Read one variation grid with its variations (values such as P, M, G or Azul), each with id and nome |
loja_integrada_search_orders | Search orders, 20 per page (at most 50): numero (order number), situacao (status with codigo and nome), cliente URI, valor_total… |
loja_integrada_get_order | Read one order by its number: customer, billing and delivery address, items (itens with SKU, quantity and prices), payments, shipments… |
loja_integrada_list_order_statuses | List the order statuses of the store: id, codigo (e.g. aguardando_pagamento, pedido_pago, pedido_enviado, pedido_entregue… |
loja_integrada_update_order_status | Move an order to another status by its codigo, for example pedido_pago, pedido_em_separacao, faturado, pedido_enviado… |
loja_integrada_get_order_status_history | Read the status history of one order: each change with its date, the new and previous status and who changed it (alterado_por_nome), by… |
loja_integrada_update_tracking_code | Set the tracking code of one shipment of an order |
loja_integrada_list_payment_methods | List the payment methods of the store: id, nome, codigo and configuracoes (ativo, disponivel) |
loja_integrada_list_customers | List customers, 20 per page: id, nome, email, cpf or cnpj, phone numbers, sexo, data_nascimento, group and dates |
loja_integrada_search_customers | Search customers by e-mail and/or a created or updated date window; date-filtered results come newest modification first |
loja_integrada_get_customer | Read one customer by id: name, e-mail, CPF or CNPJ, company name, phones, birth date, group and addresses (enderecos) |
プロンプトの例
- 「SKU CAM-001 の有効在庫は何個ですか。定価とセール価格も教えてください。」
- 「今週の注文のうち、まだ支払い待ちのものを表示してください。」
- 「SKU CAM-001 のセール価格を R$ 89.90 に、在庫を 40 個に設定してください。」
- 「注文 164 を発送済みにして、追跡番号 AA123456789BR を登録してください。」
- 「メールアドレスが [email protected] の顧客を探して、その注文を一覧にしてください。」
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?