インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Falco をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
ベルギーの会計・Peppol 電子請求ソフト Falco：ファイル付きの仕入・販売伝票、Peppol で受信した請求書、Peppol 参加者の照会、Falco 請求書モジュールの顧客・品目・請求書。ほぼ読み取り専用で、仕入伝票の支払状況の設定と Peppol 請求書応答の送信はインストール時にオフです。
こう聞いてみよう
Falco のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Falco をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Falco + Gemini
ベルギーの会計・Peppol 電子請求ソフト Falco：ファイル付きの仕入・販売伝票、Peppol で受信した請求書、Peppol 参加者の照会、Falco 請求書モジュールの顧客・品目・請求書。ほぼ読み取り専用で、仕入伝票の支払状況の設定と Peppol 請求書応答の送信はインストール時にオフです。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
FALCO_APP_SECRET, FALCO_API_KEY
ステップ 1 — 認証情報を取得
このコネクターには 2 つのキーが必要で、どちらも必須です。インテグレーターのアプリケーションシークレットと、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_）はサンドボックスのホストでしか使えず、ここでは拒否されます。
読み取る内容：キーの組織（名称、VAT 番号、Peppol 識別子、住所、IBAN、プラン）。支払状況と Peppol ステータス、イベント履歴、添付ファイルを含む仕入伝票（仕入先の請求書とクレジットノート）。PDF や UBL として取り込んだものを含む販売伝票。送信者、金額、支払期日、支払参照番号、銀行口座を含む Peppol 受信書類。明細、VAT 小計、Peppol ステータスを含む Falco 請求書モジュールの顧客、品目、請求書。ファイルのダウンロードにも対応します：仕入伝票のメインファイル、UBL XML、添付ファイル、Peppol 受信書類の UBL、請求書モジュールの請求書 PDF。
AI の使い方：仕入先の請求書は falco_list_peppol_inbound（Peppol で届いたもの）と falco_list_purchase_documents（ファイル付きのすべての仕入伝票）から始めます。販売は falco_list_sale_documents、請求書モジュールで作成した書類なら falco_list_invoices を使います。ある会社が電子請求書を受け取れるかどうかは、VAT 番号で 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 — アダプターをインストール
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" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、
geminiを再起動します。 - Gemini CLI で
/mcpを実行します（またはシェルでgemini mcp list）。anythingmcpが接続済みとして表示されるはずです。 - プロンプトを入力しましょう。Gemini CLI が
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 日間の仕入伝票を、仕入先、金額、支払状況とともに表示してください。」
- 「VAT 番号 BE0123456789 の会社は Peppol で電子請求書を受け取れますか。」
- 「請求書モジュールで送付済みだがまだ支払われていない請求書を、税込金額とともに一覧にしてください。」
- 「請求書モジュールの請求書 2026-0142 の PDF をダウンロードしてください。」
FAQ
Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。
次のステップ
このガイドは役に立ちましたか?