メインコンテンツまでスキップ

Google Gemini CLIへのBitrise MCPサーバーのインストール

前提条件Click to copy link​

  1. Google Gemini CLIのlatest versionがインストールされていること(Gemini CLIの公式ドキュメントを参照)
  2. Bitriseアカウント
  3. ローカルセットアップの場合: Go(1.25以上)がインストールされていること、およびBitriseのPAT

Bitrise MCPサーバーの設定Click to copy link​

Gemini CLI用のMCPサーバーは、mcpServersキーの下にある設定JSONで設定します。

  • グローバル設定: ~/.gemini/settings.json(~はホームディレクトリ)
  • プロジェクト固有: プロジェクトディレクトリ内の.gemini/settings.json

変更を反映するには、Gemini CLIの再起動が必要な場合があります。

最も簡単な方法は、Gemini拡張機能を使ってBitriseがホストするMCPサーバーを利用することです。

gemini extensions install https://github.com/bitrise-io/bitrise-mcp

この拡張機能は、初回利用時にOAuthフローを自動的に処理します。ブラウザでBitriseへのログインを求められます。

方法2: リモートサーバーClick to copy link​

ホストされているMCPサーバーに直接接続することもできます。

// ~/.gemini/settings.json
{
"mcpServers": {
"bitrise": {
"httpUrl": "https://mcp.bitrise.io"
}
}
}

初回のツール利用時に、Gemini CLIがブラウザを開いてBitrise OAuthへのサインインを行います。

フォールバック: PATベースの認証Click to copy link​

まだMCP OAuthをサポートしていないGemini CLIのビルドでは、BitriseのPATを作成し、ヘッダーとして渡してください。

// ~/.gemini/settings.json
{
"mcpServers": {
"bitrise": {
"httpUrl": "https://mcp.bitrise.io",
"headers": {
"Authorization": "Bearer $BITRISE_PAT"
}
}
}
}
<b>PATを安全に保存する</b>

セキュリティのため、トークンをハードコーディングしないでください。~/.gemini/.env(~はホームディレクトリまたはプロジェクトディレクトリ)を作成または更新し、PATを設定します。

# ~/.gemini/.env
BITRISE_PAT=your_token_here

方法3: ローカルサーバーのセットアップ(Goが必要)Click to copy link​

ローカルサーバーは、個人アクセストークンを使用してstdioで動作します。

// ~/.gemini/settings.json
{
"mcpServers": {
"bitrise": {
"command": "go",
"args": [
"run",
"github.com/bitrise-io/bitrise-mcp/v2@v2"
],
"env": {
"BITRISE_TOKEN": "$BITRISE_PAT"
}
}
}
}

確認Click to copy link​

Bitrise MCPサーバーが設定されていることを確認するには、ターミナルでgeminiを使ってGemini CLIを起動し、次の操作を行います。

  1. Check MCPサーバーのステータスを確認する:

    /mcp list
    ℹ Configured MCP servers:

    🟢 bitrise - Ready (62 tools)
    - abort_build
    - abort_pipeline
    - add_member_to_group
    ...
  2. プロンプトでテストする
    List my Bitrise apps

    PATなしでリモートサーバーを使用している場合、最初のツール呼び出しでOAuthのサインインフローがトリガーされます。

詳細設定Click to copy link​

特定のツールセットを有効または無効にする方法については、ツールを参照してください。

Gemini CLIのその他のMCP設定オプションについては、MCP Configuration Structureを参照してください。たとえば、ツールの確認をバイパスしたり、特定のツールを除外したりできます。

トラブルシューティングClick to copy link​

認証の問題Click to copy link​

  • OAuthフローが開かない: Gemini CLIを最新のビルドに更新するか、PATベースの認証にフォールバックしてください。
  • Tokenの有効期限切れ(PAT): 新しいBitriseトークンを生成してください。

設定の問題Click to copy link​

  • Invalid JSON: 設定を検証してください:
    cat ~/.gemini/settings.json | jq .
  • MCPの接続問題: 接続エラーについてログを確認してください:
    gemini --debug "test command"