Google Gemini をセットアップする

← スタート ガイドに戻る

 

このガイドでは、Gemini CLI に Atlassian Rovo MCP Server を追加して、Google Gemini と Atlassian Rovo MCP を連携する方法について説明します。接続を確立すると、Rovo MCP Server で公開されているツールを Gemini で使用して、コンテンツを要約したり、プロジェクト作業に関する質問に答えたり、アトラシアン データソースからインサイトを生成したりすることができます。

 

はじめる前に

以下を実行していることを確認します。

  • Gemini CLI がインストールされていること (バージョン 1.0 以降)

  • Node.js 20 以降

  • Jira、Compass、Confluence を使用した Atlassian Cloud サイト

  • 認証フローを完了するための最新のブラウザー

 

ステップ 1: Gemini CLI をインストールまたはアップデートする

  1. Gemini CLI をグローバルにインストールします。

    npm install -g @google/gemini-cli
  2. インストールを確認します。

    gemini --version

 

Gemini を Atlassian Rovo MCP Server に接続する最も簡単な方法は、次の 1 つのコマンドを実行することです。

gemini extensions install https://github.com/atlassian/atlassian-mcp-server

このコマンドを実行すると、Atlassian Rovo MCP Server が Gemini CLI 環境に自動的にインストールされて構成されます。インストール後、ステップ 4 に進んでセットアップを確認します。

 

ステップ 3: Atlassian Rovo MCP Server を手動で追加する (オプション)

手動で構成する場合は、次の手順に従います。

Gemini 設定ファイルを探す

Gemini CLI では、設定ファイルから MCP サーバー構成を読み取ります。

  • グローバル構成: ~/.gemini/settings.json

  • プロジェクト構成 (オプション): <your project>/.gemini/settings.json

このファイルが存在しない場合は作成します。

Rovo MCP Server 構成を追加する

設定ファイルの mcpServers ブロックにエントリを追加します。

{ "mcpServers": { "atlassian-rovo-mcp": { "transport": { "type": "sse", "url": "https://mcp.atlassian.com/v1/sse" } } } }

 

メモ:

  • サーバーはアトラシアンがホストしているものであり、https://mcp.atlassian.com/v1/sse の Server-Sent Events (SSE) が使用されます。

  • Gemini でアトラシアン ツールを選択した後、OAuth フローの過程で認証が行われます。通常、構成に静的トークンやヘッダーを追加する必要はありません。

 

ステップ 4: Gemini CLI を起動してサーバーを確認する

  1. Gemini CLI を起動します。

    gemini
  2. プロンプトに、構成済みの MCP サーバーをリストします。

    /mcp list
  3. リストに atlassian-rovo-mcp が表示されるはずです。サーバーによって公開されているツールを検査するには、次の手順に従います。

    /mcp tools atlassian-rovo-mcp

 

ステップ 5: Atlassian Rovo MCP ツールで Gemini を使用する

Gemini CLI プロンプトから、Rovo MCP Server が提供するツールを呼び出すことが可能になります。次に例を示します。

  • Confluence ページを要約します。

    Summarize the Confluence page at <URL> in three bullet points.
  • プロジェクトの未解決の Jira 課題をリストします。

    List open Jira issues for PROJ tagged performance.

トラブルシューティング

Issue

考えられる原因

修正

/mcp list にサーバーが表示されない

設定ファイルのパスまたは JSON 構文が無効である

ファイルが ~/.gemini/settings.json にあることを確認し、JSON を検証します。

401 Unauthorized になる

OAuth が完了してない

ツールを使用してサインインをトリガーし、ブラウザで OAuth フローを完了します。

サーバーに接続できない

URL が間違っているか、ファイアウォールが SSE をブロックしている

エンドポイント https://mcp.atlassian.com/v1/sse を確認し、アウトバウンド SSE を許可します。

接続を成功させるためのヒント

  • OAuth 中はポップアップ ブロッカーを無効にします。

  • ツールからデータが返されない場合、Jira、Compass、または Confluence へのアクセスを確認します。

  • 応答が行き詰まっていると考えられる場合は、新しい Gemini セッションを開始します。

 

サーバーを削除する

Atlassian Rovo MCP Server エントリを削除するには、設定ファイルの mcpServers ブロックから atlassian-rovo-mcp を削除し、Gemini CLI を再起動します。

 


不明な点がある場合は、アトラシアン サポートに連絡するか、スタート ガイドをもう一度確認してください。

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。