Setting up Google Gemini

← スタートガイドに戻る

This guide explains how to use Google Gemini with Atlassian Rovo MCP by adding the Atlassian Rovo MCP server to the Gemini CLI. Once connected, Gemini can use tools exposed by the Rovo MCP server to summarize content, answer questions about project work, and generate insights from your Atlassian data sources.

はじめる前に

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

Gemini CLI installed (version 1.0 or later)
Node.js 20 or later
An Atlassian Cloud site with Jira, Compass, and/or Confluence
認証フローを完了するための最新のブラウザー

Step 1: Install or update Gemini CLI

Install Gemini CLI globally:
npm install -g @google/gemini-cli
Verify installation:
gemini --version

Step 2: Add the Atlassian Rovo MCP server to Gemini (recommended)

The easiest way to connect Gemini to your Atlassian Rovo MCP server is by running a single command:

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

This command automatically installs and configures the Atlassian Rovo MCP server in your Gemini CLI environment. After installation, skip to Step 4 to verify your setup.

Step 3: Add the Atlassian Rovo MCP server manually (optional)

If you prefer to configure it manually, follow these steps.

Locate your Gemini settings file

Gemini CLI reads the MCP server configuration from a settings file:

Global configuration: ~/.gemini/settings.json
Project configuration (optional): <your project>/.gemini/settings.json

If the file does not exist, create it.

Add the Rovo MCP server configuration

Add an entry to the mcpServers block in your settings file:

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

メモ:

The server is Atlassian-hosted and uses Server-Sent Events (SSE) at https://mcp.atlassian.com/v1/sse.
Authentication happens during the OAuth flow after you select Atlassian tools in Gemini. You typically don't need to add static tokens or headers in the config.

Step 4: Start Gemini CLI and verify the server

Launch Gemini CLI:
gemini
In the prompt, list configured MCP servers:
/mcp list
You should see atlassian-rovo-mcp in the list. To inspect tools exposed by the server:
/mcp tools atlassian-rovo-mcp

Step 5: Use Gemini with Atlassian Rovo MCP tools

From the Gemini CLI prompt, you can now call tools provided by the Rovo MCP server. For example:

Summarize a Confluence page:
Summarize the Confluence page at <URL> in three bullet points.
List open Jira issues for a project:
List open Jira issues for PROJ tagged performance.

トラブルシューティング

Issue	考えられる原因	修正
Server does not appear in `/mcp list`	Invalid settings file path or JSON syntax	Confirm the file is at `~/.gemini/settings.json` and validate JSON.
401 Unauthorized	OAuth not completed	Trigger sign-in by using a tool, then complete the OAuth flow in your browser.
Cannot connect to the server	Wrong URL or firewall blocking SSE	Verify the endpoint `https://mcp.atlassian.com/v1/sse` and allow outbound SSE.

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

Disable pop-up blockers during OAuth.
If a tool does not return data, verify your access to Jira, Compass, or Confluence.
Start a new Gemini session if responses seem stuck.

Removing the server

To remove the Atlassian Rovo MCP server entry, delete atlassian-rovo-mcp from the mcpServers block in your settings file and restart Gemini CLI.

Need help? Contact Atlassian Support or return to the getting started guide.

この内容はお役に立ちましたか?

正確ではなかった明確ではなかった関係なかった

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

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

コミュニティに質問