跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Falco，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
Falco，比利时会计与 Peppol 电子发票软件：采购和销售单据及其文件、通过 Peppol 收到的发票、Peppol 参与方查询，以及 Falco 开票模块的客户、商品和发票。基本只读；设置采购单据付款状态和发送 Peppol 发票回复在安装时处于关闭状态。
试试这样问
Falco 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Falco、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Falco
Falco，比利时会计与 Peppol 电子发票软件：采购和销售单据及其文件、通过 Peppol 收到的发票、Peppol 参与方查询，以及 Falco 开票模块的客户、商品和发票。基本只读；设置采购单据付款状态和发送 Peppol 发票回复在安装时处于关闭状态。
设置
该连接器需要两个密钥，二者缺一不可：集成方的应用密钥（Application Secret）和 Falco 客户的 API 密钥。
- 集成方在 Falco 开发者门户（dev.falco-app.be）创建一个应用，申请所需的权限范围，例如
documents:purchases:read、documents:sales:read、peppol:inbound:read、peppol:participants:read、customers:read、articles:read和invoices:read，并将其设为 Public。它的生产环境 Application Secret（as_live_...）填入FALCO_APP_SECRET。 - Falco 客户（使用 Expert Essential 或 Expert Premium 套餐的组织管理员）在 Falco 桌面应用中点开自己姓名缩写下的 API access，按 ID（
app_...）选择该应用，并为自己的组织生成一个 API key（sk_live_...）。它填入FALCO_API_KEY。 - 安装连接器并运行
falco_get_organization检查两个密钥。连接器调用的是生产环境 APIhttps://api.falco-app.be/v1；沙箱密钥（as_test_、sk_test_）只能在沙箱主机上使用，这里会被拒绝。
可读取的内容：密钥所属的组织（名称、增值税号、Peppol 标识、地址、IBAN、套餐）；采购单据（供应商发票和贷记单），含付款状态和 Peppol 状态、事件历史和附件；销售单据，包括以 PDF 或 UBL 导入的单据；通过 Peppol 收到的单据，含发送方、金额、到期日、付款参考号和银行账户；以及 Falco 开票模块的客户、商品和发票，含发票明细行、增值税小计和 Peppol 状态。它还可以下载文件：采购单据的主文件、UBL XML 或附件，通过 Peppol 收到的单据的 UBL，以及开票模块中发票的 PDF。
AI 如何使用它：处理供应商发票时，它先用 falco_list_peppol_inbound（通过 Peppol 收到的内容）和 falco_list_purchase_documents（全部采购单据及其文件）；处理销售时用 falco_list_sale_documents，开票模块中创建的单据则用 falco_list_invoices。要判断一家公司能否接收电子发票，它用增值税号调用 falco_find_peppol_participant，或用 0208:0123456789 这样的参与方 ID 调用 falco_check_peppol_participant。
安装时关闭：falco_set_purchase_payment_status 和 falco_send_invoice_response。前者把采购单据的付款状态替换为 not_paid、partially_paid 或 paid，例如在付款给供应商之后。后者通过 Peppol 向已收单据的发送方发送发票回复（acknowledged、in_process、under_query、conditionally_accepted、rejected、accepted 或 paid）；供应商会立即收到，且无法撤回。由管理员有意开启。即便开启后，AI 也会先向你展示单据以及新的状态或回复，等你确认。
日期和金额：筛选条件使用 YYYY-MM-DD。金额是单据币种（通常为 EUR）的字符串。列表通过 page（从 0 开始）和 page_size（20 到 200，发票最多 100）分页，只要返回的页是满的，AI 就会继续请求下一页。
限制：每个应用密钥每分钟 60 次请求。超过后 Falco 返回 429，AI 会等待后重试。
常见错误：错误遵循 RFC 9457，含 title、detail 和 code。401 表示应用密钥或 API 密钥错误，或在生产环境中使用了沙箱密钥。403 表示该密钥缺少这一领域的权限范围；权限范围由客户在生成密钥时授予。查询参与方时返回 404 表示该公司无法通过 Peppol 接收。
前提条件: FALCO_APP_SECRET, FALCO_API_KEY
本地安装连接器
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
打开 http://localhost:3000/connectors/store，选择 Falco 并填入前提条件中列出的环境变量。
可用工具
| 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… |
示例提示
- “本月通过 Peppol 收到的供应商发票中，哪些还没付款？分别什么时候到期？”
- “列出最近 30 天的采购单据，带上供应商、金额和付款状态。”
- “增值税号为 BE0123456789 的公司能通过 Peppol 接收电子发票吗？”
- “列出开票模块中已发送但尚未付款的发票，以及它们的含税金额。”
- “从开票模块下载发票 2026-0142 的 PDF。”
下一步
这份指南对你有帮助吗?