Collegare Cin7 Omni MCP a Microsoft Copilot

💡 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Cin7 Omni.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

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.

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a Claude