Loja Integrada MCPでCursorと連携

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Loja Integrada をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Loja Integrada + Cursor

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）が必要です。

1. ストア管理画面で Configurações → Chave para API を開き、Cadastrar nova chave をクリックして、20 文字のキーを LOJA_INTEGRADA_API_KEY にコピーします。chave_api を付けず、キーだけを貼り付けてください。API キーは有料プランでのみ利用できます（Loja Integrada のヘルプ）。
2. このヘルプ記事 にあるインテグレーター向けフォームで、Loja Integrada にアプリケーションキー（chave de aplicação）を申請します。フォームには API を呼び出す IP アドレスを記入します。セルフホストならサーバーのアドレス、AnythingMCP Cloud なら、Cloud がすべての呼び出しに使う固定の IPv4 アドレス 104.248.242.235 です。送信元アドレスはコネクタのセットアップページにも表示されます。Loja Integrada からの回答には 5〜10 営業日かかります。
3. アプリケーションキー（dc6049f0-1234-... のような UUID）を LOJA_INTEGRADA_APP_KEY に入力します。aplicacao を付けず、キーだけを貼り付けてください。
4. コネクターをインストールし、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 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう — エージェントが Loja Integrada のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「SKU CAM-001 の有効在庫は何個ですか。定価とセール価格も教えてください。」
• 「今週の注文のうち、まだ支払い待ちのものを表示してください。」
• 「SKU CAM-001 のセール価格を R$ 89.90 に、在庫を 40 個に設定してください。」
• 「注文 164 を発送済みにして、追跡番号 AA123456789BR を登録してください。」
• 「メールアドレスが [email protected] の顧客を探して、その注文を一覧にしてください。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい — MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続