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

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

前提条件Click to copy link​

  1. Windsurf IDE がインストールされていること(latest version)
  2. Bitrise アカウント
  3. ローカルセットアップの場合: Go(1.25 以上)がインストールされていること、および Bitrise PAT

リモート Bitrise MCP サーバーは Bitrise によって https://mcp.bitrise.io でホストされており、Streamable HTTP をサポートしています。最近の Windsurf のビルドは MCP OAuth をサポートしています。最初にツールを使用する際にブラウザが開き、Bitrise へのサインインを求められます。トークンを貼り付ける必要はありません。

Streamable HTTP の設定Click to copy link​

{
"mcpServers": {
"bitrise": {
"serverUrl": "https://mcp.bitrise.io"
}
}
}

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

Windsurf のビルドがまだ MCP OAuth をサポートしていない場合は、Account Settings → セキュリティ の下で Bitrise PAT を作成し、ヘッダーとして追加してください。

{
"mcpServers": {
"bitrise": {
"serverUrl": "https://mcp.bitrise.io",
"headers": {
"Authorization": "Bearer YOUR_BITRISE_PAT"
}
}
}
}

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

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

インストール StepsClick to copy link​

手動設定Click to copy link​

  1. Cascade でハンマーアイコン(🔨)をクリックします。
  2. Configure をクリックして ~/.codeium/windsurf/mcp_config.json を開きます。
  3. 上記から選択した設定を追加します。
  4. ファイルを保存します。
  5. MCP ツールバーの Refresh(🔄)をクリックします。
  6. 最初のツール呼び出し時に、ブラウザベースのサインインフローを完了させます(OAuth のセットアップの場合のみ)。

設定の詳細Click to copy link​

  • ファイルパス: ~/.codeium/windsurf/mcp_config.json
  • Scope: グローバル設定のみ(プロジェクト単位の設定はサポートされません)
  • Format: 有効な JSON である必要があります(リンターで確認してください)

確認Click to copy link​

インストール後:

  1. MCP ツールバーに「1 available MCP server」と表示されることを確認します。
  2. ハンマーアイコンをクリックして、利用可能な Bitrise ツールを確認します。
  3. 「List my Bitrise apps」と入力してテストします(リモートサーバーを使用している場合、最初の呼び出しで OAuth のサインインがトリガーされます)。
  4. サーバー名の横に緑色のドットが表示されていることを確認します。

詳細設定Click to copy link​

Cascadeでは、すべてのMCPサーバーを合わせて最大100個のツールを使用できます。デフォルトのツールセットはBitriseのツールを88個公開するため、他のMCPサーバーに使える余裕がほとんどなく、allは136個公開します。サーバーURLのtoolsetクエリパラメーターで、必要なツールセットのみを有効にすることをお勧めします。次の例では、CIのツールのみを残します。

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

ローカルサーバーの場合は、同じカンマ区切りのリストを、代わりにENABLED_TOOLSET環境変数に指定します。不要な個別のツールをdisabledToolsに列挙することもできます。

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

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

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

リモートサーバーの問題Click to copy link​

  • OAuth flow doesn't open browser: Windsurf を最新のビルドに更新してください。古いバージョンでは PAT ベースの認証にフォールバックしてください。
  • Authentication の失敗(PAT): PAT の有効期限が切れていないか、失効していないかを確認してください。
  • 接続エラー: HTTPS 接続に関するファイアウォール/プロキシの設定を確認してください。
  • Streamable HTTP が機能しない: 正しい serverUrl フィールド形式を使用しているか確認してください。

一般的な問題Click to copy link​

  • Invalid JSON: jsonlint.com で検証してください。
  • Tools not appearing: Windsurf を完全に再起動してください。
  • Check ログ: ~/.codeium/windsurf/logs/

重要な注意事項Click to copy link​

  • Windsurf の制限事項: 環境変数の展開はサポートされておらず、グローバル設定のみ利用可能です。