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 Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Sage Accounting con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. 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) + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Sage Accounting (Sudafrica). - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, 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.
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
Questa guida ti è stata utile?