Minds を Gemini CLI に接続する：拡張機能と MCP の設定

Minds は商用の合成リサーチのためのエンドツーエンドのプラットフォームです。Gemini CLI を使うと、ターミナルから Audience を探し、Study を計画し、提案されたリサーチプランを確認して、結果を読むことができます。Gemini CLI は https://getminds.ai/mcp にある Minds の MCP サーバーと通信し、あなたは OAuth で Minds アカウントにサインインします。

前提条件

• Gemini CLI がインストール済みで、Gemini API キー、Vertex AI、または Gemini Code Assist Standard / Enterprise ライセンスでサインインしていること。2026 年 6 月以降、Gemini CLI は個人の Google アカウントに対応しておらず、Google は個人ユーザーに Antigravity CLI を案内しています。Google Antigravity で Minds を使う を参照してください。
• Minds アカウント。お持ちでない場合は、最初の接続時に登録できます。
• OAuth サインイン用に同じコンピューター上のブラウザー、またはブラウザーのない環境向けの Minds API キー。

どの方法を選ぶ？

1 つの環境では 1 つの方法だけを使ってください。拡張機能と手動のエントリはどちらも minds という名前のサーバーを登録するため、どちらか一方だけを残します。

方法 A：Minds 拡張機能をインストールする

1. インストール

gemini extensions install https://github.com/minds-ai-co/minds-mcp

Gemini CLI に、拡張機能が追加する内容が表示されます。https://getminds.ai/mcp のリモート MCP サーバー minds と、コンテキストファイル GEMINI.md です。このファイルは、実行を始める前にリサーチの問いを明確にし、スタディプランの確認を取るようエージェントに指示します。Y で確定します。現在のフォルダーがまだ信頼されていない場合は、先に信頼するよう求められます。

2. インストールを確認する

gemini extensions list

minds-mcp が MCP サーバー minds とともに表示されます。サインインするまでは、gemini mcp list でサーバーが未接続と表示されます。

3. Minds にサインインする

gemini を起動します。初回接続時に Gemini CLI がブラウザーで Minds のサインインページを開くので、サインインして Allow を選びます。自分でサインインを始める場合や、後で再度サインインする場合は、セッション内で /mcp auth minds を実行します。その後 /mcp list で Minds が接続済みとなり、ツールが表示されます。

4. 最新の状態に保つ

gemini extensions update minds-mcp

方法 B：Minds を MCP サーバーとして追加する

どのフォルダーでも使えるように、ユーザー単位でサーバーを追加します。

gemini mcp add --scope user --transport http minds https://getminds.ai/mcp

--scope user を付けない場合、Gemini CLI は現在のプロジェクトの .gemini/settings.json にエントリを書き込みます。~/.gemini/settings.json を直接編集することもできます。ストリーミング HTTP には httpUrl を使います。url は旧来の SSE トランスポートを選択します。

{
  "mcpServers": {
    "minds": { "httpUrl": "https://getminds.ai/mcp" }
  }
}

gemini を起動し、方法 A の手順 3 と同じようにサインインします。

OAuth と API キーのどちらを使う？

• OAuth（推奨）：Minds アカウントでサインインします。Gemini CLI が Minds に自動で登録されるため、クライアント ID やシークレットは不要で、各自が自分のアカウントを接続します。
• API キー：CI ジョブや共有サービスアカウントなど、ブラウザーのない環境向けです。Settings → API Keys でキーを作成し、ヘッダーとして追加します。

gemini mcp add --scope user --transport http --header "Authorization: Bearer minds_YOUR_API_KEY" minds https://getminds.ai/mcp

キーは settings.json に平文で保存されます。このファイルはバージョン管理に含めず、個人のコンピューターでは OAuth を優先してください。

方法 C：Google Antigravity

Antigravity には独自の設定があります。リモートサーバーは ~/.gemini/config/mcp_config.json または .agents/mcp_config.json に serverUrl で定義し、サインインは Settings → Customizations → Authenticate から行います。Antigravity ガイド で 3 つの Antigravity 環境すべてを説明しています。

Gemini CLI から Antigravity CLI に移行しますか？agy plugin import gemini を実行すると、インストール済みの Minds 拡張機能が同じサーバーを使う Antigravity プラグインに変換されます。

Gemini アプリと Gemini Enterprise

Google は Gemini アプリ（米国の個人アカウント）と Gemini Enterprise でもカスタム MCP 接続を案内しています。現時点では、Minds をこれらに接続することはできません。Minds がこれらのコネクタに対応するまでは、Gemini CLI または Google Antigravity を使ってください。

Gemini CLI での Minds の動作

• まず計画： 何かを実行する前に、エージェントがリサーチプランを提示して承認を求めます。Study はあなたが確認してから始まります。
• 長い実行はサーバー側で続く： Study は Minds 上で継続的に実行されるため、ターミナルを閉じても止まりません。状況は後で Gemini CLI に確認できます。
• Minds でさらに詳しく： 結果は Minds 上の Study にリンクしており、個々の回答の確認、Audience の比較、結果のエクスポートができます。

Gemini CLI が使えるツールは ツールリファレンス に一覧があります。連携の全体像は MCP の概要 で説明しています。

トラブルシューティング

Minds が未接続と表示される。 Gemini CLI のセッションで /mcp auth minds を実行し、ブラウザーでサインインを完了してください。

サインインページが開かない。 Gemini CLI はローカルポートで OAuth のコールバックを受け取るため、ブラウザーは同じコンピューター上で動いている必要があります。SSH 経由やコンテナー内では API キーを使ってください。

Minds サーバーが 2 つある、またはツールが重複している。 拡張機能と手動のエントリが両方とも有効になっています。gemini extensions uninstall minds-mcp または gemini mcp remove minds でどちらかを削除してください。

Minds で開ける Study や Audience に「Not authorized」と表示される。 Gemini CLI が、Study の所有者とは別の Minds アカウントに接続されています。正しいアカウントで /mcp auth minds を再実行するか、接続中のアカウントと Study を共有してください。

新しい Minds のツールが表示されない。 ツール一覧を読み込み直すために Gemini CLI を再起動し、拡張機能を使っている場合は gemini extensions update minds-mcp を実行してください。

ChatGPT、Claude、Codex などの他のクライアントは 連携の概要 に掲載しています。

MCP サーバー URL

https://getminds.ai/mcp

MCP ドキュメント全体を見る