Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Tidely con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Pianificazione del cash flow con Tidely: cash flow e previsione per mese, settimana o giorno, scenari, categorie, conti bancari con saldi e movimenti, fatture di vendita e di acquisto e valori pianificati. Lettura più creazione e modifica di fatture, piani, categorie e movimenti; le cancellazioni sono disattivate all'installazione.
Prova a chiedere
Prompt di esempio per Tidely
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.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Tidely, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Tidely + Microsoft Copilot
Pianificazione del cash flow con Tidely: cash flow e previsione per mese, settimana o giorno, scenari, categorie, conti bancari con saldi e movimenti, fatture di vendita e di acquisto e valori pianificati. Lettura più creazione e modifica di fatture, piani, categorie e movimenti; le cancellazioni sono disattivate all'installazione.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
TIDELY_API_KEY
Step 1 — Ottieni le credenziali
La configurazione richiede circa 5 minuti. Ti serve un account Tidely con l'accesso API abilitato; l'unica credenziale è una API key.
Prima serve l'accesso API: l'API deve essere abilitata per il tuo account Tidely. Se Settings → API Keys non c'è, chiedi al supporto Tidely ([email protected]) di abilitarla.
- Accedi a Tidely e apri Settings → API Keys (app.tidely.com/settings/openapi). Clicca + per creare una key e assegnale gli scope che ti servono: lettura per i tool di lettura, e scrittura se l'AI deve creare o modificare fatture, piani, categorie o movimenti.
- Copia la key, conservala in un posto sicuro e inseriscila in
TIDELY_API_KEY. Incolla solo la key, senzaBearerné altri prefissi: il connettore la invia nell'headerX-Authorization. - Installa il connettore. Verifica la connessione con
tidely_verify_auth: restituisce il nome dell'utente a cui appartiene la key.
Cloud e self-hosting funzionano allo stesso modo: la API key è l'unica credenziale e non c'è nessuna Redirect URL da impostare.
Da dove partire: tidely_get_cashflow risponde alla maggior parte delle domande sulla liquidità: il saldo di oggi e la previsione per mese, settimana o giorno. Senza parametri usa lo scenario base, periodi mensili, 6 mesi indietro e 18 avanti. Per i mesi from è il primo giorno di un mese e to l'ultimo giorno di un mese (per le settimane un lunedì e una domenica). tidely_list_scenarios fornisce gli id degli altri scenari.
Le fatture vogliono il loro tipo: tidely_list_invoices, tidely_get_invoice e tidely_update_invoice richiedono invoiceTypeFilter SALE o PURCHASE, coerente con la fattura. Le fatture sincronizzate da un'integrazione ERP sono di sola lettura.
Movimenti e importazioni: i movimenti si elencano per conto bancario (bankAccountId). Nuovi movimenti si possono aggiungere solo ai conti gestiti in Tidely (provider API o OFFLINE). Prima di importare da un altro sistema, tidely_check_transactions_exist controlla fino a 1000 id esterni, così niente viene aggiunto due volte.
I piani si sommano: tidely_create_plan aggiunge un importo una tantum ai valori pianificati di una categoria in uno scenario (di default lo scenario base) per un giorno, una settimana o un mese; con replaceCurrentValuesForThePeriod li sostituisce. La categoria deve accettare valori pianificati; senza categoria l'importo va tra entrate o uscite non categorizzate.
Cosa legge: il cash flow per mese, settimana o giorno di uno scenario, con saldi iniziali e finali (effettivo, previsione e piano), fatture di vendita e di acquisto aperte, importi per categoria, KPI, scoperto e liquidità; gli scenari di pianificazione; l'albero delle categorie con i tipi di entrata e uscita; le società con valuta e paese; i conti bancari con IBAN, tipo, provider e saldo di riferimento, lo storico giornaliero dei saldi e i movimenti con controparte, causale e categoria; le fatture di vendita e di acquisto con contatto, date, importo lordo e aperto, stato, categoria e origine.
Disattivati all'installazione: tidely_delete_invoice, tidely_delete_category, tidely_delete_plans e tidely_delete_bank_account_transaction. Cancellano una fattura, una categoria, tutti i valori pianificati di una categoria in uno scenario o un movimento bancario, e nulla di tutto ciò si può annullare. Attiva nella pagina del connettore solo quelli che ti servono; l'AI ti chiede conferma prima di ogni modifica. La creazione e la modifica di fatture, categorie, piani e movimenti bancari sono attive (tidely_create_invoice, tidely_update_invoice, tidely_create_category, tidely_update_category, tidely_create_plan, tidely_create_bank_account_transaction, tidely_update_bank_account_transaction); queste chiamate richiedono una key con lo scope di scrittura.
Nessun movimento di denaro: movimenti e fatture sono dati per la pianificazione; nessun tool paga o trasferisce nulla. Importazioni massive, creazione o modifica di conti bancari e la Partner API (OAuth, per partner white-label) non fanno parte di questo connettore.
Importi, date e paginazione: gli importi sono decimali nella valuta del conto o della società, negativi per le uscite e le spese; le date sono YYYY-MM-DD. Le liste paginate partono da page 0, restituiscono di default 50 elementi per pagina e indicano totalPages.
Errori frequenti: 401 (INVALID_CREDENTIALS) vuol dire che la key manca o è sbagliata: creane una nuova e incollala senza prefisso. 403 (INSUFFICIENT_SCOPE) vuol dire che la key è valida ma non ha lo scope per quella chiamata: modifica i suoi scope in Settings → API Keys. 400 (INVALID_REQUEST) indica un input non valido, 404 un id sconosciuto, ad esempio CATEGORY_NOT_FOUND. Dopo un 500 conviene riprovare una volta dopo una breve attesa.
Step 2 — Installa l'adapter
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
Step 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
Tidely. - 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.
Tool disponibili
| Tool | What it does |
|---|---|
tidely_verify_auth | Check that the API key is valid; returns success and the name of the user the key belongs to |
tidely_list_companies | List the companies of the Tidely account (paged): id, parentId, name, currency, country and industry |
tidely_get_company | Get one company of the Tidely account by id: name, parent company, currency, country and industry |
tidely_get_cashflow | Get the cash flow of the company per period (month, week or day) for a scenario: for each period start date the opening and closing… |
tidely_list_scenarios | List the planning scenarios: id, name and isBaseCase |
tidely_get_scenario | Get one planning scenario by id: id, name and whether it is the base case |
tidely_list_categories | List the cash flow categories: id, name, type (INCOME_/EXPENSE_ OPERATIONAL, INVESTMENT or FINANCING), parentId for the hierarchy and… |
tidely_get_category | Get one category by id: name, type, parent and whether it accepts planned values |
tidely_list_bank_accounts | List the bank accounts in Tidely: id, companyId, account name, bank, IBAN or account number, currency, type (CHECKING, SAVINGS, CREDITCARD… |
tidely_get_bank_account | Get one bank account by id: name, bank, IBAN, currency, type, provider, reference balance and visibility |
tidely_list_bank_account_balances | List the balance history of one bank account (paged): date and amount per day |
tidely_list_bank_account_transactions | List the transactions of one bank account (paged): id, booking date, amount, counterpart name, IBAN and reference, purpose, category and… |
tidely_get_bank_account_transaction | Get one bank account transaction by id: booking date, amount, counterpart, purpose, category and external id |
tidely_check_transactions_exist | Check which of up to 1000 external ids already exist as transactions on a bank account, before importing transactions from another system |
tidely_list_invoices | List sales or purchase invoices (paged): id, number, contact, dates, gross and open amount, status, category, type, source (ERP sync… |
tidely_get_invoice | Get one invoice by id; invoiceTypeFilter must match its type |
tidely_create_invoice | Create a sales or purchase invoice (or credit note) so it shows up in the cash flow forecast on its due date |
tidely_update_invoice | Update an invoice: only the fields you pass change (status, paid date, open amount, due date, amounts, category, note ...) |
tidely_delete_invoice | Delete an invoice (not those synced from an ERP integration) |
tidely_create_category | Create a cash flow category, optionally under a parent category |
tidely_update_category | Rename a cash flow category or change its type (income or expense, operational, investment or financing) |
tidely_delete_category | Delete a cash flow category by id |
tidely_create_plan | Add a planned value to the forecast: a one-time amount on a category in a scenario for a day, week or month (negative for expenses… |
tidely_delete_plans | Delete all planned values of one category in one scenario |
tidely_create_bank_account_transaction | Add a transaction to a bank account kept in Tidely (an API or offline account), e.g. imported from another system |
tidely_update_bank_account_transaction | Update a bank account transaction: only the fields you pass change, typically its category |
tidely_delete_bank_account_transaction | Delete a bank account transaction |
Esempi di prompt
- "Qual è il nostro saldo di cassa oggi e cosa mostra la previsione per i prossimi sei mesi?"
- "Quali fatture di vendita sono ancora aperte e quali sono già scadute?"
- "Confronta mese per mese il saldo finale dello scenario base con i nostri altri scenari."
- "Segna come pagata oggi la fattura di acquisto 2026-118."
- "Aggiungi allo scenario base una spesa pianificata di 12.000 per nuovo hardware a marzo 2027 nella categoria IT."
FAQ
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?