Contents
Trello と Bitbucket の公式連携概要と導入効果
Trello と Bitbucket を公式に連携させることで、コードの変更情報がタスクボードに自動で反映され、開発フロー全体を可視化できます。リポジトリ管理者は Boards → Connect to Trello の操作だけで基本的な同期設定が完了するため、導入コストが低く抑えられます。本稿では、公式連携の手順と、さらに細かな自動化を実現したい場合に有効なサードパーティツール（Zapier／Make）の使い分け方を解説します。
1. 公式ネイティブ連携の特徴
公式連携は Atlassian が提供する標準機能であり、追加のミドルウェアやコードを書かずに以下のような効果が得られます。
- 双方向同期：Bitbucket のプルリクエストやコミットが自動的に Trello カードへリンク付与され、カードから該当コードへすぐにアクセス可能です。
- Atlassian エコシステムとの統合：同一 Atlassian アカウントで Jira・Confluence も併用でき、権限管理が一本化されます。
- 最小権限での運用：リポジトリ読み取り＋ボード書き込みだけで動作し、不要な権限を付与しないセキュリティ設計が可能です。
公式連携だけでも基本的な情報共有は実現できますが、通知内容やカードのレイアウトなど細部にわたるカスタマイズが必要な場合は、Zapier や Make といったノーコード自動化ツールを併用すると便利です。
2. Bitbucket の「Connect to Trello」設定手順（公式 UI）
本セクションでは、2024 年時点の Bitbucket Cloud の UI を前提に、公式連携を有効化する具体的な流れを説明します。画面構成は随時アップデートされる可能性があるため、「Boards」メニューが見当たらない場合は「Integrations」や「Apps」セクションをご確認ください。
2.1 「Connect to Trello」までの操作概要
Bitbucket のリポジトリ管理画面から Boards → Connect to Trello を選択し、連携ウィンドウを開く手順です。
- Bitbucket Cloud に管理者権限でログインし、対象リポジトリのページへ移動します。
- 左サイドバーに「Boards」が表示されていればクリックし、無い場合は「Integrations」→「Apps」から Trello を検索して選択します。
- 表示されたパネル内の Connect to Trello ボタンを押すと、連携設定ウィンドウが表示されます。
2.2 既存ボードの紐付けと新規作成
| 操作 | 手順 | 補足 |
|---|---|---|
| 既存ボードの追加 | ドロップダウンから所有している Trello ボードを選択し、Add をクリック | 複数ボードに同時紐付けは不可です。必要に応じて別リポジトリで繰り返してください |
| 新規ボード作成 | 「Create a new board」リンクをクリック → ボード名と Workspace（チーム）を入力して Create | 作成したボードは自動的に当該リポジトリへ紐付けられます |
設定が完了すると、Bitbucket のプルリクエストやコミットが自動的にカードとして Trello に表示されます。詳細は Atlassian 公式ガイド（Integrate Trello boards in Bitbucket）をご参照ください。
3. サードパーティツールで拡張する自動化
公式連携だけでは実現できない「細かな通知」や「カスタムフォーマット」の要件は、Zapier と Make（旧 Integromat）のいずれかを利用して補完できます。本節では 重複しないように機能別で比較 しながら、代表的なユースケースと設定手順を示します。
3.1 Zapier：シンプルなトリガ‑アクション構成
Zapier は「Trigger → Action」という直感的なフローが特徴です。以下は コミット情報を Trello カードとして自動作成 する基本パターンです。
手順概要（H3 の冒頭文）
Bitbucket の新規コミットを検知し、Trello の指定リストにカードを生成します。設定は数画面で完了し、テスト実行で即座に動作確認が可能です。
- Zap 作成：Zapier にログイン後、左メニューの Make a Zap をクリック。
- Trigger 設定：アプリを Bitbucket, イベントを New Commit に選択し、対象リポジトリを指定します。
- Action 設定：次に Trello → Create Card を追加し、以下の項目をマッピングします。
| Trello フィールド | 取得元（Bitbucket） |
|---|---|
| Board | 手動で選択（例: 開発タスク） |
| List | 任意のリスト（例: In Progress） |
| Card Name | {{commit.message}} |
| Description | {{commit.author}} - {{commit.hash}} |
- テスト実行：Test & Review でサンプルコミットを送信し、カードが正しく作成されることを確認します。
参考: Qiita 記事「Bitbucket と Trello を Zapier で連携する方法」
3.2 Make：Webhook ベースの柔軟なシナリオ
Make は Webhook や ルーティング が得意で、複数イベントをまとめて処理したいケースに向いています。ここでは プルリクエスト作成・マージ時にカードを生成／ステータス更新 するシナリオ例を示します。
手順概要（H3 の冒頭文）
Bitbucket のプルリクエストイベントを Webhook 経由で受信し、Trello カードの作成と同時にコメントやラベル付与まで自動化します。
- Make にシナリオ作成：ダッシュボードから Create a new scenario を選択。
- Webhook モジュール追加：
Custom webhookを配置し、名前（例:PR_to_Trello）を入力して生成された URL をコピーします。 - Bitbucket 側の設定：リポジトリ > Webhooks → Add webhook で先ほどの URL を貼り付け、イベントは Pull request created と Pull request merged を選択。
- Trello モジュール配置：
Create a Card（またはUpdate a Card）を追加し、以下のマッピング例に従ってフィールドを埋めます。
| Trello フィールド | 取得元（Bitbucket Webhook ペイロード） |
|---|---|
| Board | {{payload.repository.full_name}} （事前にボード名と紐付けておく） |
| List | To Do（作成時） / Done（マージ時） |
| Name | PR #{{payload.pullrequest.id}} – {{payload.pullrequest.title}} |
| Description | {{payload.pullrequest.description}}\n\nAuthor: {{payload.actor.display_name}} |
| Labels | PR, {{payload.pullrequest.state}} |
- コメント追加（任意）：
Add Comment to Cardモジュールで PR の URL をカードに記載すると、チームメンバーがすぐに参照できます。
参考: Zenn 記事「Make で Bitbucket と Trello を連携する」
3.3 Zapier と Make の選び方ガイド（表形式）
| 項目 | Zapier が適しているケース | Make が適しているケース |
|---|---|---|
| 設定の簡易さ | ワンステップのトリガ‑アクションだけで完結する場合 | 複数イベント・条件分岐が必要な場合 |
| カスタムロジック | 限定的（フィルターやフォーマットは標準機能） | スクリプトや HTTP リクエストを自由に組み込める |
| 料金体系 | 無料プランでも月数十件のタスクが実行可能 | 無料枠はシナリオ実行回数が制限されるが、複雑なフローはコスト効率が高い |
| 運用管理 | UI が直感的で初心者向け | シナリオ単位のバージョン管理がしやすく、チーム共有に有利 |
4. 運用ベストプラクティスとトラブルシューティング
4.1 認証・権限設定の基本方針（導入文）
安全かつ安定した連携を維持するため、システム通知専用アカウントを作成し、最小権限だけを付与します。
- Bitbucket：
Repository read権限のみ。 - Trello：対象ボードに対して
Write（カード作成・更新）権限。 - 必要に応じて OAuth 2.0 アプリケーション を利用し、アクセストークンの有効期限管理を行います（トークンローテーションは組織ポリシーに従って実施）。
4.2 主なエラーと対処法チェックリスト
| 項目 | 想定されるエラー | 推奨対策 |
|---|---|---|
| 認証失敗 (401) | API トークンや OAuth アクセスが無効化された | アカウントで新しいトークンを取得し、Zapier/Make の接続情報を更新 |
| 権限不足 | 「アクセスが拒否されました」メッセージ | 対象リポジトリ／ボードの権限設定を確認し、必要なロールを付与 |
| Webhook 未受信 | イベントが Trello に反映されない | Bitbucket の Webhook URL が最新か、HTTP ステータス 2xx が返っているか検証 |
| フィールドマッピングエラー (400) | カード作成時に必須項目が抜けている | Zapier/Make のフィールド設定を再確認し、プレースホルダー変数が正しく展開されているかテスト |
4.3 実務で役立つ活用例（導入文）
以下は実際のプロジェクトで効果的に使われているパターンです。
- コミットごとのコメント自動追加：Zapier の
New Commit → Add Comment to Cardを組み合わせ、変更内容をカードに追記することでレビュー履歴が一元化。 - PR マージ時のステータス遷移：Make のシナリオで PR がマージされたら対象カードを
Doneリストへ自動移動し、スプリントの進捗がリアルタイムに可視化。 - ブランチ名からスプリントタグ付与：Trello カスタムフィールド「Sprint」にブランチプレフィックス（例:
sprint-12）を自動設定し、開発フェーズとタスクが紐づくようにする。
これらのベストプラクティスを導入すれば、タスク管理とコードレビューのフローがシームレスになり、チーム全体の生産性向上につながります。
5. 参考リンク（統一形式）
- Atlassian Support – Integrate Trello boards in Bitbucket
https://support.atlassian.com/bitbucket-cloud/docs/integrate-trello-boards-in-bitbucket/ - Qiita – Bitbucket と Trello を Zapier で連携する方法
https://qiita.com/Sugima/items/184b4acfc9fca2594d30 - Zenn – Make（旧 Integromat）で Bitbucket と Trello を連携
https://zenn.dev/clap_n_whistle/articles/b256469ac39b9d - Zapier Documentation – Bitbucket Integration
https://zapier.com/apps/bitbucket/integrations - Make Documentation – Trello: Create a Card
https://www.make.com/en/help/app/trello/create-a-card
以上が、公式連携からサードパーティツール活用までの包括的な手順と運用ポイントです。各組織のポリシーや UI の変化に応じて適宜調整しながら、開発フローの自動化を進めてください。