Rendiconto per agenti AI
Collega Claude, Cursor o i tuoi script a Rendiconto con un accesso sicuro, limitato a un solo ente.
Indice
Cos'è
Con un accesso per agenti un assistente AI (Claude Code, Claude Desktop, Cursor) o un tuo script può leggere e, se glielo permetti, aggiornare la contabilità del tuo ente: classificare movimenti, importare estratti conto, controllare anomalie, preparare il rendiconto.
Rendiconto offre 145 strumenti, raggiungibili in due modi: il protocollo MCP e un'API HTTP (la CLI arriverà su npm a breve). Tutti usano le stesse regole, gli stessi permessi e lo stesso registro delle attività.
L'accesso lo crei tu in Impostazioni › Accesso per agenti e API. Serve un abbonamento Premium o Studio.
Sicurezza e permessi
- Un solo ente. Il token vale per l'ente in cui lo crei. Nessuno strumento accetta l'indicazione di un altro ente.
- Mai più dei tuoi permessi. Un agente non può fare più di quanto puoi fare tu con il tuo ruolo; se il tuo ruolo cambia o ti tolgono dall'ente, l'accesso si adegua o smette entro un minuto.
- Permessi a scelta. Scegli tra «Solo lettura», «Assistente» e «Completo», oppure permesso per permesso. Si parte da sola lettura.
- Conferma per le operazioni delicate. Importazioni, annullamenti e modifiche in blocco sopra 50 movimenti si fermano e chiedono la tua conferma prima di essere eseguite.
- Nessuna esportazione in massa di dati personali. Certificazioni uniche, F24, libro soci e registro delle attività non si scaricano tramite agenti.
- Esercizi e regime restano tuoi. Un agente non apre, chiude né cambia il regime di un esercizio.
- Tutto è registrato. Ogni scrittura compare nel registro delle attività come fatta da un agente, con il nome dell'accesso. Puoi revocarlo in qualsiasi momento.
- Il token si vede una volta sola. Dura al massimo un anno (90 giorni di default), si può limitare a certi indirizzi IP e Rendiconto ne conserva solo un'impronta, mai il valore.
Tratta il token come una password: non incollarlo in chat, repository o screenshot. Se lo perdi, revocalo e creane uno nuovo.
Collegare il tuo assistente
Crea l'accesso nell'app: il token compare una volta sola, insieme alle istruzioni pronte da copiare. Qui sotto trovi gli stessi comandi, con rmcp_… al posto del tuo token.
Claude Code
export RENDICONTO_TOKEN='rmcp_…'Claude Code
claude mcp add --transport http rendiconto https://rendiconto.io/api/mcp --header "Authorization: Bearer ${RENDICONTO_TOKEN}"Claude Code
claude plugin marketplace add Agentica-srls/rendiconto-agent-kitClaude Code
claude plugin install rendiconto@rendiconto-agent-kitClaude Desktop · claude_desktop_config.json
{
"mcpServers": {
"rendiconto": {
"command": "npx",
"args": [
"-y",
"mcp-remote@0.14.3",
"https://rendiconto.io/api/mcp",
"--header",
"Authorization:${AUTH}"
],
"env": {
"AUTH": "Bearer rmcp_…"
}
}
}
}Cursor · ~/.cursor/mcp.json
{
"mcpServers": {
"rendiconto": {
"url": "https://rendiconto.io/api/mcp",
"headers": {
"Authorization": "Bearer rmcp_…"
}
}
}
}Altro client MCP
https://rendiconto.io/api/mcpAltro client MCP
Streamable HTTPAltro client MCP
Authorization: Bearer rmcp_…API HTTP
export RENDICONTO_TOKEN='rmcp_…'API HTTP
curl -s https://rendiconto.io/api/agent/v1/whoami -H "Authorization: Bearer ${RENDICONTO_TOKEN}"Claude Desktop usa il ponte mcp-remote e Rendiconto oggi accetta un token, non il login OAuth: per questo il «connettore personalizzato» di Claude non si può usare. Il blocco Claude Desktop qui sopra indica già la versione esatta, mcp-remote@0.14.3, e non mcp-remote senza versione: lasciala così, perché un aggiornamento futuro del ponte, che vede il token, non parta da solo.
Per uno script o un altro programma non serve nessun client MCP: ogni strumento è anche una chiamata HTTP, descritta in openapi.json (OpenAPI 3.1) e in tools.json. Il blocco «API HTTP» qui sopra verifica che il token funzioni.
Poi chiedi all'assistente di chiamare get_workspace_info: risponde con il nome dell'ente, i regimi degli esercizi e i permessi di questo accesso.
Cosa può fare un agente
Gli strumenti che un accesso vede dipendono dai suoi permessi, dal tuo ruolo, dal piano e dal regime dell'ente. Il catalogo completo, in formato leggibile da una macchina, è in tools.json. Gli strumenti con un asterisco modificano i dati; con due asterischi chiedono conferma.
Contesto dell'ente
- Informazioni sull'ente
get_workspace_info - Esercizi
list_years - Conti e casse
list_bank_accounts - Collaboratori dell'ente
list_members
Contabilità per competenza
- Piano dei conti (elenco)
list_accounts - Piano dei conti (albero)
get_piano_conti - Bilancio di verifica
get_trial_balance - Stato Patrimoniale (Modello A)
get_modello_a - Rendiconto Gestionale (Modello B)
get_modello_b - Partite aperte (crediti/debiti)
list_open_items - Scritture del giornale
list_journal_entries - Dettaglio scrittura
get_journal_entry - Stato riconciliazione
reconcile_status - Verifica quadratura
check_quadratura - Verifica chiudibilità esercizio
validate_period_close - Salute contabile
get_salute - Ratei, risconti e fondi
list_assestamenti - Cespiti
list_cespiti - Saldi di apertura
get_saldi_apertura - Creare una scrittura in prima nota*
create_journal_entry - Modificare una scrittura in bozza*
update_journal_entry - Inviare una scrittura in approvazione*
submit_journal_entry - Ritirare una scrittura dall'approvazione*
withdraw_journal_entry - Eliminare una scrittura in bozza**
delete_journal_entry - Registrare un rateo, risconto o fondo*
create_assestamento - Eliminare un rateo, risconto o fondo**
delete_assestamento - Registrare un cespite*
create_cespite - Dismettere un cespite**
dispose_cespite - Eliminare un cespite**
delete_cespite - Registrare i saldi di apertura**
set_saldi_apertura
Movimenti
- Elenco movimenti
list_movements - Dettaglio movimento
get_movement - Movimenti da classificare
list_unclassified_movements - Controparti
list_counterparties - Avvisi sui movimenti
list_movement_warnings - Commenti
list_comments - Annotare un movimento*
annotate_movement - Risolvere un avviso*
resolve_movement_warning - Registrare un movimento di cassa*
create_cash_movement - Aggiungere un commento*
add_comment - Correggere un movimento manuale**
update_manual_movement - Eliminare un movimento manuale**
delete_manual_movement - Eliminare un proprio commento**
delete_comment
Categorie
- Categorie
list_categories - Utilizzo delle categorie
get_category_usage - Mappatura Modello D
get_modello_d_mapping - Creare una categoria*
create_category - Modificare una categoria**
update_category - Suggerire la voce RUNTS*
suggest_runts_mapping
Classificazione e regole
- Regole di classificazione
list_classification_rules - Classificazioni incerte
list_low_confidence - Abbinamenti documento-movimento
suggest_document_matches - Classificare un movimento*
classify_movement - Classificare più movimenti**
bulk_classify_movements - Suggerire la classificazione*
suggest_classification - Accettare un suggerimento*
accept_classification - Accettare più suggerimenti**
bulk_accept_classifications - Creare una regola*
create_classification_rule - Modificare una regola*
update_classification_rule - Applicare le regole di classificazione**
apply_classification_rules
Centri di costo
- Centri di costo
list_cost_centers - Report centri di costo
get_cost_center_report - Completezza centri di costo
get_cost_center_completeness - Ripartire sui centri di costo*
allocate_cost_centers - Assegnare un centro di costo a più movimenti**
bulk_assign_cost_center - Creare un centro di costo*
create_cost_center - Modificare un centro di costo*
update_cost_center
Contributi
- Contributi
list_contributi - Dettaglio contributo
get_contributo - Rendicontazione del contributo
get_contributo_rendicontazione - Andamento del contributo
get_contributo_trend - Schemi dei finanziatori
list_funder_schemes - Creare un contributo*
create_contributo - Modificare un contributo**
update_contributo - Impostare il budget del contributo*
set_contributo_budget - Registrare un'erogazione*
record_disbursement - Imputare spese a un contributo**
allocate_to_contributo - Rimuovere un'imputazione*
remove_contributo_allocation - Aggiungere una nota al contributo*
add_contributo_note - Segnare la rendicontazione come inviata**
mark_contributo_report_sent
Documenti
- Documenti
list_documents - Dettaglio documento
get_document - Link di download del documento
get_document_download_link - Caricare un documento*
upload_document - Collegare un documento*
link_document - Scollegare un documento*
unlink_document - Leggere i dati di un documento*
extract_document_data - Leggere uno scontrino*
scan_receipt
Importazione estratti conto
- Importazioni eseguite
list_import_batches - Creare un link di caricamento*
create_upload_link - Anteprima importazione estratto conto*
import_statement_preview - Confermare l'importazione**
import_statement_confirm - Annullare un'importazione**
undo_import
Relazione, bilancio e analisi
- Analisi
get_analisi - Bilancio analitico
get_analitico - Pivot centri di costo
get_cdc_pivot - Modello D
get_modello_d - Modello E
get_modello_e - Relazione di missione (Modello C)
get_modello_c - Preventivo
get_preventivo - Previsioni
get_forecast - Sezioni della relazione di missione
get_relazione_sections - Istantanee
list_snapshots - Scrivere una sezione della relazione*
update_relazione_section - Creare un'istantanea*
create_snapshot - Rendiconti 5×1000
list_cinque_per_mille - Dettaglio rendiconto 5×1000
get_cinque_per_mille - Creare un rendiconto 5×1000*
create_cinque_per_mille - Aggiornare un rendiconto 5×1000*
update_cinque_per_mille
Scadenze
- Scadenze
list_scadenze - Creare una scadenza*
create_scadenza - Completare una scadenza*
complete_scadenza - Rimandare una scadenza*
snooze_scadenza - Riattivare una scadenza*
unsnooze_scadenza
Rimborsi ai volontari
- Rimborsi
list_rimborsi - Dettaglio rimborso
get_rimborso - Ritenute
list_ritenute - Creare una richiesta di rimborso*
create_rimborso - Esportare l'autodichiarazione di rimborso
export_rimborso_declaration - Riepilogo ritenute e F24
get_ritenute_report - Percipienti
list_percipienti - Dettaglio percipiente
get_percipiente
Anomalie e revisione
- Anomalie
list_anomalies - Coda di revisione
get_review_queue - Checklist di fine anno
get_year_end_checklist - Archiviare un'anomalia*
dismiss_anomaly
Soci e quote associative
- Soci
list_soci - Scheda del socio
get_socio - Quote associative
list_quote - Quote non pagate
list_quote_non_pagate - Aggiungere un socio*
create_socio - Modificare un socio**
update_socio - Registrare il pagamento di una quota**
record_quota_payment - Sollecitare un socio**
send_quota_reminder - Sollecitare i soci con quote non pagate**
send_quota_reminders
Esportazioni
- Esportare l'analisi
export_analisi - Esportare il Modello D
export_modello_d - Esportare i Modelli A, B e C
export_modello_a_b_c - Esportare la cartella dei report
export_report_workbook - Esportare i movimenti
export_movements - Esportare il pacchetto di rendicontazione
export_contributo_bundle - Esportare il report dei centri di costo
export_cost_center_report - Esportare lo scadenzario
export_scadenzario - Esportare il libro giornale
export_libro_giornale - Esportare il rendiconto 5×1000
export_cinque_per_mille
Cosa l'agente non fa. Queste cose restano a una persona, o perché sono decisioni (la risposta è tool_excluded, con il motivo e dove farle), o perché non esiste ancora uno strumento. In ogni caso si fanno nell'app:
- Regime contabile. Cassa o competenza: Impostazioni dell'ente › Profilo dell'ente › Regime contabile.
- Esercizi. Creare, chiudere o riaprire: Impostazioni dell'ente › Esercizi.
- Contributi. Eliminarli (un agente può solo chiuderli): Contributi › apri il contributo › Elimina.
- Ente, piano e fatturazione. Impostazioni dell'ente e Impostazioni › Fatturazione.
- Collaboratori e ruoli. Inviti e permessi: Impostazioni dell'ente › Collaboratori.
- Accessi per agenti. Crearli o revocarli: Impostazioni dell'ente › Accesso per agenti e API.
- Dati personali in massa. Certificazioni Uniche, F24, libro soci ed elenco quote si scaricano dall'app (Esportazioni, Soci).
- Rimborsi. Approvarli, registrare la delibera per i rimborsi autocertificati e collegarli al bonifico: Rimborsi.
- Contabilità per competenza. Contabilizzare, stornare o respingere le scritture, chiudere il periodo, cambiare il piano dei conti, approvare o depositare il bilancio: Contabilità. Un agente può preparare solo bozze.
- Soci. Eliminare un socio, generare le quote dell'anno, ricollegare una quota già pagata a un altro movimento: Soci.
- Movimenti. Correggere o togliere un movimento importato dalla banca (un'importazione recente e non lavorata si annulla con
undo_import), modificare un commento (si cancella e si riscrive), cambiare il conto di un movimento: Movimenti. - Altre sezioni. Verbali, registro del volontariato, raccolte fondi, ricevute ai donatori, anagrafica contatti, richieste e scritture di previsione non hanno strumenti per agenti: Verbali, Volontariato, Raccolte fondi, Richieste, Previsioni.
Flussi guidati
Il server offre nove flussi guidati come prompt MCP; il plugin per Claude Code li installa come skill con gli stessi nomi. Ognuno dice all'assistente di fermarsi e chiederti prima di ogni operazione delicata, di non inventare mai importi e di citare data, importo e descrizione dei movimenti.
- Importa estratto conto (
importa-estratto-conto): Carica un estratto conto, mostra anteprima, errori e duplicati, importa dopo conferma e passa alla classificazione. - Classifica movimenti (
classifica-movimenti): Classifica i movimenti senza categoria: prima le regole, poi i suggerimenti, poi la classificazione in blocco con conferma. - Controlla anomalie (
controlla-anomalie): Passa in rassegna anomalie e avvisi, li spiega in italiano semplice e corregge solo con il consenso della persona. - Prepara il rendiconto di fine anno (
prepara-rendiconto-fine-anno): Checklist di fine anno, quadratura del Modello D, bozza della relazione di missione ed esportazioni. - Rendiconta un contributo (
rendiconta-contributo): Individua le spese non ancora imputate a un contributo, le ripartisce e prepara il fascicolo di rendicontazione. - Analisi per centri di costo (
analisi-centri-di-costo): Verifica la completezza dei centri di costo, assegna quelli mancanti e commenta l'analisi. - Scadenze del mese (
scadenze-del-mese): Elenca scadute, prossime 30 giorni e rimandate come checklist e completa quelle che la persona conferma. - Rimborsi ai volontari (
rimborsi-volontari): Crea la richiesta di rimborso dai giustificativi e prepara la dichiarazione da firmare. - Verifica la quadratura del bilancio (
verifica-quadratura-bilancio): Per gli enti in competenza: quadratura, chiusura del periodo, riconciliazione e salute della contabilità.
Plugin e skill per Claude Code
Il plugin rendiconto collega Claude Code al server MCP e installa le nove skill in italiano (le stesse dei flussi guidati qui sotto) con le scorciatoie /rendiconto:…. Funziona senza npm: il collegamento è HTTP e legge il token dalla variabile RENDICONTO_TOKEN. Il kit è pubblico: github.com/Agentica-srls/rendiconto-agent-kit.
1. Aggiungere il marketplace
claude plugin marketplace add Agentica-srls/rendiconto-agent-kit2. Installare il plugin
claude plugin install rendiconto@rendiconto-agent-kit3. Salvare il token per sempre (Mac e Linux, zsh)
echo "export RENDICONTO_TOKEN='rmcp_…'" >> ~/.zshrc- Sostituisci
rmcp_…con il tuo token, apri un nuovo terminale e riavvia Claude Code. Su Windows (PowerShell) usasetx RENDICONTO_TOKEN "rmcp_…". - Il token resta scritto in chiaro in un file: fallo solo su un computer tuo. Se preferisci non toccare il terminale, lo stesso valore può stare nella sezione
envdi~/.claude/settings.json. - Verifica: apri una nuova sessione di Claude Code e scrivi «chi sono su Rendiconto?». Deve nominare il tuo ente. Poi prova, per esempio, «importa questo estratto conto» o
/rendiconto:classifica. - Senza plugin, il solo collegamento:
claude mcp add --transport http rendiconto https://rendiconto.io/api/mcp --header …(il comando completo è nel blocco Claude Code qui sopra).
CLI Rendiconto: in arrivo
La CLI @rendiconto/cli (il comando rendiconto per importare, classificare ed esportare dal terminale e dagli script) arriverà su npm a breve. Non serve per usare Rendiconto con Claude: per ora usa il plugin, claude mcp add o l'API HTTP.
API HTTP
Ogni strumento è anche una chiamata HTTP. Il contratto è in openapi.json (OpenAPI 3.1). Si autentica con l'intestazione Authorization: Bearer …. Gli errori hanno sempre la forma { error, code, details?, callId }.
Chi sono
curl -s https://rendiconto.io/api/agent/v1/whoami -H "Authorization: Bearer ${RENDICONTO_TOKEN}"Chiamare uno strumento
curl -s -X POST https://rendiconto.io/api/agent/v1/tools/list_years -H "Authorization: Bearer ${RENDICONTO_TOKEN}" -H "Content-Type: application/json" -d '{}'Per il protocollo MCP l'indirizzo è https://rendiconto.io/api/mcp (Streamable HTTP, solo POST, con il token nell'intestazione e mai nell'indirizzo).
Limiti e uso equo
I limiti proteggono la tua contabilità e il servizio. Sono pensati per un uso normale, non per scaricare tutto in massa.
- Al minuto, per accesso: 120 letture, 30 scritture, 30 esportazioni, 20 chiamate con AI.
- Al giorno: 5000 chiamate per accesso; per ente 10000 chiamate, 2000 scritture, 200 esportazioni.
- Al massimo 20 accessi attivi per ente.
- Gli strumenti che usano l'AI consumano la quota AI del tuo abbonamento e richiedono il permesso «Usare l'AI dell'abbonamento».
- Un accesso con troppe richieste rifiutate viene sospeso e te lo diciamo via email.
Domande frequenti
Quali piani includono l'accesso per agenti?
Premium e Studio, con limiti di uso equo. Il piano gratuito non lo include.
Chi può creare un accesso?
Tesoriere, contabile, presidente e studi con accesso all'ente. I permessi dell'accesso non superano quelli di chi lo crea.
Un agente può cancellare dati?
Può annullare solo ciò che l'app permette di annullare, sempre dopo la tua conferma e con una traccia nel registro. Non cancella enti, conti né account.
Cosa vede Rendiconto delle mie conversazioni?
Niente: vede solo le chiamate agli strumenti (nome, esito, durata), non il testo delle conversazioni. Nel registro compare un'impronta degli argomenti, non i valori.
Posso usare un solo token per più enti?
Non ancora: oggi un accesso vale per un solo ente. Gli accessi per l'intero studio sono previsti in una fase successiva.
Come revoco un accesso?
In Impostazioni › Accesso per agenti e API, «Revoca accesso». Ha effetto entro un minuto.
Novità
Versione del catalogo strumenti: 1.0.0.
- 14 ottobre 2026. Soci e quote, 5×1000, ritenute e percipienti, bozze di prima nota per la competenza, correzione dei movimenti manuali, regole di classificazione senza AI; errori con codici stabili (
validation_failed,conflict,ai_unavailable…) e, per ciò che un agente non fa,tool_excludedcon il perché e dove farlo. Le esportazioni salgono a 30 al minuto. - 1.0.0. Prima versione: 145 strumenti di lettura e scrittura, nove flussi guidati, server MCP, API HTTP.