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 Meta Muse in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Sage Accounting con la configurazione guidata e aggiungi il tuo URL MCP a Meta Muse. 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 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) + Meta Muse
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 Muse
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.
Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.
- In Muse apri Settings → Connectors e scegli Add custom connector.
- Incolla l'URL del server MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
- In una chat, chiedi a Muse qualcosa che richiede i tool di
Sage Accounting (Sudafrica).
Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.
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
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.
Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.
Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.
Prossimi passi
Questa guida ti è stata utile?