How to Connect Tiendanube / Nuvemshop to Gemini — via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Tiendanube / Nuvemshop, paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

Tiendanube / Nuvemshop + Gemini

Tiendanube (Nuvemshop in Brazil) online stores: store info, products, variants and stock, categories, orders and fulfillment orders, customers, abandoned checkouts, coupons and webhooks. REST API 2025-03 with an app access token.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

TIENDANUBE_STORE_ID, TIENDANUBE_ACCESS_TOKEN

Step 1 — Get credentials

Tiendanube (Nuvemshop in Brazil) has no API keys in the store admin: access goes through an app. To connect your own store, create an app once and install it on the store.

1. Register at the Tiendanube or Nuvemshop Partners portal and create an app under Apps. Choose the scopes the AI needs, for example read_products, write_products, read_orders, write_orders, read_customers, read_coupons. A write scope includes its read scope.
2. Install the app on your store by opening https://www.tiendanube.com/apps/APP_ID/authorize. You are redirected to the app's redirect URL with a code, valid for 5 minutes.
3. Exchange the code with POST https://www.tiendanube.com/apps/authorize/token, sending client_id, client_secret, grant_type=authorization_code and code. Put access_token in TIENDANUBE_ACCESS_TOKEN (the token alone, without "bearer") and user_id in TIENDANUBE_STORE_ID.
4. Call tiendanube_get_store first to check the connection: it returns the store name, languages, currency and plan.

The token does not expire. It stops working when the app is uninstalled or a new token is issued for the same app. A 403 means the app lacks a scope: add it in the Partners portal and reinstall the app. A 402 means the store's API access is suspended for an unpaid subscription.

Limits: a bucket of 40 requests that drains at 2 per second, per store and app (10x on the Next and Evolution plans). Order queries stop at 10,000 results, so narrow them by date or status. Product names and descriptions are objects per language, and stock and price live on the variant. tiendanube_cancel_order puts the stock back and e-mails the customer unless you turn that off.

Step 2 — Install the adapter

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

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:

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

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart gemini.
3. Run /mcp inside Gemini CLI (or gemini mcp list in your shell) — anythingmcp should show as connected.
4. Start prompting — Gemini CLI can now call the Tiendanube / Nuvemshop tools.

Available tools

FAQ

Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT
• Connect to Cursor
• Connect to Meta Muse