Come collegare Tiendanube / Nuvemshop a Cursor — via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Tiendanube / Nuvemshop, inserisci le credenziali, genera una MCP API key — fatto. Niente Docker, niente git clone, niente server locale.

Tiendanube / Nuvemshop + Cursor

Negozi online Tiendanube (Nuvemshop in Brasile): dati del negozio, prodotti, varianti e stock, categorie, ordini e ordini di evasione, clienti, checkout abbandonati, coupon e webhook. REST API 2025-03 con un access token di app.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

TIENDANUBE_STORE_ID, TIENDANUBE_ACCESS_TOKEN

Step 1 — Ottieni le credenziali

Tiendanube (Nuvemshop in Brasile) non ha chiavi API nel pannello del negozio: l'accesso passa da un'app. Per collegare il tuo negozio crei un'app una volta e la installi sul negozio.

1. Registrati nel portale Partners di Tiendanube o Nuvemshop e crea un'app sotto Apps. Scegli gli scope che servono all'AI, per esempio read_products, write_products, read_orders, write_orders, read_customers, read_coupons. Uno scope di scrittura include quello di lettura.
2. Installa l'app sul negozio aprendo https://www.tiendanube.com/apps/APP_ID/authorize. Vieni reindirizzato all'URL di redirect dell'app con un code valido 5 minuti.
3. Scambia il codice con POST https://www.tiendanube.com/apps/authorize/token, inviando client_id, client_secret, grant_type=authorization_code e code. Metti access_token in TIENDANUBE_ACCESS_TOKEN (solo il token, senza "bearer") e user_id in TIENDANUBE_STORE_ID.
4. Chiama per primo tiendanube_get_store per verificare la connessione: restituisce nome del negozio, lingue, valuta e piano.

Il token non scade. Smette di funzionare quando l'app viene disinstallata o viene emesso un nuovo token per la stessa app. Un 403 significa che all'app manca uno scope: aggiungilo nel portale Partners e reinstalla l'app. Un 402 significa che l'accesso API del negozio è sospeso per un abbonamento non pagato.

Limiti: un secchio di 40 richieste che si svuota a 2 al secondo, per negozio e app (10 volte tanto sui piani Next ed Evolution). Le query sugli ordini si fermano a 10.000 risultati, quindi restringile per data o stato. Nomi e descrizioni dei prodotti sono oggetti per lingua, e stock e prezzo stanno sulla variante. tiendanube_cancel_order rimette lo stock e manda un'e-mail al cliente, a meno che tu non lo disattivi.

Step 2 — Installa l'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 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

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

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Tiendanube / Nuvemshop.

Tool disponibili

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collega a Claude
• Collega a ChatGPT
• Collega a Gemini
• Collega a Meta Muse