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

Copilot IDEへのBitrise MCPサーバーのインストール

さまざまなIDEのGitHub CopilotでBitrise MCPサーバーをセットアップするためのクイックガイドです。VS Codeの手順については、Install Bitrise MCP Server in VS Codeを参照してください。

要件:Click to copy link​

  1. GitHub Copilot ライセンス: Copilot へのアクセスには、いずれかの Copilot プラン(Free、Pro、Pro+、Business、Enterprise)が必要です
  2. Bitrise アカウント: Bitrise MCPサーバーへのアクセスには Bitrise アカウントが必要です
  3. MCP Servers in Copilot ポリシー: Copilot のシートを割り当てている組織は、Copilot for VS Code および Copilot Coding Agent におけるすべての MCP アクセスに対してこのポリシーを有効にする必要があります。他の Copilot IDE についても、今後数か月以内にこのポリシーへ移行される予定です
  4. ローカルセットアップの場合: Go(1.23 以上)がインストールされていること、および Bitrise Personal Access Token が必要です

以下のリモートセットアップでは OAuth を使用します。初回のツール使用時に IDE がブラウザを開き、Bitrise にサインインするだけで、トークンを貼り付ける必要はありません。MCP OAuth に対応していない古い Copilot IDE ビルドについては、各 IDE ごとに PAT ベースのフォールバック構成を用意しています。

Visual StudioClick to copy link​

Visual Studio 2022 バージョン 17.14.9 以降が必要です。

リモート Bitrise MCP サーバーは Bitrise によってホストされており、ローカルセットアップ不要で自動更新が提供されます。

構成Click to copy link​

  1. ソリューションまたは %USERPROFILE% ディレクトリに .mcp.json ファイルを作成します。

  2. 次の構成を追加します:

    {
    "servers": {
    "bitrise": {
    "url": "https://mcp.bitrise.io"
    }
    }
    }
  3. ファイルを保存します。CodeLens が更新され、新しいサーバーへの認証方法が表示されるまで待ってから、それを実行し、ブラウザで Bitrise サインインを完了します。

  4. GitHub Copilot Chat ウィンドウで、Agent モードに切り替えます。

  5. Chat ウィンドウでツールピッカーを開き、「bitrise」MCP サーバーから1つ以上のツールを有効にします。

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

{
"servers": {
"bitrise": {
"url": "https://mcp.bitrise.io",
"headers": {
"Authorization": "Bearer YOUR_BITRISE_PAT"
}
}
}
}

Account Settings → Securityから PAT を作成します。

ローカルサーバー(Go が必要)Click to copy link​

構成Click to copy link​

  1. ソリューションまたは %USERPROFILE% ディレクトリに .mcp.json ファイルを作成します。

  2. 次の構成を追加します:

    {
    "servers": {
    "bitrise": {
    "type": "stdio",
    "command": "go",
    "args": ["run", "github.com/bitrise-io/bitrise-mcp/v2@v2"],
    "env": {
    "BITRISE_TOKEN": "YOUR_BITRISE_PAT"
    }
    }
    }
    }
  3. ファイルを保存します。CodeLens が更新され、ユーザー入力を行う方法が表示されるまで待ってから、それを実行し、Bitrise Account Settings/Securityで生成した PAT を貼り付けます。

  4. GitHub Copilot Chat ウィンドウで、Agent モードに切り替えます。

  5. Chat ウィンドウでツールピッカーを開き、「bitrise」MCP サーバーから1つ以上のツールを有効にします。

Documentation: Visual Studio MCP ガイド

JetBrains IDEClick to copy link​

Agent モードと MCP サポートは、IntelliJ IDEA、PyCharm、WebStorm などの JetBrains IDE でパブリックプレビューとして利用できます。

Steps の構成Click to copy link​

  1. GitHub Copilot プラグインをインストールまたは更新します。

  2. ステータスバーの GitHub Copilot アイコン → Edit Settings → Model Context Protocol → Configure の順にクリックします。

  3. Add configuration:

    {
    "servers": {
    "bitrise": {
    "url": "https://mcp.bitrise.io"
    }
    }
    }
  4. Ctrl + S または Command + S を押して保存するか、mcp.json ファイルを閉じます。初回のツール使用時に、IDE がブラウザを開いて Bitrise サインインを行います。

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

{
"servers": {
"bitrise": {
"url": "https://mcp.bitrise.io",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_BITRISE_PAT"
}
}
}
}
}

ローカルサーバー(Go が必要)Click to copy link​

{
"servers": {
"bitrise": {
"command": "go",
"args": [
"run",
"github.com/bitrise-io/bitrise-mcp/v2@v2"
],
"env": {
"BITRISE_TOKEN": "YOUR_BITRISE_PAT"
}
}
}
}

Documentation: JetBrains Copilot ガイド

XcodeClick to copy link​

Agent モードと MCP サポートは、Xcode 向けにパブリックプレビューとして利用できるようになりました。

Steps の構成Click to copy link​

  1. Xcode 向け GitHub Copilotをインストールまたは更新します。

  2. GitHub Copilot for Xcode app → Agent Mode → 🛠️ Tool Picker → Edit Config の順に開きます。

  3. MCP サーバーを構成します:

    {
    "servers": {
    "bitrise": {
    "url": "https://mcp.bitrise.io"
    }
    }
    }
  4. 初回のツール使用時に、ブラウザで Bitrise サインインフローを完了します。

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

{
"servers": {
"bitrise": {
"url": "https://mcp.bitrise.io",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_BITRISE_PAT"
}
}
}
}
}

ローカルサーバー(Go が必要)Click to copy link​

{
"servers": {
"bitrise": {
"command": "go",
"args": [
"run",
"github.com/bitrise-io/bitrise-mcp/v2@v2"
],
"env": {
"BITRISE_TOKEN": "YOUR_BITRISE_PAT"
}
}
}
}

Documentation: Xcode Copilot ガイド

EclipseClick to copy link​

MCP サポートは、Eclipse 2024-03 以降、および latest version の GitHub Copilot プラグインで利用できます。

Steps の構成Click to copy link​

  1. Eclipse Marketplace から GitHub Copilot 拡張機能をインストールします。

  2. GitHub Copilot アイコン → Edit Preferences → (GitHub Copilot の下にある)MCP の順にクリックします。

  3. Bitrise MCP サーバー構成を追加します:

    {
    "servers": {
    "bitrise": {
    "url": "https://mcp.bitrise.io"
    }
    }
    }
  4. 「Apply and Close」ボタンをクリックします。初回のツール使用時に、ブラウザで Bitrise サインインを完了します。

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

{
"servers": {
"bitrise": {
"url": "https://mcp.bitrise.io",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_BITRISE_PAT"
}
}
}
}
}

ローカルサーバー(Go が必要)Click to copy link​

{
"servers": {
"bitrise": {
"command": "go",
"args": [
"run",
"github.com/bitrise-io/bitrise-mcp/v2@v2"
],
"env": {
"BITRISE_TOKEN": "YOUR_BITRISE_PAT",
"PATH": "PATH to bin directory of go:PATH to directory of git"
}
}
}
}

Documentation: Eclipse Copilot プラグイン

使用方法Click to copy link​

セットアップ後:

  1. IDE を完全に再起動します
  2. Copilot Chat で Agent モードを開きます
  3. 試してみましょう: 「Bitrise アプリを一覧表示して」 — 最初の呼び出しでリモートサーバーの OAuth サインインがトリガーされます
  4. これで Copilot が Bitrise データにアクセスし、操作を実行できるようになります

詳細設定Click to copy link​

GitHub Copilotでは、チャットリクエストに含めるツールの数に上限があり、ツールを動的に読み込みません。VS Codeの上限は、組み込みツールを含めて128です。デフォルトのツールセットはBitriseのツールを88個公開し、allは136個公開します。IDEでツールが多すぎると表示される場合は、必要なツールセットのみを有効にしてください。リモートサーバーの場合は、上記の設定のurlにtoolsetクエリパラメーターを追加します。次の例では、CIのツールのみを残します。

https://mcp.bitrise.io/?toolset=apps,builds,workspaces,outgoing-webhooks,artifacts,group-roles,cache-items,pipelines,account,configuration,insights

ローカルサーバーの場合は、同じカンマ区切りのリストを、代わりにENABLED_TOOLSET環境変数に指定します。

有効にしていないツールセットのツール(ストアリリースのツールなど)がタスクで必要な場合、エージェントはlist_toolsetを呼び出して、追加するツールセットを確認できます。

すべてのツールセットと、一般的なツール数の上限に収まる組み合わせについては、ツールセットを参照してください。

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

  • OAuth flow doesn't open browser: Copilot の統合が MCP OAuth をサポートするビルドであることを確認してください。古いバージョンでは PAT ベースの認証にフォールバックしてください。
  • 接続の問題: IDE のバージョンの互換性を確認してください
  • Authentication エラー: 組織で Copilot の MCP ポリシーが有効になっているかを確認してください
  • Tools not appearing: 構成変更後に IDE を再起動し、エラーログを確認してください