Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Falco 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
Falco, contabilità belga e fatturazione elettronica Peppol: documenti di acquisto e di vendita con i loro file, fatture ricevute via Peppol, ricerca dei partecipanti Peppol e clienti, articoli e fatture del modulo di fatturazione di Falco. Quasi tutto in sola lettura; l'impostazione dello stato di pagamento degli acquisti e l'invio delle risposte Peppol alle fatture sono disattivati all'installazione.
Prova a chiedere
Prompt di esempio per Falco
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 → Falco, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Falco
Falco, contabilità belga e fatturazione elettronica Peppol: documenti di acquisto e di vendita con i loro file, fatture ricevute via Peppol, ricerca dei partecipanti Peppol e clienti, articoli e fatture del modulo di fatturazione di Falco. Quasi tutto in sola lettura; l'impostazione dello stato di pagamento degli acquisti e l'invio delle risposte Peppol alle fatture sono disattivati all'installazione.
Setup
Il connettore richiede due chiavi, entrambe obbligatorie: un application secret dell'integratore e una chiave API del cliente Falco.
- L'integratore crea un'applicazione nel portale sviluppatori di Falco (dev.falco-app.be), richiede gli scope necessari, per esempio
documents:purchases:read,documents:sales:read,peppol:inbound:read,peppol:participants:read,customers:read,articles:readeinvoices:read, e la rende Public. Il suo Application Secret di produzione (as_live_...) va inFALCO_APP_SECRET. - Il cliente Falco, un amministratore dell'organizzazione con piano Expert Essential o Expert Premium, apre API access sotto le sue iniziali nell'applicazione desktop di Falco, sceglie quell'applicazione tramite il suo id (
app_...) e genera una API key (sk_live_...) per la sua organizzazione. Va inFALCO_API_KEY. - Installa il connettore ed esegui
falco_get_organizationper verificare entrambe le chiavi. Il connettore chiama l'API di produzione,https://api.falco-app.be/v1; le chiavi sandbox (as_test_,sk_test_) funzionano solo sull'host sandbox e qui vengono rifiutate.
Cosa legge: l'organizzazione a cui appartiene la chiave (nome, partita IVA, identificativo Peppol, indirizzo, IBAN, piano); i documenti di acquisto (fatture e note di credito dei fornitori) con stato di pagamento e Peppol, cronologia degli eventi e file allegati; i documenti di vendita, anche quelli importati come PDF o UBL; i documenti ricevuti via Peppol con mittente, importi, scadenza, riferimento di pagamento e conto bancario; e clienti, articoli e fatture del modulo di fatturazione di Falco, con righe, subtotali IVA e stato Peppol. Scarica anche i file: il file principale, l'XML UBL o un allegato di un documento di acquisto, l'UBL di un documento ricevuto via Peppol e il PDF di una fattura del modulo di fatturazione.
Come lo usa l'AI: per le fatture dei fornitori parte da falco_list_peppol_inbound (cosa è arrivato via Peppol) e falco_list_purchase_documents (tutti i documenti di acquisto con i loro file); per le vendite da falco_list_sale_documents o, per i documenti creati nel modulo di fatturazione, da falco_list_invoices. Per sapere se un'azienda può ricevere fatture elettroniche usa falco_find_peppol_participant con la partita IVA, oppure falco_check_peppol_participant con un id partecipante come 0208:0123456789.
Disattivati all'installazione: falco_set_purchase_payment_status e falco_send_invoice_response. Il primo sostituisce lo stato di pagamento di un documento di acquisto con not_paid, partially_paid o paid, per esempio dopo aver pagato un fornitore. Il secondo invia al mittente di un documento ricevuto una risposta alla fattura via Peppol (acknowledged, in_process, under_query, conditionally_accepted, rejected, accepted o paid); il fornitore la riceve subito e non si può ritirare. Un amministratore li attiva consapevolmente. Anche allora l'AI ti mostra il documento e il nuovo stato o la risposta e aspetta il tuo sì.
Date e importi: i filtri accettano YYYY-MM-DD. Gli importi sono stringhe nella valuta del documento, di solito EUR. Gli elenchi sono paginati con page (da 0) e page_size (da 20 a 200, fatture fino a 100), e l'AI chiede la pagina successiva finché una pagina torna piena.
Limiti: 60 richieste al minuto per application secret. Oltre, Falco risponde 429 e l'AI aspetta e riprova.
Errori comuni: gli errori seguono la RFC 9457 con title, detail e code. 401 significa un application secret o una chiave API sbagliati, oppure una chiave sandbox usata in produzione. 403 significa che alla chiave manca lo scope per quell'area; il cliente concede gli scope quando crea la chiave. 404 nella ricerca di un partecipante significa che l'azienda non è raggiungibile via Peppol.
Chiede prima di ogni modifica: FALCO_APP_SECRET, FALCO_API_KEY
Installazione locale del connettore
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
Apri http://localhost:3000/connectors/store, scegli Falco e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| Tool | What it does |
|---|---|
falco_get_organization | Get the Falco organization the API key belongs to: name, VAT number, Peppol identifier, address, IBANs, profiles, plan (expert_essential or… |
falco_list_purchase_documents | List purchase documents (supplier invoices and credit notes) in Falco, newest first: id, number, invoice and due date, currency, amount… |
falco_get_purchase_document | Get one purchase document by id: number, dates, amount, supplier, payment and Peppol status, its event history and the list of attached… |
falco_download_purchase_document_file | Download a file of a purchase document: the main file (usually the PDF), the UBL XML, or one attached file |
falco_list_sale_documents | List sale documents (sales invoices and credit notes, including those imported as PDF or UBL), newest first: id, number, dates, currency… |
falco_get_sale_document | Get one sale document by id: number, dates, amount, customer, payment status, Peppol send status, event history and attached files |
falco_list_peppol_inbound | List documents received over Peppol (incoming e-invoices and credit notes), newest first: id, received date, invoice and due date, amount… |
falco_get_peppol_inbound_document | Get one document received over Peppol by id: sender, amounts, dates, payment reference, bank account, invoice reference and payment status |
falco_download_peppol_inbound_document | Download the file of a document received over Peppol (the UBL XML as received) |
falco_find_peppol_participant | Look up the Peppol participant identifier registered for a VAT number, to see whether a company can receive e-invoices over Peppol |
falco_check_peppol_participant | Check whether a Peppol participant identifier (e.g. 0208:0123456789) is registered to receive invoices or credit notes |
falco_list_customers | List customers of the Falco invoicing module: id, name, VAT and company number, language, e-mails, phone, contact, address and Peppol… |
falco_get_customer | Get one customer of the invoicing module by id with full address, contacts and Peppol identifier |
falco_list_articles | List articles (products and services) of the invoicing module: id, descriptions, unit price excluding and including VAT, unit, category… |
falco_list_invoices | List sales invoices and credit notes created in the Falco invoicing module: id, number, type, status (draft, sent, locked), document and… |
falco_get_invoice | Get one invoice or credit note of the invoicing module with its lines (article, quantity, unit price, VAT rate, amounts), VAT subtotals… |
falco_download_invoice_pdf | Download the PDF of an invoice or credit note of the invoicing module |
falco_set_purchase_payment_status | Set the payment status of a purchase document to not_paid, partially_paid or paid, e.g. after paying a supplier |
falco_send_invoice_response | Send a Peppol invoice response for a received document to its sender: acknowledged, in_process, under_query, conditionally_accepted… |
Esempi di prompt
- "Quali fatture dei fornitori ricevute via Peppol questo mese sono ancora da pagare, e quando scadono?"
- "Mostrami i documenti di acquisto degli ultimi 30 giorni con fornitore, importo e stato di pagamento."
- "L'azienda con partita IVA BE0123456789 può ricevere fatture elettroniche via Peppol?"
- "Elenca le fatture del modulo di fatturazione inviate ma non ancora pagate, con gli importi IVA inclusa."
- "Scarica il PDF della fattura 2026-0142 dal modulo di fatturazione."
Prossimi passi
Questa guida ti è stata utile?