Guida al connettore11 minuti di lettura33 tool MCP7 lingue

Collegare Sage Accounting a Cursor via MCP

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.

HCA cura del team HelpCodeAggiornato 11 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Sage Accounting (South Africa)

Sage Accounting (South Africa)

Sage Business Cloud Accounting, South African edition (the former Sage One): companies, customers, suppliers, items, tax invoices, quotes, supplier invoices, chart of accounts, bank transactions, customer receipts, ageing, profit and loss and balance sheet. Sign-in with your Sage login and an API key from Sage.

tool

33

Regione

INTL

Categoria

Contabilità

Autenticazione

Basic Auth

Env vars richieste

SAGE_ZA_API_HOSTSAGE_ZA_USERNAMESAGE_ZA_PASSWORDSAGE_ZA_API_KEY
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

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 Cursor in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Sage Accounting con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. 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.

Sage Accounting (South Africa) · live via MCP
Condividi
Opus 4.7

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) + Cursor

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.

  1. 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 in SAGE_ZA_API_KEY.
  2. 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.
  3. Inserisci l'indirizzo e-mail e la password di un utente Sage Accounting in SAGE_ZA_USERNAME e SAGE_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).
  4. Facoltativo: inserisci l'ID dell'azienda in cui lavora l'assistente in SAGE_ZA_COMPANY_ID. Trovalo con sage_accounting_za_list_companies. Senza di esso, passa company_id in 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 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 Sage Accounting (Sudafrica).

Strumenti disponibili

StrumentoCosa fa
sage_accounting_za_list_companiesElenca le aziende che questo login Sage può aprire: ID, Nome, SimboloValuta, NumeroFiscale, NomeRegistrato, PaeseId, Attivo, ÈProprietario…
sage_accounting_za_list_customersElenca i clienti: ID, Nome, Categoria, NomeContatto, Email, Telefono, Mobile, RiferimentoFiscale, Saldo, LimiteCredito, indirizzo postale e di consegna…
sage_accounting_za_get_customerLeggi 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_suppliersElenca i fornitori: ID, Nome, Categoria, NomeContatto, Email, Telefono, RiferimentoFiscale, Saldo, LimiteCredito, righe indirizzo, Attivo e Modificato.…
sage_accounting_za_get_supplierLeggi 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_itemsElenca gli articoli (prodotti e servizi): ID, Codice, Descrizione, Categoria, PrezzoEsclusivo, PrezzoInclusivo, UltimoCosto, Unità, Fisico (articolo di magazzino…
sage_accounting_za_get_itemLeggi 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_invoicesElenca le fatture fiscali (fatture di vendita): ID, NumeroDocumento, Data, DataScadenza, CustomerId, NomeCliente, Riferimento, Esclusivo, Tassa, Totale…
sage_accounting_za_get_tax_invoiceLeggi una fattura fiscale con le sue righe: numero documento, date, cliente, indirizzi, sconto, Esclusivo, Tassa, Totale, ImportoDovuto e per riga…
sage_accounting_za_list_quotesElenca i preventivi: ID, NumeroDocumento, Data, DataScadenza, CustomerId, NomeCliente, Riferimento, Esclusivo, Tassa, Totale e Stato. Solo lettura, 100…
sage_accounting_za_get_quoteLeggi 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_invoicesElenca le fatture fornitore (fatture di acquisto): ID, NumeroDocumento, Data, DataScadenza, SupplierId, NomeFornitore, Riferimento, Esclusivo, Tassa, Totale…
sage_accounting_za_get_supplier_invoiceLeggi una fattura fornitore con le sue righe: numero documento, date, fornitore, riferimento, Esclusivo, Tassa, Totale, ImportoDovuto e per riga il…
sage_accounting_za_list_accountsElenca i conti contabili (piano dei conti senza conti di sistema): ID, Nome, Descrizione, Categoria (ID e Descrizione), Saldo…
sage_accounting_za_list_account_categoriesElenca 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_typesElenca 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_accountsElenca conti bancari e carte di credito: ID, Nome, NomeBanca, NumeroConto, NumeroFiliale, Categoria, Saldo, Predefinito, CurrencyId…
sage_accounting_za_list_bank_transactionsElenca le transazioni bancarie del libro cassa: ID, BankAccountId, Data, Tipo, Beneficiario, Descrizione, Riferimento, NumeroDocumento, Esclusivo, Tassa…
sage_accounting_za_list_customer_receiptsElenca le ricevute clienti (pagamenti ricevuti): ID, CustomerId, Data, NumeroDocumento, Riferimento, Descrizione, Totale, Sconto…
sage_accounting_za_get_customer_ageingScadenza 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_ageingScadenza 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_documentsElenca 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_lossConto 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_sheetStato patrimoniale alla data: un albero di livelli di reporting (attività, passività, patrimonio) con Descrizione, NumeroConto, Categoria, Figli…
sage_accounting_za_get_account_balancesMovimento per conto contabile su un intervallo di date, come un bilancio di verifica: ID conto, Descrizione, CategoryId, CategoriaDescrizione, Dare…
sage_accounting_za_save_customerCrea 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_supplierCrea 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_itemCrea 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_accountCrea 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_quoteCalcola 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_quoteCrea 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_invoiceCalcola 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_invoiceCrea 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.

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

Prossimi passi

Questa guida ti è stata utile?

Collega Sage Accounting a Cursor in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Sage Accounting con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. Senza codice e senza server da gestire.

Guide correlate

Connettori

Collegare Sage Accounting a ChatGPT via MCP

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.

Connettori

Collegare Sage Accounting a Claude via MCP

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.

Connettori

Collegare Sage Accounting a Microsoft Copilot via MCP

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.

Connettori

Collegare Sage Accounting a Gemini CLI via MCP

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.

Connettori

Collegare Sage Accounting a Meta Muse via MCP

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.

Connettori

Sage Accounting MCP: fatture e preventivi

Sage Business Cloud Accounting, edizione sudafricana (l'ex Sage One): aziende, clienti, fornitori, articoli, fatture fiscali, preventivi, fatture fornitori, 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.