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

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

Xentral + Gemini

Xentral ERP を AI につなぎます。倉庫と保管場所ごとの商品と在庫、顧客と仕入先、受注、追跡情報つきの納品書、支払状況つきの請求書、クレジットノート、発注、仕入先請求書を検索し、受注の下書きを作成できます。最新の Xentral API と Personal Access Token を使います。

前提条件

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

XENTRAL_URL, XENTRAL_TOKEN

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

1. Xentral で左下の Administration をクリックし、Account settings (Kontoeinstellungen) → Developer settings (Developer Einstellungen) → Personal Access Tokens の順に進みます。Smart Search に「Personal Access Token」と入力すると早く開けます。この作業には管理者アカウントが必要です。
2. Create token（Token erzeugen）をクリックし、AnythingMCP-Read などの名前、説明、有効期間（既定は 180 日）を設定します。
3. AI に見せる領域に Read を付与します。商品と在庫、顧客（CRM）、販売伝票（受注、納品書、請求書、クレジットノート）、購買（発注、仕入先、買掛金）、支払方法やプロジェクトなどの設定です。AI に受注の下書きを作らせる場合だけ、受注に Create と Delete を追加します。Admin スコープは付けないでください。
4. Create をクリックし、すぐにトークンをコピーします。Xentral が表示するのは一度だけです。
5. XENTRAL_URL に Xentral を開くときのアドレスを設定します。例: https://acme.xentral.biz（独自ドメインでも可）。/api、パス、末尾のスラッシュは付けません。トークンは Bearer という語を付けずにそのまま XENTRAL_TOKEN に貼り付け、コネクターをインストールします。
6. まず xentral_list_products を実行します。商品が返ってくれば、URL とトークンは正しく設定されています。

トークンの有効期間と権限: トークンは選んだ日付で失効し、180 日間使われなかったトークンは Xentral が削除します。権限は後から変更できません。変更するには新しいトークンを作成し、XENTRAL_TOKEN を置き換えてください。AI に見えるのは、トークンが読み取れる領域だけです。

印刷された番号ではなく ID: どのツールも、紙に印刷された商品番号、伝票番号、顧客番号ではなく、Xentral の内部 ID を使います。AI はまず一覧系のツールで、number、documentNumber、customerNumber のフィルターか search を使って ID を探します。顧客の ID は住所 ID でもあり、伝票では address.id として表示され、xentral_create_sales_order では addressId として渡します。顧客のフィルターは完全一致のみです。名前の一部で顧客を探すときは、AI が xentral_list_invoices または xentral_list_sales_orders でその顧客の伝票を検索し、そこから address.id を取得します。

フィルター: 一覧系のツールは、すべて満たす必要がある条件を受け付けます。各条件は項目（key）、演算子（op）、値（value）で構成されます。たとえば未払いの請求書は [{"key": "paymentStatus", "op": "in", "value": ["pending", "partiallyPaid"]}] です。演算子には equals, in, contains, startsWith, greaterThanOrEquals、lessThan などがあり、各ツールが受け付ける項目を示しています。伝票の日付は YYYY-MM-DD 形式です。

伝票の検索と並べ替え: 受注、納品書、請求書、クレジットノート、発注では、search が伝票番号、顧客または仕入先の名前と番号、メールアドレス、郵便番号、外部注文番号を検索します。sort には項目名を指定し、先頭にマイナスを付けると降順になります（-documentDate）。include は lineItems（明細）や address などの関連データを埋め込みます。

ステータス: 受注は draft、released、completed、cancelled のいずれかです。請求書、納品書、発注には sent もあります。請求書とクレジットノートの支払状況（paymentStatus）は pending, paid, partiallyPaid, cancelled, partiallyCancelled, badDebt、debited のいずれかです。

在庫: xentral_get_product_stock は合計値と、倉庫ごと・販売チャネルごとの同じ数値を返します。sellable はまだ顧客に約束できる数量、physical は棚にある数量、reserved は未完了の受注が押さえている数量です。倉庫（Lager）には保管場所（Lagerplätze）があります。xentral_list_product_storage_locations は商品がどこにあるかを、xentral_list_storage_location_items は 1 つの保管場所に何があるかを示します。

出荷と支払い: xentral_list_delivery_note_shipments は納品書の配送業者、追跡番号、追跡リンクを返します。xentral_get_invoice_balance は請求書に計上された入金と、残りの未払い額を示します。

ページ: 伝票の一覧は page と perPage（最大 1000、既定 25）、それ以外の一覧は page と pageSize（10 から 50）を受け付けます。

書き込み: xentral_create_sales_order が作成するのは既存顧客向けの下書きだけです。受注番号は付かず、誰かが Xentral で確認してリリースするまで、引当も出荷も行われません。AI が価格を指定しない場合、Xentral は顧客と商品の価格を使います。xentral_delete_sales_order_draft はこうした下書きを削除するツールで、インストール時はオフです。リリース済み、完了、キャンセル済みの受注は Xentral が削除を拒否します。それ以外のツールはすべて読み取り専用です。

読み取り専用の設定: トークンには Read 権限だけを付与し、コネクターのページで xentral_create_sales_order をオフにします。

レート制限: Xentral はプランにかかわらず、インスタンスごとに 1 分あたり約 100 リクエストまで受け付けます。超えると Retry-After ヘッダー付きの 429 を返します。個別の照会を何度も行うより、フィルターをかけた一覧を 1 回取得するほうが効率的です。

よくあるエラー: 401 は、トークンが間違っているか、失効したか、削除されたことを示します。403 は、その領域の権限がトークンにないことを示します。権限を付けた新しいトークンを作成してください。400「Generic request validation failed」または「filter must be an array」は、ツールが受け付けないフィルター項目や演算子、または形式の誤った値を示します。404「Route not found」は、XENTRAL_URL に /api/v1 などのパスが含まれているか、インスタンスがそのエンドポイントにまだ対応していないことを示します。受注の削除時の 409 は、その受注がもう下書きではないことを示します。

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

利用可能なツール

プロンプトの例

• 「商品 700123 は各倉庫であと何個販売できますか？どの保管場所にあるかも教えてください。」
• 「未払いまたは一部入金の請求書はどれですか？顧客、金額、督促レベルを古い順に表示してください。」
• 「受注 200345 の荷物は今どこですか？配送業者と追跡リンクを教えてください。」
• 「顧客 10001 向けに、商品 700123 を 20 個、商品 700456 を 5 個、希望納期 10 月 20 日で受注の下書きを作成してください。」

FAQ

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

次のステップ

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