Collegare Cin7 Omni MCP a Cursor

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Cin7 Omni, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Cin7 Omni + Cursor

Gestione dell'inventario e degli ordini di Cin7 Omni (go.cin7.com) tramite API v1: ordini di vendita, preventivi, ordini di acquisto, note di credito, contatti, prodotti, stock per filiale, filiali, pagamenti (solo lettura), aggiustamenti di stock, trasferimenti tra filiali e utenti. Crea ordini, ordini di acquisto, contatti e trasferimenti. Nome utente e chiave API.

Prerequisiti

Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili ambientali richieste per questo connettore sono:

CIN7_OMNI_API_USERNAME, CIN7_OMNI_API_KEY

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti. Hai bisogno di un account Cin7 Omni (accedi a go.cin7.com) e di un amministratore che possa aggiungere una connessione API v1. Il connettore ha bisogno del nome utente API e di una chiave API.

Omni o Core? Cin7 vende due prodotti diversi. Cin7 Omni (questo connettore) accede a go.cin7.com e ha API v1 con un nome utente API e una chiave. Cin7 Core (precedentemente DEAR Inventory) accede a inventory.dearsystems.com e ha la propria API con un ID account e una chiave applicativa: usa il connettore Cin7 Core per questo. Le due API e le loro credenziali non sono intercambiabili.

1. In Cin7 Omni apri il menu utente, poi Impostazioni → Integrazioni & API → API v1.
2. Copia il Nome Utente API mostrato in cima alla pagina in CIN7_OMNI_API_USERNAME.
3. Clicca su Aggiungi Nuova Connessione API, dai un nome e copia la sua chiave API in CIN7_OMNI_API_KEY. Rigenera Chiave sostituisce una chiave persa.
4. Sotto Permessi seleziona Lettura per ogni risorsa che l'AI dovrebbe vedere, e Crea o Aggiorna per le risorse di cui gli strumenti di scrittura hanno bisogno, poi clicca su Salva. Una risorsa senza permesso risponde 403.
5. Installa il connettore. Esegui cin7_omni_list_branches per controllare la connessione: elenca le tue filiali con i loro ID.

Cloud e self-hosted funzionano allo stesso modo: le credenziali sono le stesse e non c'è un URL di reindirizzamento da impostare. Il connettore invia il nome utente e la chiave come autenticazione HTTP Basic.

Da dove iniziare: cin7_omni_list_branches per gli ID delle filiali, cin7_omni_list_sales_orders per gli ordini recenti, cin7_omni_list_stock per lo stock per filiale, e cin7_omni_list_contacts per trovare un cliente o fornitore.

Cosa legge: ordini di vendita, preventivi e note di credito con i loro articoli; pagamenti registrati contro gli ordini; ordini di acquisto; prodotti, le loro opzioni (gli SKU vendibili) con prezzi e categorie; stock per opzione di prodotto e filiale (disponibile, a magazzino, vendite aperte, in arrivo); aggiustamenti di stock e trasferimenti tra filiali; contatti e utenti.

Cosa scrive: cin7_omni_create_sales_order, cin7_omni_update_sales_order (solo campi di intestazione, come fase, codice di tracciamento e istruzioni di consegna), cin7_omni_create_purchase_order, cin7_omni_create_contact, cin7_omni_update_contact e cin7_omni_create_branch_transfer sono attivati. Un nuovo ordine di vendita è approvato a meno che l'AI non lo crei come bozza; gli ordini di acquisto e i trasferimenti sono salvati come bozze a meno che non siano approvati. La spedizione e la ricezione dei trasferimenti avvengono in Cin7.

Disattivato all'installazione: cin7_omni_create_adjustment (crea un aggiustamento di stock in una filiale). Un aggiustamento approvato cambia lo stock a magazzino e il valore dello stock contemporaneamente. Attivalo nella pagina del connettore se l'AI dovrebbe usarlo; l'AI ti chiederà di confermare ogni cambiamento.

Controlla la risposta di ogni scrittura: Cin7 risponde HTTP 200 con un elenco di {index, success, id, code, errors}, anche quando ha rifiutato il record. L'AI controlla success e errors prima di segnalare una scrittura come completata.

I pagamenti sono solo in lettura: il connettore non registra, modifica o elimina mai un pagamento, e non spedisce, fattura o annulla ordini.

Filtraggio: where accetta condizioni in stile SQL sui campi del record, non sui suoi articoli. Le stringhe e le date vanno tra virgolette singole, i numeri rimangono nudi: modifiedDate>='2026-01-01T00:00:00Z' AND branchId=3, reference LIKE 'SO-10%', id IN (21,24). Le date sono in UTC, yyyy-MM-ddTHH:mm:ssZ. fields riduce la risposta (id,reference,total,lineItems(code,qty)), il che aiuta con le liste degli ordini, perché sono grandi.

Paginazione: page inizia da 1 e rows è al massimo 250 (predefinito 50, 25 nelle liste degli ordini). L'AI chiede la pagina successiva finché non ne torna una vuota.

Limiti di frequenza: Cin7 Omni consente 3 chiamate al secondo, 60 al minuto e 5.000 al giorno per account; oltre a questo risponde 429 con Retry-After. Grandi rows con filtri where ristretti utilizzano meglio il budget rispetto a molte piccole chiamate.

Valori: lo status dell'ordine è DRAFT, APPROVED o VOID, e stage è una fase di workflow in testo libero (Nuovo, In attesa di pagamento, Elaborazione, In attesa, Spedito). Lo stock available è lo stock a magazzino meno le vendite aperte. Il type del contatto è Cliente, Fornitore o Interno. Le scritture prendono importi nella valuta dell'ordine; le letture restituiscono valori in valuta base con il tasso di cambio. I nuovi utenti possono impiegare fino a 2 ore per apparire in cin7_omni_list_users.

Errori comuni: 403 significa che la connessione API non ha permesso per quella risorsa: selezionala sotto Permessi e salva. 429 è il limite di frequenza: aspetta il tempo di Retry-After.

Passo 2 — Installa l'adattatore

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

Passo 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 Cin7 Omni.

Strumenti disponibili

Esempi di prompt

• "Quali ordini di vendita sono stati approvati questa settimana e non sono ancora stati spediti?"
• "Quanto stock dell'SKU TSHIRT-BLK-M è disponibile in ogni filiale?"
• "Quali ordini di acquisto devono arrivare questo mese, e da quali fornitori?"
• "Trova il cliente con l'email [email protected] e mostra il suo saldo dovuto."
• "Crea un trasferimento bozza di 20 unità di TSHIRT-BLK-M dal magazzino principale al negozio in città."

FAQ

Uso Cin7 Core (DEAR Inventory). È questo il connettore giusto? No. Cin7 Core ha la propria API e credenziali: usa il connettore Cin7 Core. Le credenziali di un prodotto non funzionano sull'altro.

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

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a Claude