MCP 経由で Base (Baselinker) を Gemini に接続する方法

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

Base (Baselinker) + Gemini

AI に Base (Baselinker) で作業させます。ショップやマーケットプレイスをまたいだ注文の検索、ステータスと出荷の確認、注文のステータス変更、倉庫ごとの商品、価格、在庫の確認ができます。1 つのアカウントを、その API トークンで扱います。

前提条件

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

BASELINKER_TOKEN

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

1. Base（旧 Baselinker）で Account & other → My account → API を開きます。
2. トークンを生成するか既存のトークンをコピーし、BASELINKER_TOKEN に貼り付けます。新しいトークンを生成すると古いトークンは無効になり、古いトークンを使っているものはすべて動かなくなります。
3. baselinker_get_journal_list で注文の変更を AI に確認させたい場合は、同じ API 設定で注文ジャーナル（order journal）を有効にします。有効にしないとジャーナルは空のままです。
4. コネクターをインストールし、baselinker_get_order_status_list を実行します。トークンを確認し、アカウントの注文ステータスを一覧表示します。

1 つのトークンでアカウント全体: トークンはアカウント内のすべてを参照できます。あらゆる販売チャネルの注文（自社ショップ、接続したショップ、Allegro、Amazon、eBay などのマーケットプレイス）、すべての商品カタログ、すべての倉庫です。

読み取れるデータ: 購入者、配送、支払いの情報、ステータス、商品を含む注文、追跡番号と追跡ステータスを含む注文の出荷、過去 3 日間の注文イベント、SKU、EAN、価格グループごとの価格、倉庫ごとの在庫を含む商品、倉庫と配送業者です。

先に確認します: 初期状態で AI が行える変更は、baselinker_set_order_status で注文を別のステータスに移すことだけです。ステータス変更はアカウントで設定した自動処理（顧客へのメール、請求書、マーケットプレイスへの更新）を起動することがあるため、AI は注文と移動先のステータスを示し、あなたの承認を待ちます。読み取り専用にする場合は、このツールを無効にしてください。

インストール時に無効なツール: baselinker_add_order は注文を作成し、baselinker_update_inventory_products_stock は在庫を絶対数で上書きして接続したショップやマーケットプレイスに反映させ、baselinker_create_package は配送業者に出荷を予約して実際のラベルを発行します（配送業者から料金が請求される場合があります）。AI にこれらを任せる場合だけ有効にしてください。その場合、AI は 1 件ずつあなたに確認します。

制限: Base はアカウントごとに 1 分あたり 100 リクエストまで受け付け、超えるとそのアカウントの API が一定時間ブロックされます。そのため AI は全件をページ送りせず、ステータス、販売チャネル、日付で絞り込みます。1 回の呼び出しで返る注文は最大 100 件です。

よくあるエラー: ERROR_BAD_TOKEN: トークンが間違っているか、再生成されています。ERROR_USER_ACCOUNT_BLOCKED: アカウントまたはその API アクセスがブロックされています。多くはリクエスト上限を超えた後に起こるので、時間を置いてから再試行してください。ERROR_UNKNOWN_METHOD、ERROR_PARSE_JSON_PARAMETERS、または項目名を挙げたメッセージ: 入力が間違っています。在庫の更新は一部だけ成功することがあり、商品ごとの問題を警告として返します。

このコネクターは、請求書と領収書、返品、CRM の顧客、商品の作成や編集、価格の更新、書類、発注、ラベルのダウンロードは扱いません。

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

利用可能なツール

プロンプトの例

• 「過去 7 日間に確定した注文のうち、まだ出荷がないものをショップやマーケットプレイスごとにまとめて見せてください。」
• 「メインカタログの商品のうち、自社倉庫の在庫が 5 個未満のものはどれですか。」
• 「注文 48213907 の出荷の追跡ステータスを教えてください。」
• 「注文 48213907 を「発送済み」ステータスに移してください。ただし変更前に、注文と移動先のステータスを見せてください。」

FAQ

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

次のステップ

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