In breve
MoySklad (МойСклад) JSON API 1.2 per la gestione del commercio e del magazzino: assortimento e prodotti, rapporti di magazzino, controparti, ordini clienti, spedizioni, forniture, fatture, negozi e rapporti di profitto e fatturato. Token di accesso.
Configurazione guidata
Collega MoySklad a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega MoySklad con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per MoySklad
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → MoySklad, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
MoySklad
MoySklad (МойСклад) JSON API 1.2 per la gestione del commercio e del magazzino: assortimento e prodotti, rapporti di magazzino, controparti, ordini clienti, spedizioni, forniture, fatture, negozi e rapporti di profitto e fatturato. Token di accesso.
Configurazione
La configurazione richiede circa 3 minuti.
- In MoySklad apri le impostazioni (Настройки) e la sezione per i token di accesso (Токены), crea un token per l'utente con cui l'AI deve operare e copialo. Viene mostrato solo una volta.
- Incollalo in
MOYSKLAD_TOKEN.
Senza quella sezione, un token può essere emesso anche con il login e la password: un POST a /security/token con HTTP Basic restituisce access_token (questo revoca i token precedenti dell'utente). Il token agisce con i diritti del suo utente, quindi un utente con diritti di sola lettura crea un connettore di sola lettura.
Il connettore invia Authorization: Bearer, Accept-Encoding: gzip e Accept: application/json;charset=utf-8 ad ogni chiamata. MoySklad rifiuta le chiamate senza gzip con 415 e senza corpo.
Da dove iniziare: moysklad_get_employee_context mostra l'utente e i suoi diritti. moysklad_list_assortment cerca tutto ciò che può essere venduto, moysklad_get_current_stock fornisce rapidamente i numeri di magazzino, e moysklad_list_customer_orders elenca gli ordini.
Catalogo: moysklad_list_assortment, moysklad_list_products, moysklad_get_product, moysklad_create_product, moysklad_update_product, moysklad_list_product_folders.
Magazzino: moysklad_get_stock_report (tutti i negozi, con costo e prezzo di vendita), moysklad_get_stock_by_store (per negozio) e moysklad_get_current_stock (ids e un numero, senza paging, buono per controlli frequenti). I due rapporti estesi contano come 5 richieste ciascuno.
Controparti: moysklad_list_counterparties, moysklad_get_counterparty, moysklad_create_counterparty, moysklad_update_counterparty.
Documenti: moysklad_list_customer_orders, moysklad_get_customer_order, moysklad_get_customer_order_metadata (stati), moysklad_create_customer_order, moysklad_update_customer_order; moysklad_list_demands e moysklad_get_demand (spedizioni); moysklad_list_supplies e moysklad_get_supply (merci ricevute); moysklad_list_invoices_out e moysklad_get_invoice_out. Riferimenti: moysklad_list_stores, moysklad_list_organizations.
Rapporti: moysklad_get_profit_by_product, moysklad_get_profit_by_counterparty, moysklad_get_turnover, moysklad_get_dashboard.
Paging: le liste restituiscono al massimo 1000 righe per chiamata (limit, qui di default 100) da offset; meta.size è il totale e meta.nextHref è presente mentre ci sono più righe. Con expand il limite è 100: un limite maggiore fa sì che MoySklad ignori l'espansione. Le righe del documento oltre le prime 1000 vengono lette attraverso le posizioni del documento.
Denaro e date: tutti gli importi e i prezzi sono in copechi (unità minori): 150000 significa 1500.00. Le date sono YYYY-MM-DD HH:MM:SS in ora di Mosca. Gli id sono UUID.
Riferimenti (meta): un altro oggetto è referenziato come un oggetto con meta che contiene href, type e mediaType, mai con un id nudo. Ogni riga porta il proprio meta: copialo quando uno strumento richiede un riferimento (negozio, stato, assortimento di una riga d'ordine). Nei filtri di lista un riferimento è il suo href; nel rapporto di magazzino breve è l'id nudo.
Filtri: filter unisce le condizioni con ;. Operatori: =, !=, >, <, >=, <=, ~ contiene, ~= inizia con, =~ termina con. search è una ricerca full-text. order ordina, ad esempio moment,desc.
Limiti: un token utente ottiene 45 unità ogni 3 secondi e ogni richiesta costa diverse unità (4 dal 1 dicembre 2026, quindi circa 11 richieste ogni 3 secondi; i due rapporti di magazzino estesi costano 5). Al massimo 5 chiamate di un utente in parallelo. Un 429 porta X-Lognex-Retry-After in millisecondi. MoySklad disattiva l'accesso API per gli utenti che continuano a inviare chiamate fallite (più di 200 richieste fallite identiche al minuto), quindi non ripetere gli errori in un ciclo. La cancellazione di oggetti e pagamenti non fa parte di questo connettore.
Prerequisiti: MOYSKLAD_TOKEN
Installa il connettore localmente
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
Apri http://localhost:3000/connectors/store, scegli MoySklad e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
moysklad_get_employee_context | Legge l'impiegato a cui appartiene il token: nome, email, l'account e i permessi per entità. Usalo per controllare il token e cosa può… |
moysklad_list_assortment | Elenca tutto ciò che può essere venduto in un'unica lista: prodotti, varianti (modifiche), servizi, pacchetti e spedizioni, ciascuno con id, meta… |
moysklad_list_products | Elenca i prodotti: id, nome, codice, articolo, descrizione, productFolder, uom, salePrices, buyPrice e minPrice in copechi, codici a barre, iva… |
moysklad_get_product | Legge un prodotto con i suoi prezzi in copechi, codici a barre, unità, cartella, fornitore, campi personalizzati (attributi) e impostazioni di tracciamento. Solo lettura |
moysklad_create_product | Crea un prodotto con un nome e opzionalmente codice, articolo, descrizione, IVA, peso e prezzo d'acquisto. Restituisce il prodotto con il suo id e… |
moysklad_update_product | Aggiorna un prodotto: solo i campi forniti cambiano. Restituisce il prodotto aggiornato. MoySklad blocca un utente che invia più di 100 aggiornamenti del… |
moysklad_list_product_folders | Elenca i gruppi di prodotti (cartelle): id, nome, pathName (il percorso dei gruppi genitori), codice, descrizione e archiviato. Restituisce meta (dimensione, limite… |
moysklad_get_stock_report | Rapporto di magazzino esteso per articolo su tutti i negozi: nome, codice, articolo, magazzino, riserva, inTransito e quantità (disponibile), prezzo (costo) e… |
moysklad_get_stock_by_store | Rapporto di magazzino per articolo e negozio: ogni riga ha il meta dell'articolo e stockByStore con nome, magazzino, riserva e inTransito per negozio. Ogni chiamata… |
moysklad_get_current_stock | Rapporto di magazzino breve per controlli frequenti: solo assortmentId (e storeId con ambito per negozio) con un numero, in una singola risposta senza… |
moysklad_list_counterparties | Elenca le controparti (clienti e fornitori): id, nome, codice, companyType, inn, kpp, legalTitle, telefono, email, indirizzo attuale, tag… |
moysklad_get_counterparty | Legge una controparte con dettagli legali (inn, kpp, legalAddress), contatti, conti bancari, tag, sconti, tipo di prezzo e campi personalizzati.… |
moysklad_create_counterparty | Crea una controparte (cliente o fornitore) con un nome e opzionalmente tipo, numeri fiscali, indirizzi, telefono, email e tag. Restituisce il… |
moysklad_update_counterparty | Aggiorna una controparte: solo i campi forniti cambiano; un dato elenco di tag sostituisce il precedente. Restituisce la controparte aggiornata |
moysklad_list_customer_orders | Elenca gli ordini clienti: id, nome (il numero dell'ordine), momento, somma, somma pagata, somma spedita, somma fatturata e somma riservata in copechi, applicabile… |
moysklad_get_customer_order | Legge un ordine cliente: numero, momento, somme in copechi, controparte (agente), organizzazione, negozio, stato, indirizzo di spedizione, commento e… |
moysklad_get_customer_order_metadata | Legge i metadati degli ordini clienti: gli stati (stati) con id, nome, stateType e meta, e i campi personalizzati (attributi). Il… |
moysklad_create_customer_order | Crea un ordine cliente per un'organizzazione (la tua entità legale) e una controparte, con righe d'ordine. Restituisce l'ordine con il suo id, numero… |
moysklad_update_customer_order | Aggiorna un ordine cliente: commento, data di spedizione pianificata, stato, negozio o il flag di bozza. Solo i campi forniti cambiano. Per cambiare l'ordine… |
moysklad_list_demands | Elenca le richieste (spedizioni ai clienti): id, nome, momento, somma e somma pagata in copechi, agente, organizzazione, negozio, stato, l'ordine cliente… |
moysklad_get_demand | Legge una richiesta (spedizione): numero, momento, somma in copechi, controparte, negozio, dettagli del destinatario e del vettore e il cliente collegato… |
moysklad_list_supplies | Elenca le forniture (merci ricevute dai fornitori): id, nome, momento, somma e somma pagata in copechi, agente (il fornitore), organizzazione, negozio… |
moysklad_get_supply | Legge una fornitura (ricezione merci): numero, momento, somma in copechi, fornitore, negozio, il numero del documento in arrivo e costi generali. Aggiungi… |
moysklad_list_invoices_out | Elenca le fatture emesse ai clienti: id, nome, momento, somma, somma pagata e somma spedita in copechi, agente, organizzazione, paymentPlannedMoment e… |
moysklad_get_invoice_out | Legge una fattura emessa a un cliente: numero, momento, somma e somma pagata in copechi, controparte, organizzazione con il suo conto bancario e… |
moysklad_list_stores | Elenca i negozi (magazzini): id, nome, codice, indirizzo, pathName per negozi nidificati, archiviato e meta. Il meta è ciò che ordina e riporta… |
moysklad_list_organizations | Elenca le tue organizzazioni (entità legali): id, nome, legalTitle, inn, kpp, legalAddress, companyType e meta. Un ordine ha sempre bisogno di uno.… |
moysklad_get_profit_by_product | Rapporto di profitto per prodotto, servizio e pacchetto per un periodo: sellQuantity, sellPrice, sellCost, sellSum, sellCostSum, returnQuantity… |
moysklad_get_profit_by_counterparty | Rapporto di profitto per cliente per un periodo: demandsCount, demandsSum, averageReceipt, returnsCount, returnsSum, discountsSum, balance… |
moysklad_get_turnover | Rapporto di fatturato per articolo per un periodo: stock all'inizio (onPeriodStart), entrate, uscite e stock alla fine (onPeriodEnd), ciascuno con… |
moysklad_get_dashboard | Indicatori chiave per oggi, l'ultima settimana o l'ultimo mese: vendite (conteggio, importo, movimento), ordini (conteggio, importo, movimento) e… |
Esempi di richieste
- "Qual è il magazzino attuale di tutti i prodotti nel magazzino principale?"
- "Quali ordini clienti di questa settimana non sono ancora stati spediti?"
- "Mostra il profitto per prodotto di ottobre."
- "Crea un ordine cliente per ООО Ромашка: 10 pezzi del prodotto Чайник 1,7 л."
- "Quali controparti hanno acquistato di più nell'ultimo trimestre?"
Prossimi passi
Questa guida ti è stata utile?