Collegare Cin7 Core MCP a Cursor

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

Cin7 Core + Cursor

Cin7 Core (precedentemente DEAR Inventory) tramite External API v2: prodotti e disponibilità di stock per posizione, vendite con ordini, evasioni, fatture e pagamenti (solo lettura), acquisti, clienti, fornitori, aggiustamenti e trasferimenti di stock. Crea vendite, acquisti, clienti, fornitori e trasferimenti. ID account e chiave dell'applicazione.

Requisiti

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

CIN7_CORE_ACCOUNT_ID, CIN7_CORE_APPLICATION_KEY

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Hai bisogno di un account Cin7 Core (precedentemente DEAR Inventory; accedi su inventory.dearsystems.com) con accesso a Integrazioni → API. Il connettore ha bisogno dell'ID account e di una chiave dell'applicazione.

Core o Omni? Cin7 vende due prodotti diversi. Cin7 Core (questo connettore, precedentemente DEAR Systems) utilizza un ID account e una chiave dell'applicazione. Cin7 Omni (il Cin7 originale, go.cin7.com) ha una API v1 separata con un nome utente e una chiave API: usa il connettore Cin7 Omni per questo. Le credenziali di uno non funzionano sull'altro.

1. In Cin7 Core apri la pagina di configurazione API, Integrazioni → API (inventory.dearsystems.com/ExternalAPI).
2. Clicca su + per aggiungere un'applicazione API e dagli un nome.
3. Copia l'ID account (un GUID) in CIN7_CORE_ACCOUNT_ID e la chiave dell'applicazione in CIN7_CORE_APPLICATION_KEY.
4. Installa il connettore. Esegui cin7_core_get_me per controllare la connessione: restituisce il nome dell'azienda, la valuta di base e il fuso orario dell'account.

Cloud e self-hosted funzionano allo stesso modo: le credenziali sono le stesse e non c'è un URL di reindirizzamento da impostare. Il connettore le invia negli header api-auth-accountid e api-auth-applicationkey. Eliminare l'applicazione API in Cin7 Core revoca la chiave.

Da dove iniziare: cin7_core_get_me per la valuta di base, cin7_core_list_locations per i nomi delle posizioni, poi cin7_core_list_sales e cin7_core_get_product_availability, che rispondono alla maggior parte delle domande.

Cosa legge: prodotti con livelli di prezzo, disponibilità di stock per prodotto e posizione (disponibile, allocato, disponibile, in ordine); vendite con il loro preventivo, ordine, evasioni (prelievo, imballaggio e spedizione, con corriere e tracciamento), fatture e pagamenti; acquisti con il loro ordine; clienti, fornitori, regole fiscali e termini di pagamento; aggiustamenti di stock e trasferimenti di stock.

Creare una vendita richiede due chiamate: cin7_core_create_sale crea l'intestazione (cliente, posizione) e restituisce il suo ID, poi cin7_core_create_sale_order aggiunge le righe. Le righe necessitano di Nome, Quantità, Prezzo, Tassa e RegolaTassa più SKU o ProductID. L'AI mantiene l'ordine in BOZZA a meno che tu non voglia che sia autorizzato: AUTORIZZATO alloca stock, backordina una carenza senza avviso e blocca l'ordine contro ulteriori modifiche API. Gli acquisti funzionano allo stesso modo, con cin7_core_create_purchase e cin7_core_create_purchase_order.

Altri scritti: cin7_core_create_customer, cin7_core_update_customer e cin7_core_create_supplier (hanno bisogno di nomi di termini di pagamento e regole fiscali e codici conto, che cin7_core_list_payment_terms e cin7_core_list_tax_rules elencano), e cin7_core_create_stock_transfer (BOZZA per impostazione predefinita). Tutti questi sono attivati.

Disattivato all'installazione: cin7_core_create_stock_adjustment (crea un aggiustamento di stock). Un aggiustamento COMPLETATO registra i movimenti di stock e le voci contabili contemporaneamente, e le sue quantità sono i nuovi valori disponibili, non le differenze. Attivalo nella pagina del connettore se l'AI deve usarlo; l'AI ti chiederà di confermare ogni modifica.

Nessun pagamento e nessuna cancellazione: il connettore non registra, modifica o cancella mai pagamenti, fatture o note di credito, e non ha strumenti di cancellazione o annullamento.

Identificatori: i record utilizzano GUID (ID, SaleID, TaskID). Le posizioni, le regole fiscali, i termini di pagamento e i livelli di prezzo sono referenziati per nome.

Paging: le liste prendono page (da 1) e limit (predefinito 100, al massimo 1.000); la risposta riporta Total. updated_since o modified_since restituiscono solo ciò che è cambiato. Le date sono UTC, yyyy-MM-ddTHH:mm:ss.

Limite di chiamate: 60 chiamate al minuto per applicazione API; oltre a questo, Cin7 Core risponde 429 (account più vecchi 503). Pagine grandi e filtri utilizzano meglio il budget rispetto a molte piccole chiamate.

Errori comuni: una chiamata rifiutata risponde 400 con [{"ErrorCode": 400, "Exception": "..."}] che nomina il problema, come un cliente, una posizione o una regola fiscale sconosciuti, o un documento già autorizzato. 403 significa un ID account o una chiave dell'applicazione errati.

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 Core.

Strumenti disponibili

Esempi di prompt

• "Quante unità di SKU MUG-WHT-350 sono disponibili in ciascuna posizione?"
• "Elenca le vendite di questo mese che sono autorizzate ma non completamente evase."
• "Mostra l'evasione dell'ordine SO-1042 con il suo corriere e numero di tracciamento."
• "Quali acquisti stanno ancora aspettando di ricevere stock?"
• "Crea una vendita in bozza per il cliente Coffee Corner presso il Magazzino Principale con 24 unità di MUG-WHT-350 a 6.50."

FAQ

Uso Cin7 Omni (go.cin7.com). È questo il connettore giusto? No. Cin7 Omni ha una API v1 separata con un nome utente e una chiave API: usa il connettore Cin7 Omni. 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