Gemini CLIの新バージョンは、既存の拡張機能検証コマンドにおけるMCPサーバー設定の検査とテストを強化した。拡張機能の開発者は、自分のコンピューターで設定エラーを見つけられる。公開した拡張機能がギャラリーに表示されないときに、検索インデックス、つまりファイル検索用に情報を整理する処理の状態を確認する方法も案内される。
1. 公開前のローカル検証を追加
2026年11月10日に公開されたv0.68.0リリースは、拡張機能検証コマンドと評価テストの追加を変更点として紹介した。関連するコード変更は10月28日にマージされた。今回追加された検査と単体テスト、つまり機能を小さな単位で確認する検証は、外部ツールを接続するMCPサーバー設定に集中している。
検証対象のgemini-extension.jsonは、拡張機能の名前・バージョン・接続情報を格納する設定ファイルであるマニフェストだ。プルリクエスト、つまりコード変更のレビューを依頼する申請の説明では、併せて読み込むファイルのパスの安全性と存在の有無、バージョン番号が所定の形式に従っているかも検査範囲として挙げている。
2. MCPサーバー設定で確認する項目
検証器は、サーバー設定の集合であるmcpServersと各サーバーの設定が、項目名と値から成るオブジェクト形式かを調べる。サーバーを起動するコマンドや接続先アドレスなど、接続情報が少なくとも一つ必要となる。ネットワークで接続を確立する通信規約であるTCPの接続値には、文字列と数値を許容する。
従来のアドレス属性であるhttpUrlを使うと、エラーではなく警告が出る。案内では、urlにアドレスを入れ、接続タイプも指定する方式への変更を勧めている。
アドレスはURL形式として解釈できるかを確認する。実行環境によって値が変わる設定値である環境変数でアドレスを埋める設定を、誤ってエラー扱いしないよう、ドル記号を含む値はこの検査をスキップする。
3. 実行とテストの範囲
プルリクエストの説明に記載されたコマンドは次のとおりだ。検査する拡張機能フォルダーのパスを引数として渡して実行する。
gemini extensions validate <path>追加されたテストは、ローカルで実行するサーバーとリモートアドレスを使うサーバーが検証を通過するかを確認する。廃止予定の属性を使うケースも警告付きで成功するかを検査し、設定変更を勧める警告と実行を妨げるエラーを区別している。
接続情報の欠落、不正なアドレス、オブジェクトではないmcpServersの値は失敗ケースとして扱う。このときテストは、エラーメッセージとともに、プログラムの終了状態を数値で表す終了コード1を確認する。開発者にとっては、どの入力を拒否し、どの入力には警告だけを出すかを示す具体例となる。
事前検証の利点は、設定の問題をインストールや公開の前に修正できる点だ。この検証を活用すると、公開前にコマンドを実行してエラーを修正する作業が加わり、問題を見つけて直す負担を開発段階に前倒しすることになる。ただし、提供されたコードのアドレス検査は許可する通信方式まで制限しないため、接続先アドレスの安全性は別途確認する必要がある。
4. ギャラリーのインデックス問題の確認方法
同じ変更には、拡張機能ギャラリーのインデックス問題を扱う文書も追加された。文書によると、ギャラリーはタグ付きの公開リポジトリを毎日調べ、GitHubコード検索でマニフェストファイルを探す。要件を満たしても24~48時間後にギャラリーに表示されない場合、GitHubがまだファイルをインデックスに登録していない可能性がある。
GitHub CLIでリポジトリ内のマニフェストの検索結果数を確認する例は次のとおりだ。
gh api 'search/code?q=repo:<owner>/<repo>+filename:gemini-extension.json' --jq .total_countコマンドのリポジトリのプレースホルダーには、所有者とリポジトリ名を入れる。検索結果が0の場合やGitHub CLIを使わない場合は、GitHubにログインしたブラウザーで該当リポジトリのコード検索を開き、インデックス登録を促すよう案内している。
GitHubがインデックス登録中と表示したら、15~30分待ち、ファイルが検索されるまで再確認する。登録が完了したら、ギャラリーの収集プログラムの次の実行周期を待つ手順となる。開発者はこの検索結果を通じて、設定検査とは別に、ファイルが発見される準備が整ったかを確認できる。
v0.68.0の要点は、拡張機能の開発者が公開前の設定エラーと公開後の検索での表示問題をそれぞれ点検できるよう、検査と案内を具体化した点にある。