如何通过 MCP 将 Falco 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Falco、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Falco + Gemini

Falco，比利时会计与 Peppol 电子发票软件：采购和销售单据及其文件、通过 Peppol 收到的发票、Peppol 参与方查询，以及 Falco 开票模块的客户、商品和发票。基本只读；设置采购单据付款状态和发送 Peppol 发票回复在安装时处于关闭状态。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

FALCO_APP_SECRET, FALCO_API_KEY

步骤 1 — 获取凭证

该连接器需要两个密钥，二者缺一不可：集成方的应用密钥（Application Secret）和 Falco 客户的 API 密钥。

1. 集成方在 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。
2. Falco 客户（使用 Expert Essential 或 Expert Premium 套餐的组织管理员）在 Falco 桌面应用中点开自己姓名缩写下的 API access，按 ID（app_...）选择该应用，并为自己的组织生成一个 API key（sk_live_...）。它填入 FALCO_API_KEY。
3. 安装连接器并运行 falco_get_organization 检查两个密钥。连接器调用的是生产环境 API https://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 接收。

步骤 2 — 安装 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

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Falco 的工具。

可用工具

示例提示

• “本月通过 Peppol 收到的供应商发票中，哪些还没付款？分别什么时候到期？”
• “列出最近 30 天的采购单据，带上供应商、金额和付款状态。”
• “增值税号为 BE0123456789 的公司能通过 Peppol 接收电子发票吗？”
• “列出开票模块中已发送但尚未付款的发票，以及它们的含税金额。”
• “从开票模块下载发票 2026-0142 的 PDF。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Meta Muse
• 连接到 Microsoft Copilot