In breve
MoySklad (МойСклад) JSON API 1.2 per la gestione del commercio e del magazzino: assortimento e prodotti, report di magazzino, controparti, ordini dei clienti, spedizioni, forniture, fatture, negozi e report di profitto e fatturato. Token di accesso.
Configurazione guidata
Collega MoySklad a Gemini in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega MoySklad con la configurazione guidata e aggiungi il tuo URL MCP a Gemini. 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 + Gemini
MoySklad (МойСклад) JSON API 1.2 per la gestione del commercio e del magazzino: assortimento e prodotti, report di magazzino, controparti, ordini dei clienti, spedizioni, forniture, fatture, negozi e report di profitto e fatturato. Token di accesso.
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:
MOYSKLAD_TOKEN
Passo 1 — Ottieni le credenziali
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 agire 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.
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 report 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.
Report: 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 finché ci sono altre 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 report di magazzino breve è l'id nudo.
Filtri: filter unisce le condizioni con ;. Operatori: =, !=, >, <, >=, <=, ~ contiene, ~= inizia con, =~ finisce 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 report 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 identiche fallite al minuto), quindi non ripetere gli errori in un ciclo. La cancellazione di oggetti e pagamenti non fa parte di questo connettore.
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 Gemini
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 mostraYOUR_SERVER_ID.
Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di
YOUR_MCP_API_KEY. - Salva il file e riavvia
gemini. - Esegui
/mcpin Gemini CLI (oppuregemini mcp listdal terminale):anythingmcpdovrebbe risultare connesso. - Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di
MoySklad.
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 consignment, 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 di 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 | Report di magazzino esteso per articolo su tutti i negozi: nome, codice, articolo, magazzino, riserva, in transito e quantità (disponibile), prezzo (costo) e… |
moysklad_get_stock_by_store | Report di magazzino per articolo e negozio: ogni riga ha il meta dell'articolo e stockByStore con nome, magazzino, riserva e in transito per negozio. Ogni chiamata… |
moysklad_get_current_stock | Report 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 dei 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 dei 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 entrata 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 annidati, archiviato e meta. Il meta è ciò che ordini e report… |
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 | Report di profitto per prodotto, servizio e pacchetto per un periodo: sellQuantity, sellPrice, sellCost, sellSum, sellCostSum, returnQuantity… |
moysklad_get_profit_by_counterparty | Report di profitto per cliente per un periodo: demandsCount, demandsSum, averageReceipt, returnsCount, returnsSum, discountsSum, balance… |
moysklad_get_turnover | Report 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 prompt
- "Qual è il magazzino attuale di tutti i prodotti nel magazzino principale?"
- "Quali ordini dei 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?"
FAQ
Da dove proviene il token? In MoySklad, impostazioni (Настройки), token di accesso (Токены): crea un token per l'utente con cui l'AI deve agire e copialo, viene mostrato una volta. Il token ha i diritti di quell'utente, quindi un utente con diritti di sola lettura crea un connettore di sola lettura.
Cosa copre? L'assortimento e i prodotti con cartelle, report di magazzino complessivi, per negozio e il magazzino attuale veloce, controparti, ordini dei clienti con i loro stati, spedizioni (richieste), forniture, fatture in uscita, negozi, organizzazioni e i report di profitto, fatturato e dashboard. Gli importi sono in copechi e le date in ora di Mosca. La cancellazione di oggetti e pagamenti non fa parte del connettore.
Quali strumenti scrivono e quali installazioni sono disattivate? I prodotti, le controparti e gli ordini dei clienti possono essere creati e aggiornati. Nessuna installazione è disattivata; l'AI mostra ogni scrittura e attende la tua conferma.
Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.
Prossimi passi
Questa guida ti è stata utile?