In breve
Sage Business Cloud Accounting, edizione sudafricana (l'ex Sage One): aziende, clienti, fornitori, articoli, fatture fiscali, preventivi, fatture fornitore, piano dei conti, transazioni bancarie, ricevute clienti, scadenze, conto economico e stato patrimoniale. Accedi con il tuo login Sage e una chiave API di Sage.
Configurazione guidata
Collega Sage Accounting a Claude in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Sage Accounting con la configurazione guidata e aggiungi il tuo URL MCP a Claude. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
AnythingMCP è nella directory dei connettori di Claude: aggiungilo a Claude con un clic (si apre in una nuova scheda), poi accedi e scegli quali server MCP può usare Claude.
Prova a chiedere
Prompt di esempio per Sage Accounting (South Africa)
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 → Sage Accounting (South Africa), incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Sage Accounting (Sudafrica) + Claude
Sage Business Cloud Accounting, edizione sudafricana (l'ex Sage One): aziende, clienti, fornitori, articoli, fatture fiscali, preventivi, fatture fornitore, piano dei conti, transazioni bancarie, ricevute clienti, scadenze, conto economico e stato patrimoniale. Accedi con il tuo login Sage e una chiave API di Sage.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nel negozio dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
SAGE_ZA_API_HOST, SAGE_ZA_USERNAME, SAGE_ZA_PASSWORD, SAGE_ZA_API_KEY
Passo 1 — Ottieni le credenziali
La configurazione richiede fino a 2 giorni lavorativi.
- Richiedi una chiave API su https://accounting.sageone.co.za/marketing/developerprogram.aspx (Richiedi la tua chiave API). Sage emette una chiave per applicazione; appare come
39478ac6-ac2a-44d8-a31c-7e7e14af4de3. Incollala inSAGE_ZA_API_KEY. - Scegli il sito su cui accedi in
SAGE_ZA_API_HOST: accounting.sageone.co.za per la maggior parte degli account, o resellers.accounting.sageone.co.za quando è quella la tua pagina di accesso. - Inserisci l'indirizzo e-mail e la password di un utente Sage Accounting in
SAGE_ZA_USERNAMEeSAGE_ZA_PASSWORD. L'API utilizza l'autenticazione HTTP Basic con le stesse credenziali dell'applicazione web, quindi si consiglia un utente dedicato con solo l'accesso necessario per l'assistente. Un utente invitato accede solo alle funzioni consentite dal proprio ruolo (altre chiamate restituiscono 405). - Facoltativo: inserisci l'ID dell'azienda in cui lavora l'assistente in
SAGE_ZA_COMPANY_ID. Trovalo consage_accounting_za_list_companies. Senza di esso, passacompany_idin ogni chiamata.
Dove iniziare: sage_accounting_za_list_companies mostra le aziende del login e il loro ID. Ogni altro strumento funziona all'interno di un'azienda (company_id, o il predefinito del connettore).
Clienti, fornitori, articoli: sage_accounting_za_list_customers, sage_accounting_za_get_customer, sage_accounting_za_list_suppliers, sage_accounting_za_get_supplier, sage_accounting_za_list_items, sage_accounting_za_get_item. Crea o modifica utilizzando sage_accounting_za_save_customer, sage_accounting_za_save_supplier e sage_accounting_za_save_item.
Documenti di vendita e acquisto: sage_accounting_za_list_tax_invoices e sage_accounting_za_get_tax_invoice (fatture di vendita), sage_accounting_za_list_quotes e sage_accounting_za_get_quote, sage_accounting_za_list_supplier_invoices e sage_accounting_za_get_supplier_invoice. Gli strumenti di elenco restituiscono solo intestazioni a meno che include_detail non sia vero. Scrivi un preventivo con sage_accounting_za_save_quote e una fattura con sage_accounting_za_save_tax_invoice; visualizza prima i totali con sage_accounting_za_calculate_quote o sage_accounting_za_calculate_tax_invoice. Una riga nomina un articolo (LineType 0) o un conto contabile (LineType 1) in SelectionId, con Quantità, un prezzo unitario e un TaxTypeId. Se un documento salvato ritorna con totali zero, passa le righe esattamente come restituite dallo strumento di calcolo.
Contabilità e banking: sage_accounting_za_list_accounts, sage_accounting_za_list_account_categories e sage_accounting_za_list_tax_types descrivono il piano dei conti; sage_accounting_za_save_account aggiunge o modifica un conto. sage_accounting_za_list_bank_accounts, sage_accounting_za_list_bank_transactions e sage_accounting_za_list_customer_receipts sono in sola lettura: questo connettore non registra ricevute o pagamenti e non sposta mai denaro.
Report: sage_accounting_za_get_customer_ageing e sage_accounting_za_get_supplier_ageing (chi deve cosa, per scadenza), sage_accounting_za_list_outstanding_customer_documents, sage_accounting_za_get_profit_and_loss, sage_accounting_za_get_balance_sheet e sage_accounting_za_get_account_balances (movimento per conto, come un bilancio di verifica). Queste sono chiamate POST che leggono solo.
Salvataggio: un Salva senza id crea un record; con id sostituisce quel record. Sage memorizza il record così come viene inviato, quindi un campo omesso in un aggiornamento può essere ripristinato: leggi prima il record e passa ciò che deve rimanere in extra_fields. I nuovi record sono attivi a meno che active non sia falso. Niente viene eliminato da questo connettore.
Filtraggio e paging: gli strumenti di elenco accettano un sottoinsieme di OData. filter e orderby funzionano solo su numeri, booleani e date, mai su testo (cerca nomi leggendo l'elenco). I letterali di data sono scritti DateTime'2026-01-31'; se Sage rifiuta quella forma, prova la data tra virgolette da sola. Ogni elenco è limitato a 100 righe: la risposta è avvolta come TotalResults, ReturnedResults e Results; aumenta skip di 100 fino a ottenere righe TotalResults.
Limiti: 100 richieste al minuto per azienda e 5.000 al giorno per utente. Superare il limite di un minuto blocca l'indirizzo IP per un'ora (HTTP 429), quindi mantieniti su circa una chiamata al secondo e non riprovare in un ciclo. 20 accessi falliti in un'ora bloccano l'utente per 24 ore: dopo un 401, fermati e fai controllare le credenziali.
Campi e formati: gli ID sono interi. Le date sono YYYY-MM-DD. Gli importi sono decimali nella valuta dell'azienda a meno che un cliente o fornitore non abbia la propria valuta (vedi Customer_CurrencyId e il tasso di cambio sul documento). Esclusivo è l'importo prima delle tasse, Tax l'IVA e Totale l'importo comprensivo di tasse. Errori: 400 porta i messaggi di validazione, 402 significa che l'abbonamento Sage è scaduto, 404 che il record non è in questa azienda, 409 che un record è in uso.
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 Claude
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 mostriYOUR_SERVER_ID.
Percorso consigliato: funziona su claude.ai web senza modificare alcun file di configurazione.
- In Claude apri Plugins (in alcuni piani ancora Customize) → Connectors.
- Clicca + Add e poi Add custom connector.
- Inserisci un nome, ad esempio
Sage Accounting (South Africa), e l'URL del server MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Continue, mantieni le impostazioni rilevate e clicca di nuovo Continue. - Scegli Sign in now, clicca Add e accedi ad AnythingMCP (OAuth) per consentire l'accesso.
Tutti gli strumenti qui sotto appariranno nella tua chat: inizia a digitare i prompt.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
sage_accounting_za_list_companies | Elenca le aziende che questo login Sage può aprire: ID, Nome, SimboloValuta, NumeroFiscale, NomeRegistrato, PaeseId, Attivo, ÈProprietario… |
sage_accounting_za_list_customers | Elenca i clienti: ID, Nome, Categoria, NomeContatto, Email, Telefono, Mobile, RiferimentoFiscale, Saldo, LimiteCredito, indirizzo postale e di consegna… |
sage_accounting_za_get_customer | Leggi un cliente con ogni campo: nome, categoria, contatto, riferimento fiscale, saldo, limite di credito, indirizzi, tipo di tassa predefinito, lista prezzi… |
sage_accounting_za_list_suppliers | Elenca i fornitori: ID, Nome, Categoria, NomeContatto, Email, Telefono, RiferimentoFiscale, Saldo, LimiteCredito, righe indirizzo, Attivo e Modificato.… |
sage_accounting_za_get_supplier | Leggi un fornitore con ogni campo: nome, categoria, dettagli di contatto, riferimento fiscale, saldo, indirizzi, tipo di tassa predefinito, valuta e scadenza… |
sage_accounting_za_list_items | Elenca gli articoli (prodotti e servizi): ID, Codice, Descrizione, Categoria, PrezzoEsclusivo, PrezzoInclusivo, UltimoCosto, Unità, Fisico (articolo di magazzino… |
sage_accounting_za_get_item | Leggi un articolo con ogni campo: codice, descrizione, categoria, prezzi di vendita, ultimo costo, unità, tipi di tassa, gruppi di reporting e definito dall'utente… |
sage_accounting_za_list_tax_invoices | Elenca le fatture fiscali (fatture di vendita): ID, NumeroDocumento, Data, DataScadenza, CustomerId, NomeCliente, Riferimento, Esclusivo, Tassa, Totale… |
sage_accounting_za_get_tax_invoice | Leggi una fattura fiscale con le sue righe: numero documento, date, cliente, indirizzi, sconto, Esclusivo, Tassa, Totale, ImportoDovuto e per riga… |
sage_accounting_za_list_quotes | Elenca i preventivi: ID, NumeroDocumento, Data, DataScadenza, CustomerId, NomeCliente, Riferimento, Esclusivo, Tassa, Totale e Stato. Solo lettura, 100… |
sage_accounting_za_get_quote | Leggi un preventivo con le sue righe: numero documento, data, data di scadenza, cliente, sconto, totali, stato e per riga l'articolo o il conto… |
sage_accounting_za_list_supplier_invoices | Elenca le fatture fornitore (fatture di acquisto): ID, NumeroDocumento, Data, DataScadenza, SupplierId, NomeFornitore, Riferimento, Esclusivo, Tassa, Totale… |
sage_accounting_za_get_supplier_invoice | Leggi una fattura fornitore con le sue righe: numero documento, date, fornitore, riferimento, Esclusivo, Tassa, Totale, ImportoDovuto e per riga il… |
sage_accounting_za_list_accounts | Elenca i conti contabili (piano dei conti senza conti di sistema): ID, Nome, Descrizione, Categoria (ID e Descrizione), Saldo… |
sage_accounting_za_list_account_categories | Elenca le categorie di conto (Vendite, Costo delle Vendite, Spese, Attività Correnti e così via): ID, Descrizione e Ordine. L'ID è la categoria… |
sage_accounting_za_list_tax_types | Elenca i tipi di tassa (IVA) dell'azienda: ID, Nome, Percentuale, ÈPredefinito e Attivo. L'ID è il TaxTypeId delle righe documento, articoli e… |
sage_accounting_za_list_bank_accounts | Elenca conti bancari e carte di credito: ID, Nome, NomeBanca, NumeroConto, NumeroFiliale, Categoria, Saldo, Predefinito, CurrencyId… |
sage_accounting_za_list_bank_transactions | Elenca le transazioni bancarie del libro cassa: ID, BankAccountId, Data, Tipo, Beneficiario, Descrizione, Riferimento, NumeroDocumento, Esclusivo, Tassa… |
sage_accounting_za_list_customer_receipts | Elenca le ricevute clienti (pagamenti ricevuti): ID, CustomerId, Data, NumeroDocumento, Riferimento, Descrizione, Totale, Sconto… |
sage_accounting_za_get_customer_ageing | Scadenza clienti (debitori) in dettaglio: per cliente i documenti in sospeso con data, numero documento, riferimento e l'importo in ciascuno… |
sage_accounting_za_get_supplier_ageing | Scadenza fornitori (creditori) in dettaglio: per fornitore i documenti in sospeso con data, numero documento, riferimento e l'importo in ciascuno… |
sage_accounting_za_list_outstanding_customer_documents | Elenca i documenti non pagati di un cliente (fatture fiscali, e con include_paid_invoices anche quelle pagate): tipo documento, numero, data… |
sage_accounting_za_get_profit_and_loss | Conto economico (income statement) per un intervallo di date: un albero di livelli di reporting (Vendite, Costo delle Vendite, Utile Lordo, Spese, Utile Netto)… |
sage_accounting_za_get_balance_sheet | Stato patrimoniale alla data: un albero di livelli di reporting (attività, passività, patrimonio) con Descrizione, NumeroConto, Categoria, Figli… |
sage_accounting_za_get_account_balances | Movimento per conto contabile su un intervallo di date, come un bilancio di verifica: ID conto, Descrizione, CategoryId, CategoriaDescrizione, Dare… |
sage_accounting_za_save_customer | Crea un cliente, o aggiorna uno quando viene fornito l'id. Restituisce il cliente salvato con il suo ID. Un Salva sostituisce l'intero record: per un aggiornamento… |
sage_accounting_za_save_supplier | Crea un fornitore, o aggiorna uno quando viene fornito l'id. Restituisce il fornitore salvato con il suo ID. Un Salva sostituisce l'intero record: per un aggiornamento… |
sage_accounting_za_save_item | Crea un articolo (prodotto o servizio), o aggiorna uno quando viene fornito l'id. Restituisce l'articolo salvato con il suo ID. Un Salva sostituisce l'intero record… |
sage_accounting_za_save_account | Crea un conto contabile, o aggiorna uno quando viene fornito l'id. Restituisce il conto salvato con il suo ID. La categoria decide dove il conto… |
sage_accounting_za_calculate_quote | Calcola i totali di un preventivo senza salvarlo: restituisce il documento con Esclusivo, Tassa, Totale e Sconto per riga e per l'intero… |
sage_accounting_za_save_quote | Crea un preventivo per un cliente, o aggiorna uno quando viene fornito l'id. Restituisce il preventivo salvato con il suo ID, NumeroDocumento e totali. Controlla i… |
sage_accounting_za_calculate_tax_invoice | Calcola i totali di una fattura fiscale senza salvarla: restituisce il documento con Esclusivo, Tassa, Totale e Sconto per riga e per l… |
sage_accounting_za_save_tax_invoice | Crea una fattura fiscale (fattura di vendita) per un cliente, o aggiorna una quando viene fornito l'id. Restituisce la fattura salvata con il suo ID, NumeroDocumento… |
Esempi di prompt
- "Quali clienti ci devono soldi da più di 60 giorni?"
- "Mostra il conto economico per l'ultimo trimestre finanziario."
- "Visualizza un'anteprima di una fattura fiscale per Acme Trading: 10 ore di consulenza a R950, poi salvala."
- "Elenca le fatture fornitore di ottobre che sono ancora in sospeso."
- "Quali sono i saldi dei nostri conti bancari e le ultime transazioni?"
FAQ
Funziona con Claude Code così come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Cosa mi serve per accedere? Una chiave API dal programma per sviluppatori di Sage (richiedila nella pagina per sviluppatori; può richiedere fino a 2 giorni lavorativi), il sito su cui accedi e l'e-mail e la password di un utente Sage Accounting. Si consiglia un utente dedicato con solo l'accesso necessario per l'assistente: 20 accessi falliti in un'ora bloccano l'utente per 24 ore.
È questo il Sage Accounting globale? No. È l'edizione sudafricana di Sage Business Cloud Accounting, l'ex Sage One e Sage Pastel My Business Online, utilizzata anche in altri mercati africani serviti dalla stessa piattaforma. Per Regno Unito, Irlanda, Nord America ed Europa utilizza il connettore Sage Business Cloud.
Cosa può cambiare e sposta denaro? Crea e aggiorna clienti, fornitori, articoli, conti, preventivi e fatture fiscali, con strumenti di calcolo per visualizzare prima i totali. I conti bancari, le transazioni bancarie e le ricevute clienti sono in sola lettura: non registra ricevute o pagamenti, non sposta mai denaro e non elimina nulla. Niente installazioni disattivate.
Prossimi passi
- Pagina di atterraggio del connettore
- Collegati a ChatGPT
- Collegati a Cursor
- Collegati a Gemini
- Collegati a Meta Muse
- Collegati a Microsoft Copilot
Questa guida ti è stata utile?