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

エージェント向けオンボーディング

Bitriseは、iOSおよびAndroid(FlutterやReact Nativeを含む)向けの、モバイルに特化したCI/CDとアプリ配布です。Claude CodeやCursor、GitHub Copilot付きのVS CodeなどのAIエージェントを使って作業している場合、チャットから離れることなくBitrise MCPサーバーを使ってBitriseに接続できます。エージェントが初めてアクセスを必要とするとき、クライアントは認証を求め、ブラウザでBitriseのサインインを開始します。一度サインイン(またはアカウントを作成)して接続を承認すれば、エージェントは認証されます。同じサインインでBitrise websiteにもログインするため、二重に設定する必要はありません。

この機能を使う場面Click to copy link​

CI/CDやアプリ配布、ローカルビルドをデバイスに配布する目的でBitriseを使いたく、かつ次のいずれかに該当する場合です。

  • Bitriseアカウントをまだ持っていない場合は、ブラウザでのサインイン中に作成します。GitHub、Bitbucket、Google、その他のソーシャルSSO、またはメールアドレスとパスワードを使用できます。
  • すでにアカウントを持っている場合は、サインインして接続を承認するだけです。

どちらの場合も流れは同じです。エージェントがブラウザページを開き、そこで手続きを完了します。

エージェントを使いたくない場合は、ブラウザからBitriseに登録することもできます。

MCP経由で接続するClick to copy link​

MCPサーバーはOAuthを使用します。クライアントに認証が必要であることを伝え、クライアントがブラウザでのサインインを代行します。トークンをコピー&ペーストする必要は一切ありません。

Step 1: MCPに対応したAIクライアントを用意するClick to copy link​

MCPに対応したAIクライアントが必要です。以下の各手順では、Claude Code、Cursor、VS Code、Claude Desktopという、最も一般的なクライアントの設定方法を説明します。Bitrise MCPは、Windsurf、Google Antigravity CLI、AWS Kiro、その他のCopilot IDEにも対応しています。クライアント固有の詳細については、それぞれのインストールガイドを参照してください。

Step 2: MCPサーバーに接続するClick to copy link​

クライアントを、トークンなしでリモートサーバーに向けて設定します。サーバーはクライアントにOAuthで保護されていることを伝え、以降の認証処理はクライアントが行います。設定を編集したら、変更を反映させるためにクライアントを再読み込みしてください(MCPクライアントの再接続を参照)。

claude mcp add --transport http bitrise https://mcp.bitrise.io

詳細なセットアップ: Claude Applications。

Step 3: サインインするか、アカウントを作成するClick to copy link​

サーバーは認証を必須としているため、匿名では接続できません。エージェントが自動でサインインすることはできません。(Step 2で再読み込みした後)クライアントが接続すると、Bitriseに認証が必要であることを検知し、ブラウザでサインインを開始します。開始方法はクライアントによって異なります。Claude Codeでは、/mcpを実行し、bitriseを選択してサインインを開始してください。

Bitriseのサインインページでは、次の手順を行います。

  1. サインインするかsign upします。 GitHub、Bitbucket、Google、その他のソーシャルプロバイダーを選択するか、メールアドレスとパスワードを使用してください。ここで新規アカウントをその場で作成できます。別途Webサイトでの登録は不要です。
  2. 接続を承認します。 Bitriseが、アクセスを要求しているアプリケーション名を示す同意画面を表示します。続行するには承認してください。

承認すると、ブラウザは自動的に認証情報をエージェントに渡します。コピーや貼り付けの操作は不要です。

ウェブサイトのセッションも自動的に付与されます

ここでサインインすると、同じブラウザ上のapp.bitrise.ioにも自動的にログインするため、ダッシュボードを開く際に再度ログインを求められることはありません。

Step 4: メールアドレスを確認する(メールアドレスとパスワードの場合のみ)Click to copy link​

メールアドレスとパスワードでアカウントを作成した場合、Bitriseはすぐに確認メールを送信し、「メールアドレスを確認してください」という画面を表示します。ソーシャルサインイン(GitHub、Bitbucket、Google)ではこの手順は不要です。プロバイダー側ですでに検証済みのためです。

  • どのデバイスでも構いません(エージェントを実行しているパソコン、スマートフォンなど、手元にあるもの)。メールを開き、確認リンクをクリックしてください。
  • 確認画面は自動的にポーリングするため、どこでリンクをクリックしても問題ありません。メールアドレスが確認されると、画面は数秒以内にそれを検知して自動的に再読み込みされ、認証処理を自動的に続行します。
  • 元のウィンドウに戻ったり、何かを再入力したりする必要はありません。確認が完了すると、処理は中断した箇所から自動的に再開します。

Step 5: 接続を確認するClick to copy link​

認証が完了すると、エージェントは有効化されているBitriseツールを呼び出せるようになります。meまたはlist_workspacesツールを実行させて、接続を確認してください。新規の場合は、Workspaceが自動的に作成されます。Workspacesがアプリやチームをどのように整理するかについては、Workspacesの概要をご覧ください。

個人用アクセストークンを使う場合Click to copy link​

OAuthのフローは、短期間有効なトークンをバックグラウンドで発行・更新するため、認証情報を管理しなくても接続を維持できます。クライアントの認証が失われた場合(長時間アイドル状態が続いた後など)も、ブラウザでのサインインが再度開くだけです。

固定の認証情報を使いたい場合(CIやスクリプト、OAuthに対応していないクライアントなど)は、Account settings → Securityで永続的な個人用アクセストークンを作成し、OAuthに頼る代わりにAuthorizationヘッダーとして追加してください。

claude mcp remove bitrise && claude mcp add --transport http bitrise https://mcp.bitrise.io -H "Authorization: Bearer <token>"

MCPクライアントを再接続するClick to copy link​

Step 2で設定を編集しても、クライアントがBitrise MCPサーバーを再読み込みするまでは反映されません。クライアントによっては、ここでOAuthのサインインが表示されることもあります(たとえば、Claude Codeの/mcpが認証を行う場所です)。再読み込みの方法はクライアントによって異なります。

  • Claude Code(CLI): /mcpを実行してサーバーの表示、再接続、認証を行うか、claudeを終了して再起動してください。
  • VS Code(GitHub Copilot): Commandパレット(Cmd/Ctrl+Shift+P)を開き、MCP: List Serversを実行してbitriseを選択し、Restartを選ぶか、Developer: Reload Windowを実行してください。
  • Cursor: Settings → MCP (Tools)を開き、bitriseサーバーをオフ・オンに切り替えるか、更新アイコンをクリックしてください。Cursorを再起動しても構いません。
  • Claude Desktop: アプリを完全に終了し(macOSではCmd+Q、Windowsではシステムトレイから終了)、再度開いてください。ウィンドウを閉じるだけでは再読み込みされません。
  • Otherクライアント(Windsurf、Antigravity CLI、AWS Kiro): クライアントを再起動するか、MCP接続が公開されている場合はそちらを再起動してください。

うまくいかない場合Click to copy link​

  • サインインのプロンプトが表示されない場合: クライアントでMCPサーバーを再読み込みし(MCPクライアントを再接続するを参照)、認証プロンプトを再度発生させてください。Claude Codeでは、/mcpを実行してbitriseのサインインを開始します。
  • 承認前にページを閉じてしまった場合: Bitriseツールを再度実行すると、クライアントがサインインを再開します。
  • 「メールアドレスを確認してください」の画面から進まない場合: Bitriseが送信した確認メール内のリンクをクリックしてください(迷惑メールフォルダも確認してください)。画面は数秒おきにポーリングしており、メールアドレスが確認されると自動的に処理を続行します。手動での再読み込みは不要です。
  • 登録時に「このメールアドレスはすでに登録されています」と表示される場合: すでにBitriseアカウントをお持ちです。新規作成せずに、前の画面に戻ってそのプロバイダーまたはメールアドレスでサインインしてください。

アカウント作成後Click to copy link​

同じMCP接続を使って、これ以降のBitrise(アプリの作成とリポジトリの接続、bitrise.ymlの設定、ビルドのトリガー、ログの読み取り、アーティファクトと配布の管理)をすべて行えます。サーバーが公開するツールグループを制限することもできます。詳しくはToolsを参照してください。

リポジトリの接続と最初のビルドの実行に関する規約とガイド付きの手順については、Bitriseエージェントスキルをインストールしてください。

npx skills add bitrise-io/agent-skills

これによりusing-bitrise-ciスキルがインストールされ、Bitrise CIに関するトピックで自動的に読み込まれます。/using-bitrise-ciで明示的に呼び出すか、--globalを追加してすべてのプロジェクトにインストールしてください。

Bitriseが初めての方は、はじめにとBitriseの主要な概念から始めてください。AIを使ってBitriseでほかに何ができるかについては、BitriseのAI機能をご覧ください。