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

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

前提条件Click to copy link​

  • AWS Kiro IDE がインストールされていること

認証Click to copy link​

Kiro は現在、MCP サーバーに対して環境変数ベースの認証を使用しているため、標準的な Power のインストールでは Bitrise Personal Access Token(PAT)を使用します。Account Settings → SecurityでBitrise API トークンを作成してください。

MCP OAuth に対応した Kiro のビルドを使用しており、そちらを使用したい場合は、以下のOAuth ベースの Kiro 設定セクションを参照してください。

Kiro Power を使用したインストールClick to copy link​

AWS Kiro では、Bitrise MCP サーバーを Power としてインストールできます。これにより、コンテキストとキーワードに基づいた自動アクティベーションが提供されます。

StepsClick to copy link​

  1. Powers パネルを開く
    • Kiro IDE で、サイドバーから Powers パネルを開きます
  2. Add Power from GitHub
    • 「Add power from GitHub」をクリックします
  3. Repository URL を入力する
    https://github.com/bitrise-io/bitrise-mcp/tree/main/kiro-powers/bitrise-ci
  4. Set Up Authentication
    • Kiro を起動する前に、シェルプロファイル(.zshrc または .bashrc)で BITRISE_TOKEN 環境変数を設定します。
      export BITRISE_TOKEN="your-actual-token-here"
    • ターミナルを再起動するか、source ~/.zshrc(または source ~/.bashrc)を実行します
    • Kiro を起動します。起動時に環境変数が読み込まれます
    • Kiro の起動時に、環境変数を信頼するかどうかを確認するポップアップが表示される場合があります。アクセスを許可するには承認してください
  5. Verify Installation
    • Powers リストに Bitrise Power が表示されるようになります
    • 「bitrise」「ビルド」「ci」「cd」「mobile」「ios」「android」などのキーワードに言及すると自動的にアクティベートされます

使用方法Click to copy link​

インストールが完了すると、Bitrise Power は関連する場面で自動的にアクティベートされます。以下のことができます。

  • Bitrise アプリの管理
  • ビルドのトリガーと監視
  • ビルドアーティファクトの処理
  • workspaces とチームの管理
  • パイプラインの設定
  • Set up release management

この power は、63 個すべての Bitrise ツールへのアクセスを提供します。利用可能なツールとそのパラメータの完全な一覧については、ツールのドキュメントを参照してください。

OAuth ベースの設定(実験的機能)Click to copy link​

MCP OAuth に対応した Kiro のビルドでは、BITRISE_TOKEN の要件を完全に省略できます。~/.kiro/settings/mcp.json(ユーザーレベル)または .kiro/settings/mcp.json(workspace レベル)を編集し、headers ブロックを削除します。

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

初回のツール使用時に、Kiro は Bitrise のサインインフローのためにブラウザを開きます。

詳細設定Click to copy link​

ツールセットを設定して、公開するツールを制限できます。トークンの使用量を最適化したり、特定の機能に絞ったりする場合に便利です。

使用できるツールセット:

  • apps - アプリの管理
  • builds - ビルドの操作
  • artifacts - アーティファクトの管理
  • workspaces - Workspaceの管理
  • pipelines - Pipelineの操作
  • outgoing-webhooks - Webhook configuration
  • cache-items - キャッシュの管理
  • release-management - リリースと配布
  • group-roles - ロールの管理
  • account - ユーザーアカウントの操作
  • read-only - 読み取り専用の操作

デフォルトでは、すべてのグループが有効です。カスタマイズするには、インストール後にPowerの設定を変更します。

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

環境変数が機能しないClick to copy link​

Kiro IDE は、Kiro の起動前にシェルプロファイル(.zshrc または .bashrc)に設定された environment variables のみを読み取ることができます。VS Code とは異なり、Kiro はトークンの値を入力するよう求めません。環境変数がすでに利用可能であることを前提としています。

オプション1: シェルプロファイルに設定する(推奨)
  1. シェルプロファイルに export を追加します。
    # Add to ~/.zshrc or ~/.bashrc
    export BITRISE_TOKEN="your-actual-token-here"
  2. ターミナルを再起動するか、プロファイルを再読み込みします: source ~/.zshrc
  3. Kiro を再起動します。これは、Kiro が新しい環境変数を認識するために必要です
  4. プロンプトが表示されたら、環境変数を信頼するかどうかを確認するポップアップを承認します

オプション2: 手動設定 環境変数の方法がうまくいかない場合は、トークンをハードコードできます。

  1. ~/.kiro/settings/mcp.json(ユーザーレベル)または .kiro/settings/mcp.json(workspace レベル)を開きます
  2. Bitrise サーバーのエントリを見つけます
  3. ${BITRISE_TOKEN} を実際のトークンの値に置き換えます
  4. ファイルを保存して Kiro を再起動します

オプション3: OAuth を使用する Kiro のビルドが MCP OAuth に対応している場合は、上記のOAuth ベースの設定セクションを参照してください。

Environment 変数の構文に関する注意 environment variables の構文は、Kiro CLI と IDE で異なります。

  • Kiro CLI: env: プレフィックス付きの ${env:BITRISE_TOKEN} を使用します
  • Kiro IDE: プレフィックスなしの ${BITRISE_TOKEN} を使用します

この不整合は既知の問題です。この Power は、IDE で動作する ${BITRISE_TOKEN} で設定されています。

Power がアクティベートされないClick to copy link​

  • /tree/main/power パスを含む正しいリポジトリの URL を入力しているか確認してください
  • BITRISE_TOKEN が有効であることを確認してください
  • 会話の中で「bitrise」のような明示的なキーワードに言及してみてください

認証の問題Click to copy link​

  • Personal Access Token が引き続き有効であることを確認してください
  • Bitrise account settings でトークンの権限を確認してください
  • 必要に応じてトークンを再生成してください

接続の問題Click to copy link​

  • この power は https://mcp.bitrise.io に接続します
  • インターネット接続があることを確認してください
  • ファイアウォールの制限がないか確認してください

関連情報Click to copy link​