Bitrise MCP Server

Bitrise MCP サーバー

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

特徴

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

設定

環境設定

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

環境設定の例

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

Bitrise APIトークン

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

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

Claude Desktopで使用する

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

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

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

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

VSコードでの使用

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

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

設定を保存します。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 グループを個別に使用することをお勧めします。

構成例:

ツール

アプリ

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

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

11. register_webhook

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

ビルド

12. list_builds

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

13. trigger_bitrise_build

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

14. get_build

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

15. abort_build

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

16. get_build_log

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

17. get_build_bitrise_yml

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

18. list_build_workflows

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

ビルドアーティファクト

19. list_artifacts

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

20. get_artifact

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

21. delete_artifact

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

22. update_artifact

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

ウェブフック

23. list_outgoing_webhooks

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

24. delete_outgoing_webhook

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

25. update_outgoing_webhook

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

26. create_outgoing_webhook

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

キャッシュアイテム

27. list_cache_items

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

28. delete_all_cache_items

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

29. delete_cache_item

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

30. get_cache_item_download_url

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

パイプライン

31. list_pipelines

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

32. get_pipeline

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

33. abort_pipeline

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

34. rebuild_pipeline

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

グループの役割

35. list_group_roles

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

36. replace_group_roles

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

ワークスペース

37. list_workspaces

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

38. get_workspace

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

39. get_workspace_groups

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

40. create_workspace_group

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

41. get_workspace_members

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

42. invite_member_to_workspace

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

43. add_member_to_group

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

アカウント

44. me

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

リリース管理

MCPツール

45. 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 に追加された資格情報の選択。

46. list_connected_apps

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

47. get_connected_app

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

48. update_connected_app

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

49. 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 ワークフローをフィルターします。

50. 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 ワークフローの名前。

51. get_installable_artifact_upload_and_processing_status

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

52. set_installable_artifact_public_install_page

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

53. list_build_distribution_versions

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

54. list_build_distribution_version_test_builds

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

55. create_tester_group

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

56. notify_tester_group

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

57. add_testers_to_tester_group

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

58. update_tester_group

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

59. list_tester_groups

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

60. get_tester_group

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

61. get_potential_testers

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

API グループ

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

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