MCP 経由で Flour を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Flour をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Flour + Gemini

ドイツのクラウド POS・商品管理システム Flour（読み取り専用）：倉庫ごとの価格と在庫を含む商品、在庫移動、レシート、請求書などの伝票、期間別・レジ別の販売商品、取引先、レジジャーナル、棚卸、店舗、販売拠点（レジ）。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

FLOUR_API_TOKEN

ステップ 1 — 認証情報を取得

トークンが手元にあれば、設定は約 2 分で終わります。必要なのは Flour のアカウントと、Flour が申請に応じて発行する REST API v3 のトークンです。

1. アカウント所有者のメールアドレスから [email protected] に連絡し、あなたの Flour アカウント用の REST API v3 トークンを依頼します。
2. トークンだけを FLOUR_API_TOKEN に貼り付けます。Bearer という語、スペース、引用符は付けません。コネクターはこれを Authorization ヘッダーで送信します。
3. コネクターをインストールし、flour_list_stocks を実行します。在庫拠点（倉庫、売場、オンライン在庫）が ID 付きで一覧表示され、トークンが有効であることを確認できます。

読み取る内容：在庫拠点、店舗、販売拠点（レジ）。商品番号、EAN、メーカー、価格表ごとの販売価格、仕入価格、発注点、バリエーション、セット構成を含む商品。在庫拠点ごとの各商品の在庫（実在庫＝棚卸数と、未処理の受注を差し引いた計算在庫）と在庫移動（入荷、販売、修正、移動）。明細、税額内訳、支払状況を含む販売・仕入伝票（レシートと請求書、見積、受注、納品書、返金伝票、仕入請求書、発注書）。期間内に売れた商品の数量と税抜売上（レジ別も可）。顧客と仕入先。開店時・締め時の現金と出金を含むレジジャーナル。カウントした明細を含む棚卸。アカウントに保存された統計。

まずマスターデータ：絞り込みは ID で行います。AI はまず在庫拠点とレジを読み取り、そのうえで特定のレジのレシートや特定の倉庫の在庫を問い合わせます。売れ筋には返金伝票を差し引き済みの flour_get_sold_articles を、個々のレシートや請求書には flour_list_documents と flour_get_document を使います。flour_find_article は商品番号またはバーコードの EAN で商品を見つけます。

日時と金額：Flour の日時は UTC です。ドイツの 1 営業日は UTC では前日の夜（夏は 22:00、冬は 23:00）に始まり、AI が変換します。金額は伝票の通貨（通常はユーロ）で、totalExVat は税抜、totalIncVat は税込です。

忙しいレジは短い期間で：一覧はページ単位で返り、総件数はありません。1 年分のレシートは数万件になることがあり、400 KB を超える応答は途中で切られるため、AI は 1 日または 1 週間ずつ問い合わせます。

読み取り専用：17 個のツールはすべて読み取りのみです。Flour アカウントでは何も変わらないため、確認することはなく、インストール時にオフになっているツールもありません。

認証情報は Flour に残ります：Flour に保存されている決済端末の設定、TSE（税務用セキュリティモジュール）のデータ、銀行口座情報は応答から取り除かれ、AI には届きません。

制限：Flour はトークンごとに 1 分あたり約 60 リクエストまで受け付けます。429 が返ったら、AI は 1 分待ってから再試行します。

よくあるエラー：401 はトークンが間違っているか失効したことを示します。[email protected] に新しいトークンを依頼してください。429 は 1 分間に約 60 件を超えるリクエストがあったことを示します。応答が途中で切れている場合は期間が広すぎるので、狭めてください。

このコネクターは、売上の登録、商品・伝票・取引先の作成や変更、在庫の記帳、レジ締めは行いません。読み取るだけです。

ステップ 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" }
    }
  }
}

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 が Flour のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「先週、全レジでいちばん売れた商品を、数量順と税抜売上順で教えてください。」
• 「在庫が 5 個以下になっている商品はどれですか。それぞれ最後に入荷したのはいつですか。」
• 「横浜店のレジで昨日発行されたレシートを、税込合計付きで見せてください。」
• 「EAN 4006381333931 の商品を探して、価格と倉庫ごとの在庫を見せてください。」
• 「土曜日のレジ締めの時点でレジに現金はいくらありましたか。出金はありましたか。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続