Come collegare Moedelo a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Moedelo, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Moedelo + Cursor

Collega Moedelo (Моё Дело), il servizio russo di contabilità online, a Claude o ChatGPT: controparti e contratti, fatture di vendita, atti, documenti di trasporto, fatture IVA e UPD, documenti di acquisto, registro di banca e cassa, magazzini e merci, piano dei conti, dipendenti e scadenzario fiscale. Le scritture sono disattivate all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

MOEDELO_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti e ti serve solo il tuo account Moedelo.

1. Accedi a Moedelo e apri Настройки (Impostazioni), poi Интеграция с партнерами (integrazione con i partner).
2. Attiva l'integrazione e copia la API key che compare. Ha la forma di un GUID, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Se il tuo account non ha questa opzione, richiedi l'accesso API su moedelo.org o a [email protected].
3. Incolla la chiave in MOEDELO_API_KEY, da sola, senza virgolette né spazi.
4. Installa il connettore ed esegui moedelo_list_kontragents con dimensione pagina 1: se torna una controparte, la chiave funziona.

Una chiave, un'azienda: la chiave apre i dati di un'azienda. Se tieni la contabilità di una seconda azienda, installa di nuovo il connettore con la chiave di quell'azienda.

Come è organizzato Moedelo: le controparti (контрагенты) sono insieme clienti e fornitori, e il loro id numerico filtra ogni elenco di documenti. Sul lato vendite ci sono fatture (счета), atti di servizi resi (акты), documenti di trasporto (накладные, ТОРГ-12), fatture IVA (счета-фактуры, normali e di acconto) e UPD; i documenti collegati a una fattura mostrano gli atti, i documenti di trasporto e i pagamenti che la chiudono. I documenti di acquisto fanno lo stesso per i fornitori. Lo stato fattura 4 significa non pagata, 5 pagata in parte, 6 pagata. Gli importi sono in rubli.

Cosa legge: controparti con INN, KPP, OGRN, indirizzi, conti bancari e referenti; contratti (договоры); fatture di vendita, atti, documenti di trasporto, fatture IVA, fatture di acconto e UPD con le righe e l'IVA, più i documenti collegati a una fattura o a un UPD; i report delle vendite al dettaglio; atti, documenti di trasporto, fatture IVA e UPD ricevuti dai fornitori; il registro di tutte le operazioni di banca e cassa di un periodo, ogni operazione in dettaglio, i conti bancari dell'azienda, le casse e il saldo di cassa a una data; magazzini, merci e servizi; il piano dei conti e le registrazioni (проводки) generate da Moedelo per un documento; i dipendenti; e lo scadenzario fiscale con le scadenze di dichiarazioni e versamenti.

Filtri: gli elenchi di documenti filtrano per numero, per data del documento (docAfterDate, docBeforeDate) o di modifica e per controparte, e si sfogliano con pageNo (da 1) e pageSize. Un risultato vuoto significa che nulla corrisponde ai filtri.

Disattivati all'installazione: moedelo_create_kontragent, moedelo_update_kontragent e moedelo_create_bill. moedelo_update_kontragent sostituisce l'intero record, quindi vanno inviati anche tutti i campi da conservare. Una fattura registra solo quanto è dovuto: nessun pagamento viene eseguito o registrato. Un amministratore attiva solo ciò che serve, e anche allora l'AI ti mostra controparte, righe e IVA e aspetta il tuo sì.

Dati personali: i dipendenti e le controparti che sono persone fisiche (privati e imprenditori individuali) sono dati personali ai sensi della legge russa 152-FZ. Condividi ciò che l'AI legge su di loro solo con chi è autorizzato a vederlo.

Errori comuni: 401 o 403 significa che la chiave è sbagliata, è stata revocata o appartiene a un'altra azienda. 404 su uno strumento di dettaglio indica un id errato.

Il connettore non esegue, registra né elimina mai pagamenti, e nessuno strumento sposta denaro.

Step 2 — Installa l'adapter

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

Step 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 Moedelo.

Tool disponibili

Esempi di prompt

• "Quali nostre fatture di settembre non sono ancora pagate, e a quali controparti sono intestate?"
• "Trova la controparte OOO Romashka e mostrami i suoi contratti e i dati bancari."
• "Mostrami tutte le operazioni di banca e cassa della settimana scorsa, entrate e uscite."
• "Quali dichiarazioni e versamenti fiscali scadono nel prossimo mese secondo lo scadenzario?"
• "Quali atti e documenti di trasporto chiudono la fattura n. 152, ed è già stata pagata?"

FAQ

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

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT