Bitrise MCP サーバー

アプリ管理、ビルド操作、アーティファクト管理などを可能にする Bitrise API 用の MCP サーバー。

特徴

包括的な API アクセス: アプリ、ビルド、アーティファクトなどを含む Bitrise API へのアクセス。
認証サポート: Bitrise リソースへの API トークンベースの安全なアクセス。
詳細なドキュメント: パラメータの説明が付いた、よく文書化されたツール。

設定

環境設定

Python 3.12.6 が必要です ( pyenvを使用できます)。
依存関係の管理にはuvを使用します。

環境設定の例

その他のオプションについては、uv および pylint の公式ドキュメントをお読みください。

# Install pyenv and python 3.12.6 curl -fsSL https://pyenv.run | bash pyenv install 3.12.6 # Install uv curl -LsSf https://astral.sh/uv/install.sh | sh

Bitrise APIトークン

Bitrise APIトークンを作成します:

Bitrise アカウントの設定/セキュリティに移動します。
「個人アクセストークン」セクションに移動します。
生成されたトークンをコピーします。

Claude Desktopで使用する

このガイドでは、MCP クライアントとして Claude Desktop を使用していますが、他の MCP 互換クライアントを使用して、次の構成オプションを希望のクライアントに合わせて調整することもできます。

Claude の設定を開き、[開発者] タブに移動します。

*「Edit config」*をクリックします。これにより、 claude_desktop_config.jsonという設定ファイルが作成されます。このファイルをお好みのエディタで開き、Bitrise MCPサーバーを追加します。

{ "mcpServers": { "bitrise": { "command": "uvx", "env": { "BITRISE_TOKEN": "<YOUR_TOKEN>" }, "args": [ "--from", "git+https://github.com/bitrise-io/bitrise-mcp@v1.1.0", "bitrise-mcp" ] } } }

設定ファイルを保存し、Claude Desktopを再起動します。すべてが正しく設定されていれば、メッセージ作成ツールの横にハンマーアイコンが表示されます。

VSコードでの使用

Copilot Chat でエージェントモードを有効にするには、公式ガイドに従ってください。

次に、VSCode のsettings.json (ワークスペースレベルまたはユーザーレベルの設定) を開き、 mcp.serversキーの下に Bitrise MCP サーバー構成を追加し、 mcp.inputsキーの下にワークスペーストークンの入力を追加します。

{ "mcp": { "inputs": [ { "id": "bitrise-workspace-token", "type": "promptString", "description": "Bitrise workspace token", "password": true } ], "servers": { "bitrise": { "command": "uvx", "args": [ "--from", "git+https://github.com/bitrise-io/bitrise-mcp@v1.0.1", "bitrise-mcp" ], "type": "stdio", "env": { "BITRISE_TOKEN": "${input:bitrise-workspace-token}" } }, } } }

設定を保存します。VS Code は変更を自動的に認識し、ツールを Copilot Chat に読み込みます。

高度な設定

MCPクライアントに公開されるツールの数を制限できます。これは、トークンの使用を最適化したい場合や、MCPクライアントにツール数制限がある場合に便利です。

ツールは「API グループ」ごとにグループ化されており、ツールとして公開するグループを渡すことができます。指定可能な値: apps, builds, workspaces, webhooks, build-artifacts, group-roles, cache-items, pipelines, account, read-only, release-management 。

apps API グループとの混乱を避けるため、 release-management API グループを個別に使用することをお勧めします。

構成例:

{ "mcpServers": { "bitrise": { "command": "uvx", "env": { "BITRISE_TOKEN": "<YOUR_PAT>" }, "args": [ "--from", "git+https://github.com/bitrise-io/bitrise-mcp@v1.1.0", "bitrise-mcp", "--enabled-api-groups", "cache-items,pipelines" ] }, } }

Related MCP server: Xcode MCP Server

ツール

アプリ

list_apps
- 認証されたアカウントで利用可能なすべてのアプリを一覧表示します
- 引数:
  - sort_by (オプション): アプリの順序: last_build_at (デフォルト) または created_at
  - next (オプション): レスポンスの最初のアプリのスラッグ
  - limit (オプション): ページあたりの要素の最大数 (デフォルト: 50)
register_app
- Bitriseに新しいアプリを追加する
- 引数:
  - repo_url : リポジトリのURL
  - is_public : アプリのビルドの可視性が「公開」かどうか
  - organization_slug : アプリを追加する組織（ワークスペース）
  - project_type (オプション): プロジェクトの種類 (ios、android など)
  - provider （オプション）: github
finish_bitrise_app
- Bitriseアプリのセットアップを完了する
- 引数:
  - app_slug : セットアップを完了するBitriseアプリのスラッグ
  - project_type (オプション): プロジェクトのタイプ (例: android、ios、flutter など)
  - stack_id (オプション): アプリで使用するスタックID
  - mode （オプション）: セットアップのモード
  - config (オプション): アプリで使用する設定
get_app
- 特定のアプリの詳細を取得する
- 引数:
  - app_slug : Bitriseアプリの識別子
delete_app
- Bitriseからアプリを削除する
- 引数:
  - app_slug : Bitriseアプリの識別子
update_app
- アプリを更新する
- 引数:
  - app_slug : Bitriseアプリの識別子
  - is_public : アプリのビルドの可視性が「公開」かどうか
  - project_type : プロジェクトの種類
  - provider : リポジトリプロバイダー
  - repo_url : リポジトリのURL
get_bitrise_yml
- 指定されたBitriseアプリの現在のBitrise YML設定ファイルを取得します
- 引数:
  - app_slug : Bitriseアプリの識別子
update_bitrise_yml
- 指定されたBitriseアプリのBitrise YML設定ファイルを更新する
- 引数:
  - app_slug : Bitriseアプリの識別子
  - bitrise_yml_as_json : 新しいBitrise YML設定ファイルの内容
list_branches
- アプリのリポジトリの既存のビルドがあるブランチを一覧表示する
- 引数:
  - app_slug : Bitriseアプリの識別子
register_ssh_key

特定のアプリにSSHキーを追加する
引数:
- app_slug : Bitriseアプリの識別子
- auth_ssh_private_key : 秘密SSHキー
- auth_ssh_public_key : 公開SSHキー
- is_register_key_into_provider_service : プロバイダーサービスにキーを登録する

register_webhook

特定のアプリケーションに着信 Webhook を登録する
引数:
- app_slug : Bitriseアプリの識別子

ビルド

list_builds

指定されたBitriseアプリのすべてのビルドまたはアクセス可能なすべてのビルドを一覧表示します
引数:
- app_slug (オプション): Bitriseアプリの識別子
- sort_by （オプション）：ビルドの順序：created_at（デフォルト）、running_first
- branch （オプション）：ブランチでビルドをフィルタリングする
- workflow （オプション）：ワークフローでビルドをフィルタリングする
- status （オプション）：ビルドをステータスでフィルタリングします（0：未完了、1：成功、2：失敗、3：中止、4：進行中）
- next (オプション): レスポンスの最初のビルドのスラッグ
- limit (オプション): ページあたりの要素の最大数 (デフォルト: 50)

trigger_bitrise_build

指定されたBitriseアプリの新しいビルド/パイプラインをトリガーする
引数:
- app_slug : Bitriseアプリの識別子
- branch （オプション）：ビルドするブランチ（デフォルト：main）
- workflow_id (オプション): 構築するワークフロー
- commit_message (オプション): ビルドのコミットメッセージ
- commit_hash (オプション): ビルドのコミットハッシュ

get_build

特定のアプリの特定のビルドを取得する
引数:
- app_slug : Bitriseアプリの識別子
- build_slug : ビルドの識別子

abort_build

特定のビルドを中止する
引数:
- app_slug : Bitriseアプリの識別子
- build_slug : ビルドの識別子
- reason （オプション）: ビルドを中止する理由

get_build_log

Bitrise アプリの指定されたビルドのビルドログを取得する
引数:
- app_slug : Bitriseアプリの識別子
- build_slug : Bitriseビルドの識別子

get_build_bitrise_yml

ビルドのbitrise.ymlを取得する
引数:
- app_slug : Bitriseアプリの識別子
- build_slug : ビルドの識別子

list_build_workflows

アプリのワークフローを一覧表示する
引数:
- app_slug : Bitriseアプリの識別子

ビルドアーティファクト

list_artifacts

すべてのビルド成果物のリストを取得する
引数:
- app_slug : Bitriseアプリの識別子
- build_slug : ビルドの識別子
- next (オプション): レスポンスの最初のアーティファクトのスラッグ
- limit (オプション): ページあたりの要素の最大数 (デフォルト: 50)

get_artifact

特定のビルド成果物を取得する
引数:
- app_slug : Bitriseアプリの識別子
- build_slug : ビルドの識別子
- artifact_slugの識別子

delete_artifact

ビルドアーティファクトを削除する
引数:
- app_slug : Bitriseアプリの識別子
- build_slug : ビルドの識別子
- artifact_slugの識別子

update_artifact

ビルドアーティファクトを更新する
引数:
- app_slug : Bitriseアプリの識別子
- build_slug : ビルドの識別子
- artifact_slugの識別子
- is_public_page_enabled : アーティファクトの公開ページを有効にする

ウェブフック

list_outgoing_webhooks

アプリの送信Webhookを一覧表示する
引数:
- app_slug : Bitriseアプリの識別子

delete_outgoing_webhook

アプリの送信Webhookを削除する
引数:
- app_slug : Bitriseアプリの識別子
- webhook_slug : Webhookの識別子

update_outgoing_webhook

アプリの送信 Webhook を更新する
引数:
- app_slug : Bitriseアプリの識別子
- webhook_slug : Webhookの識別子
- events : Webhookをトリガーするイベントのリスト
- url : WebhookのURL
- headers （オプション）: Webhookで送信されるヘッダー

create_outgoing_webhook

アプリの送信Webhookを作成する
引数:
- app_slug : Bitriseアプリの識別子
- events : Webhookをトリガーするイベントのリスト
- url : WebhookのURL
- headers （オプション）: Webhookで送信されるヘッダー

キャッシュアイテム

list_cache_items

アプリに属するキー値キャッシュアイテムを一覧表示する
引数:
- app_slug : Bitriseアプリの識別子

delete_all_cache_items

アプリに属するすべてのキー値キャッシュアイテムを削除します
引数:
- app_slug : Bitriseアプリの識別子

delete_cache_item

キー値キャッシュアイテムを削除する
引数:
- app_slug : Bitriseアプリの識別子
- cache_item_id : キャッシュアイテムの識別子

get_cache_item_download_url

キー値キャッシュアイテムのダウンロード URL を取得する
引数:
- app_slug : Bitriseアプリの識別子
- cache_item_id : キャッシュアイテムの識別子

パイプライン

list_pipelines

アプリのすべてのパイプラインとスタンドアロンビルドを一覧表示する
引数:
- app_slug : Bitriseアプリの識別子

get_pipeline

指定されたアプリのパイプラインを取得する
引数:
- app_slug : Bitriseアプリの識別子
- pipeline_id : パイプラインの識別子

abort_pipeline

パイプラインを中止する
引数:
- app_slug : Bitriseアプリの識別子
- pipeline_id : パイプラインの識別子
- reason （オプション）：パイプラインを中止する理由

rebuild_pipeline

パイプラインを再構築する
引数:
- app_slug : Bitriseアプリの識別子
- pipeline_id : パイプラインの識別子

グループの役割

list_group_roles

アプリのグループロールを一覧表示する
引数:
- app_slug : Bitriseアプリの識別子
- role_name : ロールの名前

replace_group_roles

アプリのグループロールを置き換える
引数:
- app_slug : Bitriseアプリの識別子
- role_name : ロールの名前
- group_slugs : グループスラッグのリスト

ワークスペース

list_workspaces

ユーザーがアクセスできるワークスペースを一覧表示する

get_workspace

1つのワークスペースの詳細を取得する
引数:
- workspace_slug : Bitriseワークスペースのスラッグ

get_workspace_groups

ワークスペース内のグループを取得する
引数:
- workspace_slug : Bitriseワークスペースのスラッグ

create_workspace_group

ワークスペースにグループを作成する
引数:
- workspace_slug : Bitriseワークスペースのスラッグ
- group_name : グループの名前

get_workspace_members

ワークスペースのメンバーを取得する
引数:
- workspace_slug : Bitriseワークスペースのスラッグ

invite_member_to_workspace

ワークスペースにメンバーを招待する
引数:
- workspace_slug : Bitriseワークスペースのスラッグ
- email : ユーザーのメールアドレス

add_member_to_group

グループにメンバーを追加する
引数:
- group_slug : グループのスラッグ
- user_slug : ユーザーのスラッグ

アカウント

me

現在認証されているユーザーアカウントから情報を取得する

リリース管理

MCPツール

create_connected_app

新しいリリース管理接続アプリを Bitrise に追加します。
引数:
- platform : 接続されたアプリのモバイルプラットフォーム (ios/android)。
- store_app_id : 接続されたアプリのアプリストア識別子。
- workspace_slug : Bitrise ワークスペースの識別子。
- id : (オプション) 新しく接続されたアプリの uuidV4 識別子。
- manual_connection : (オプション) 手動接続を示します。
- project_id : (オプション) 関連付ける Bitrise プロジェクトを指定します。
- store_app_name : (オプション) 手動接続用のアプリ名。
- store_credential_id : (オプション) Bitrise に追加された資格情報の選択。

list_connected_apps

ワークスペース内の認証されたアカウントで使用できる Release Management 接続アプリを一覧表示します。
引数:
- workspace_slug : Bitrise ワークスペースの識別子。
- items_per_page : (オプション) ページあたりの接続アプリの最大数。
- page : (オプション) 返されるページ番号。
- platform : (オプション) 特定のモバイルプラットフォームをフィルターします。
- project_id : (オプション) 特定の Bitrise プロジェクトをフィルターします。
- search : (オプション) バンドル ID、パッケージ名、またはアプリのタイトルで検索します。

get_connected_app

認証されたアカウントの Release Management 接続アプリを返します。
引数:
- id : Release Management 接続アプリの識別子。

update_connected_app

接続されたアプリを更新します。
引数:
- connected_app_id : 接続されたアプリの uuidV4 識別子。
- store_app_id : アプリのストア識別子。
- connect_to_store : (オプション) App Store または Google Play に対して有効性を確認します。
- store_credential_id : (オプション) Bitrise に追加された資格情報の選択。

list_installable_artifacts

接続されたアプリのリリース管理インストール可能なアーティファクトを一覧表示します。
引数:
- connected_app_id : Release Management 接続アプリの識別子。
- after_date : (オプション) アーティファクトの作成/アップロード間隔の開始。
- artifact_type : (オプション) 特定のアーティファクトタイプをフィルターします。
- before_date : (オプション) アーティファクトの作成/アップロード間隔の終了。
- branch : (オプション) Bitrise CI ブランチのフィルター。
- distribution_ready : (オプション) 配布準備完了の成果物をフィルターします。
- items_per_page : (オプション) ページあたりのアーティファクトの最大数。
- page : (オプション) 返されるページ番号。
- platform : (オプション) 特定のモバイルプラットフォームをフィルターします。
- search : (オプション) バージョン、ファイル名、またはビルド番号で検索します。
- source : (オプション) インストール可能なアーティファクトのソースをフィルターします。
- store_signed : (オプション) ストアの準備が整ったインストール可能な成果物をフィルターします。
- version : (オプション) 特定のバージョンをフィルタリングします。
- workflow : (オプション) 特定の Bitrise CI ワークフローをフィルターします。

generate_installable_artifact_upload_url

Bitrise にアップロードされるインストール可能なアーティファクトの署名付きアップロード URL を生成します。
引数:
- connected_app_id : Release Management 接続アプリの識別子。
- installable_artifact_id : インストール可能なアーティファクトの uuidv4 識別子。
- file_name : インストール可能なアーティファクトファイルの名前。
- file_size_bytes : インストール可能なアーティファクトファイルのバイトサイズ。
- branch : (オプション) CI ブランチの名前。
- with_public_page : (オプション) パブリックインストールページを有効にします。
- workflow : (オプション) CI ワークフローの名前。

get_installable_artifact_upload_and_processing_status

インストール可能なアーティファクトの処理およびアップロードのステータスを取得します。
引数:
- connected_app_id : Release Management 接続アプリの識別子。
- installable_artifact_id : インストール可能なアーティファクトの uuidv4 識別子。

set_installable_artifact_public_install_page

インストール可能なアーティファクトに対してパブリックインストールページを利用できるかどうかを変更します。
引数:
- connected_app_id : Release Management 接続アプリの識別子。
- installable_artifact_id : インストール可能なアーティファクトの uuidv4 識別子。
- with_public_page : パブリックインストールページを有効/無効にするブールフラグ。

list_build_distribution_versions

テスターが利用できるビルド配布バージョンを一覧表示します。
引数:
- connected_app_id : 接続されたアプリの uuidV4 識別子。
- items_per_page : (オプション) ページあたりのバージョンの最大数。
- page : (オプション) 返されるページ番号。

list_build_distribution_version_test_builds

指定されたビルド配布バージョンのテストビルドのリストを返します。
引数:
- connected_app_id : 接続されたアプリの uuidV4 識別子。
- version : ビルド配布のバージョン。
- items_per_page : (オプション) ページあたりのテストビルドの最大数。
- page : (オプション) 返されるページ番号。

create_tester_group

リリース管理接続アプリのテスターグループを作成します。
引数:
- connected_app_id : 接続されたアプリの uuidV4 識別子。
- name : 新しいテスターグループの名前。
- auto_notify : (オプション) グループの自動通知を示します。

notify_tester_group

新しいテストビルドについてテスターグループに通知します。
引数:
- connected_app_id : 接続されたアプリの uuidV4 識別子。
- id : テスターグループの uuidV4 識別子。
- test_build_id : テストビルドの一意の識別子。

add_testers_to_tester_group

接続されたアプリのテスターグループにテスターを追加します。
引数:
- connected_app_id : 接続されたアプリの uuidV4 識別子。
- id : テスターグループの uuidV4 識別子。
- user_slugs : 追加するスラッグによって識別されるユーザーのリスト。

update_tester_group

指定されたテスターグループの設定を更新します。
引数:
- connected_app_id : 接続されたアプリの uuidV4 識別子。
- id : テスターグループの uuidV4 識別子。
- auto_notify : (オプション) 自動電子メール通知の設定。
- name : (オプション) テスターグループの新しい名前。

list_tester_groups

特定の接続されたアプリに関連するテスターグループのリストを返します。
引数:
- connected_app_id : 接続されたアプリの uuidV4 識別子。
- items_per_page : (オプション) ページあたりのテスターグループの最大数。
- page : (オプション) 返されるページ番号。

get_tester_group

選択したテスターグループの詳細を返します。
引数:
- connected_app_id : 接続されたアプリの uuidV4 識別子。
- id : テスターグループの uuidV4 識別子。

get_potential_testers

特定のテスターグループに追加できる潜在的なテスターのリストを取得します。
引数:
- connected_app_id : 接続されたアプリの uuidV4 識別子。
- id : テスターグループの uuidV4 識別子。
- items_per_page : (オプション) ページあたりの潜在的なテスターの最大数。
- page : (オプション) 返されるページ番号。
- search : (オプション) メールまたはユーザー名でテスターを検索します。

API グループ

Bitrise MCPサーバーは、ツールをAPIグループに分類し、コマンドライン引数で有効化または無効化できます。以下の表は、各ツールがどのAPIグループに属しているかを示しています。

道具	アプリ	ビルド	ワークスペース	ウェブフック	ビルド成果物	グループの役割	キャッシュアイテム	パイプライン	アカウント	読み取り専用	リリース管理
リストアプリ	✅									✅
登録アプリ	✅
ビットライズアプリの終了	✅
ゲットアプリ	✅									✅
削除アプリ	✅
アップデートアプリ	✅
ビットライズのYMLを取得する	✅									✅
アップデート_bitrise_yml	✅
リストブランチ	✅									✅
SSHキー登録	✅
ウェブフックを登録する	✅
リストビルド		✅								✅
トリガー_bitrise_build		✅
ゲットビルド		✅								✅
ビルドを中止する		✅
get_build_log		✅								✅
get_build_bitrise_yml		✅								✅
リストビルドワークフロー		✅								✅
リストアーティファクト					✅					✅
get_artifact					✅					✅
アーティファクトの削除					✅
更新アーティファクト					✅
送信ウェブフックのリスト				✅						✅
送信ウェブフックの削除				✅
送信ウェブフックの更新				✅
送信ウェブフックを作成する				✅
リストキャッシュアイテム							✅			✅
すべてのキャッシュアイテムを削除する							✅
キャッシュアイテムの削除							✅
get_cache_item_download_url							✅			✅
リストパイプライン								✅		✅
get_pipeline								✅		✅
abort_pipeline								✅
再構築パイプライン								✅
グループロールのリスト						✅				✅
グループロールの置き換え						✅
ワークスペースの一覧			✅							✅
ワークスペースを取得する			✅							✅
ワークスペースグループを取得する			✅							✅
ワークスペースグループの作成			✅
ワークスペースメンバーを取得する			✅							✅
ワークスペースにメンバーを招待する			✅
グループにメンバーを追加する			✅
自分									✅	✅
接続アプリの作成											✅
接続されたアプリの一覧											✅
接続されたアプリを取得する											✅
接続されたアプリの更新											✅
インストール可能なアーティファクトの一覧											✅
インストール可能なアーティファクトのアップロード URL を生成する											✅
インストール可能なアーティファクトのアップロードと処理のステータスを取得する											✅
インストール可能なアーティファクトの公開インストールページを設定する											✅
ビルド配布バージョンのリスト											✅
list_build_distribution_version_test_builds											✅
テスターグループを作成する											✅
テスターグループに通知											✅
テスターをテスターグループに追加											✅
テスターグループの更新											✅
テスターグループのリスト											✅
テスターグループを取得する											✅
潜在的なテスターを獲得する											✅

デフォルトでは、すべてのAPIグループが有効になっています。有効にするグループを指定するには--enabled-api-groupsコマンドライン引数にグループ名をカンマ区切りで指定します。

Bitrise MCP Server