Gemini CLIを店舗に接続する

概要

Gemini CLIは、パソコンのターミナルで動作するGoogleのGeminiです。AIコネクタを使うと、質問に応じて店舗のデータ（売上、顧客、予約、財務）を確認できます。アクセス権限はAPIキーのユーザーに準じます。データの確認のみを行い、システムの内容を変更することはありません。

使う場面

• すでにターミナルでGeminiを使っていて、システムを開かずに店舗の状況を確認したい場合。
• Geminiに依頼する他の作業と、システムの数値を照らし合わせたい場合。

始める前に

AIコネクタを接続するの記事に沿ってコピーしたコネクタのアドレスと、「AIコネクタとしての使用を許可」したAPIキーを用意してください。パソコンにGemini CLIがインストールされている必要があります。システムへのログインも利用できます。キーのヘッダーを使わない場合は、Gemini CLIで/mcp auth heyaと入力し、表示された画面からログインしてください。

手順

ステップ1 — コネクタを追加する

ターミナルで次のコマンドを実行します。アドレスをアドレスをコピーでコピーしたものに、hk_...をAPIキーに置き換えてください。

gemini mcp add --transport http --header "Authorization: Bearer hk_..." heya https://seu-dominio/mcp

パソコン上のすべてのフォルダで使うには、-s userを追加します。設定ファイル（~/.gemini/settings.json）を編集する場合は、次のように記述してください。

{
  "mcpServers": {
    "heya": {
      "httpUrl": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

urlではなくhttpUrlを使ってください。Gemini CLIでは、urlは古い接続形式のため、コネクタは利用できません。

ステップ2 — 接続を確認する

Gemini CLIを開き、/mcpと入力します。コネクタheyaがCONNECTEDと表示され、listar_areas、buscar_ferramentas、executar_consultaの各ツールが表示されていることを確認してください。

ステップ3 — 質問する

たとえば、「今週、店舗で支払期限を迎える経費は？」と質問します。

その後の流れ

• Geminiが質問に適したクエリを探して実行し、システムの数値を回答します。
• API Keyタブにキーが表示され、最終使用が更新されます。
• アクセスを停止するには、API Keyタブでキーを無効にしてください。Geminiは30秒以内にアクセスできなくなります。

よくある間違いと質問

Q: ブラウザ版のGemini（gemini.google.com）でも使えますか？ A: まだ使えません。ブラウザ版のGeminiではAPIキーではなく、専用のログインが必要です。Gemini CLIをお使いください。

Q: /mcpを実行するとDISCONNECTEDと表示されます。どうすればよいですか？ A: urlではなくhttpUrlを使っているか、アドレスの末尾が/mcpになっているか、Bearer とその後のスペースを含めてキーをすべて貼り付けたかを確認してください。

Q: Geminiに「AIコネクタとしての使用を許可」が必要だと言われます。なぜですか？ A: このオプションを有効にせずにキーを作成した可能性があります。API Keyタブでキーを編集し、AIコネクタとしての使用を許可にチェックを入れてください。

Q: Gemini CLIがAntigravity CLIに変わりました。この手順は使えますか？ A: Googleは一部のアカウントでGemini CLIをAntigravity CLIに置き換えています。HTTPとヘッダーを使ってMCPサーバーを追加するオプションを探してください。アドレスとAuthorization: Bearer hk_...ヘッダーは同じです。

Q: プロジェクトのファイルにキーを保存してもよいですか？ A: おすすめしません。プロジェクトフォルダの.gemini/settings.jsonはバージョン管理に含まれることが多く、キーが公開されるおそれがあります。ユーザー用のファイル（~/.gemini/settings.json）をお使いください。

関連記事

• AIコネクタ
• APIキー
• Claude Codeを接続する
• Cursorを接続する