メインコンテンツへスキップ

Gemini CLI を接続する

以下の手順では、Gemini CLI を使用して MCP サーバーに接続する方法を説明します。接続する前に、Required permissions を満たしていることを確認してください。

前提条件​

  • Gemini CLI がインストールされ、最新であること。

  • stdio を使用する場合、@doitintl/doit-mcp-server を実行できるように PATH 上に Node.js があり、npx が使用できること、そして DOIT_API_KEY として設定するための personal API token があること。

  • Streamable HTTP を使用する場合、接続時に DoiT のサインインフローを完了できる、サポート対象の Web ブラウザ。

サポートされている接続方法​

Gemini CLI は stdio と Streamable HTTP をサポートしています。認証の詳細については Connection methods を参照してください。以下の例では両方の方法を示します。

stdio で設定する​

  1. 次のいずれかの場所にある Gemini CLI の settings.json を作成または編集します。

    • すべてのセッション（ユーザー）: macOS と Linux の場合は ~/.gemini/settings.json、Windows の場合は %USERPROFILE%\.gemini\settings.json。

    • 1 つのプロジェクト: Gemini CLI を実行するプロジェクトのルートに .gemini/settings.json。.gemini ディレクトリが存在しない場合は作成してください。

    詳細は Gemini CLI configuration を参照してください。

  2. テキストエディタで settings.json ファイルを開きます。

  3. 次の JSON を追加またはマージします（ファイルに他のキーがすでにある場合は、それらを削除せずに mcpServers オブジェクトを追加してください）。your_doit_api_key を、personal API token に置き換えてください。

    {
      "mcpServers": {
        "doit_mcp_server": {
          "command": "npx",
          "args": ["-y", "@doitintl/doit-mcp-server@latest"],
          "env": {
            "DOIT_API_KEY": "your_doit_api_key"
          }
        }
      }
    }

  4. settings.json ファイルを保存して閉じます。

  5. Gemini CLI を起動します。ローカルの stdio では DOIT_API_KEY で認証を行い、ブラウザのサインインフローは開きません。

  6. Gemini CLI は MCP サーバーを自動的に検出して接続します。クライアントが利用可能な MCP ツールの一覧を表示する場合、セッションで利用する前に DoiT サーバーが表示されていることを確認してください。

    これで、新しいチャットを開き、Cloud Intelligence データに関する質問やリクエストを開始できます。

Streamable HTTP で設定する​

  1. stdio で設定する で説明したのと同じ settings.json ファイルを作成または編集します。

  2. HTTP URL エントリを使用します（Gemini CLI は Streamable HTTP 用に httpUrl を使用します）。

    {
      "mcpServers": {
        "doit_mcp_server": {
          "httpUrl": "https://mcp.doit.com/mcp"
        }
      }
    }

  3. ファイルを保存し、Gemini CLI を起動し、プロンプトに従って DoiT のサインインと同意フローを完了し、その後 MCP ツール一覧に DoiT サーバーが表示されていることを確認します。

に最終更新