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

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

前提条件Click to copy link​

  1. Cursor IDEがインストールされていること(latest version、MCP OAuthのサポートを含む — Streamable HTTPにはCursor v0.48.0以降、OAuthには最新のビルドが必要)
  2. Bitriseアカウント
  3. ローカルセットアップの場合: Go(1.25以上)がインストールされていること、およびBitriseのPAT

最近のバージョンのCursorはMCP OAuthをサポートしています。初回のツール使用時に、Cursorがブラウザを開いてBitriseへのサインインを求めます。トークンを貼り付ける必要はありません。

オプション A: Cursor Marketplace からインストールする(ワンクリック)Click to copy link​

このリポジトリには Cursor プラグインのマニフェスト(.cursor-plugin/plugin.json + mcp.json)が含まれているため、設定ファイルを編集せずに、Cursor Marketplaceからリモートサーバーをインストールできます。

  1. Cursor で Settings → Plugins を開く(または Marketplace を参照する)と、Bitrise をインストールします
  2. 最初のツール呼び出し時に、ブラウザーでのサインインフローを完了します

オプション B: 手動でインストールする手順Click to copy link​

  1. グローバルのMCP設定ファイル ~/.cursor/mcp.json を開き(またはプロジェクトローカルの .cursor/mcp.json を使用し)、以下の設定を追加します
  2. ファイルを保存します
  3. Cursor を再起動します
  4. 最初のツール呼び出し時に、ブラウザーでのサインインフローを完了します

Streamable HTTPの設定Click to copy link​

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

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

CursorのバージョンがMCP OAuthにまだ対応していない場合は、パーソナルアクセストークンを使用できます。Account Settings → セキュリティから作成し、次の手順を行います。

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

ローカルサーバーのセットアップClick to copy link​

ローカルのBitrise MCPサーバーはGo経由で動作し、パーソナルアクセストークンを使用します(stdioモード、OAuthなし)。

MCPサーバーをインストール

インストール手順Click to copy link​

  1. 上のインストールボタンをクリックして手順に従うか、~/.cursor/mcp.json を開いて以下の設定を追加します
  2. Tools & Integrations → MCP tools で、"bitrise" の横にある鉛筆アイコンをクリックします
  3. YOUR_BITRISE_PAT を実際の Personal Access Token に置き換えます
  4. ファイルを保存します
  5. Cursor を再起動します

ローカル設定Click to copy link​

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

設定ファイルClick to copy link​

  • グローバル(all projects): ~/.cursor/mcp.json
  • プロジェクト固有: プロジェクトのルートにある.cursor/mcp.json

インストールの確認Click to copy link​

  1. Cursorを完全に再起動します
  2. [設定]→[Tools & Integrations]→[MCP Tools]で緑色のドットを確認します
  3. チャットまたはコンポーザーで「Available Tools」を確認します
  4. 「List my Bitrise apps」でテストします(サインインしていない場合、最初のツール呼び出しでOAuthフローがトリガーされます)

詳細設定Click to copy link​

Marketplaceからのインストールではhttps://mcp.bitrise.io/?toolset=allですべてのツールセットが有効になります。手動設定でも同じURLを使用できます。Cursorでは、ツールの数が非常に多いサーバーがエラーなしでエージェントから消えるという報告があります。Bitriseのツールがエージェントに表示されない場合は、toolsetクエリパラメーターで必要なツールセットのみを有効にしてください。次の例では、CIのツールのみを残します。

{
"mcpServers": {
"bitrise": {
"url": "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​

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

  • OAuth flow doesn't open browser: Cursorを最新のビルドに更新してください。Streamable HTTPには対応しているもののOAuthには対応していない古いビルドの場合は、上記のPATベースのフォールバックを使用できます。
  • Streamable HTTPが動作しない: Cursor v0.48.0以降を使用していることを確認してください
  • 接続エラー: ファイアウォールやプロキシの設定を確認してください

全般的な問題Click to copy link​

  • MCPが読み込まれない: 設定後にCursorを完全に再起動してください
  • Invalid JSON: json形式が正しいことを確認してください
  • Tools not appearing: MCPの設定でサーバーが緑色のドットを表示しているか確認してください
  • Checkのログ: CursorのログでMCP関連のエラーを確認してください

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

  • Cursor固有の仕様: プロジェクトおよびグローバルの両方の設定に対応し、mcpServersキーを使用します