Contents
Jira と Miro 連携 方法：実務で即活用可能な導入ガイド
Jira と Miro の連携は、アジャイル開発やプロジェクト管理において業務効率を飛躍的に向上させる手法です。ただし、設定ミスや権限不足により失敗するケースも少なくありません。本記事では、OAuth 認証・公式アドオン導入・双方向同期のポイントに着目し、実務で即活用可能な手順を丁寧に解説します。
連携前提条件：必要な権限と環境
Miro と Jira の連携を成功させるには、事前にいくつかの準備が必要です。特にアカウント権限や組織構成が適切でないと、後述する設定手順が進まない場合があります。
アカウント権限の確認
Jira や Miro での連携に必要な権限は以下の通りです。
- Jira: プロジェクト管理者（Project Administrator）またはシステム管理者（System Administrator）
- Miro: 組織管理者（Organization Admin）
注意点：企業アカウント以外では、OAuth 認証やアドオン導入ができないため、利用前に確認してください。
組織構成の確認
- Jira: 連携したいプロジェクトに対して設定権限があること
- Miro: ボードを共有できるユーザー範囲（Organization / Team）を確認し、必要なアクセス権を付与すること
公式アドオン導入手順：Marketplaceからインストール
Jira と Miro の連携には「Miro for Jira」という公式アドオンを導入します。以下が具体的なインストール手順です。
-
Atlassian Marketplaceにアクセス
https://marketplace.atlassian.com を開き、検索バーに「Miro for Jira」を入力して検索します。 -
アドオンを選択・インストール
「Miro for Jira」のページで「Get it now」ボタンをクリックし、Jira サーバーまたはクラウドへのインストールを開始します。 -
インストール完了後の設定
アドオンが正しくインストールされたら、Jira の「Manage apps」（管理画面）で確認し、「Miro for Jira」を有効化します。
| ステップ | 内容 | 注意点 |
|---|---|---|
| 1 | Marketplace 検索 | ブラウザのJavaScriptが無効な場合、検索不可 |
| 2 | アドオンインストール | クラウド環境では「Cloud」タブを確認 |
| 3 | 有効化設定 | Jira のアカウント権限で操作制限が発生する場合あり |
OAuth認証設定：セキュリティと操作のポイント
OAuth 認証は、Jira サーバーと Miro ボードを安全に連携させるために不可欠です。特に「クライアントID/シークレットの管理」と「権限スコープ」について慎重に対応する必要があります。
アプリケーションの登録手順
-
Miro サービスでアプリケーションを登録
https://miro.com/integrations/ を開き、「Developers」タブからアプリ作成を行います。 -
クライアントIDとシークレットの取得
登録時に発行される「Client ID」と「Client Secret」を控え、Jira での設定に使用します。
権限スコープの選択基準
OAuth 認証時に「権限スコープ」を選択する必要があります。主な選択肢とその役割は以下の通りです：
| スコープ | 概要 | 必須か |
|---|---|---|
read:boards |
Miro ボードの読み取り | 〇（必須） |
write:tasks |
Jira タスクの作成・更新 | 〇（必須） |
read:users |
ユーザー情報の参照 | ×（不要） |
重要：Client Secret を他のユーザーに共有しないこと。漏洩すると、認証トークンが不正利用されるリスクがあります。
MiroボードとJira課題の同期方法
Miro ボード上で行うカード操作を、Jira に自動的に反映させる手順は以下の通りです。
カード操作によるタスク作成
-
Miro ボードでカードを作成
「＋」ボタンからカードを作成し、「課題内容」「期限」「優先度」を入力します。 -
Jira に同期する
Miro の「Integrations」メニューから Jira を選択し、同期設定で「ドラッグ＆ドロップによる自動作成」を有効化します。
同期の手動/自動切り替え
- 手動同期: カード右上の「Sync to Jira」アイコンクリック
- 自動同期: Miro ボードの「Settings」→「Integrations」で設定変更可能
JiraにMiroボードを埋め込む方法
Jira の UI 上で Miro ボードを直接確認するには、「埋め込みコンポーネント」の設定が必要です。以下が手順です。
埋め込みコードの取得と配置
-
Miro から埋め込み用コード取得
https://miro.com/integrations/embed/ にアクセスし、「Embed」タブでiframeコードを生成します。 -
Jira ウィジェットに追加
Jira の「Create Dashboard」→「Add gadget」から「Custom HTML」を選択し、取得した iframe コードを貼り付けます。
| 設定項目 | 内容 | 必須か |
|---|---|---|
| 表示範囲 | width="100%" height="500px" の設定推奨 |
〇（必須） |
| 更新頻度 | Jira ウィジェットで「Refresh interval」を30秒などに設定 | △（推奨） |
注意点：埋め込みはプロジェクトレベルで設定する必要があるため、チームごとに個別に設定してください。
双方向同期時のデータ整合性対策
Jira と Miro の双方向同期では、データの不一致が発生するリスクがあります。これを防ぐために次の対策を講じましょう。
リアルタイム更新と履歴管理
- 同期間隔調整: 「リアルタイム更新」または「5分毎」を選択
- 変更履歴記録: Jira に「Change Log」というフィールドを追加し、更新内容を記録
衝突解決手順
- 優先度による自動処理: Miro 側で「Jira の変更が上書きされる」設定
- バージョン管理: 変更履歴を Miro に保存し、同期時にバージョン番号比較
例: 同じ課題に対して Miro と Jira が同時に編集された場合、「Jira の最新版」と「Miro の最新版」の比較により、優先度が高い方を反映します。
参考情報と導入時の確認事項
- 認証設定では クライアントID/シークレット を厳重に管理
- 同期には 手動・自動切り替え機能 を活用
- データ整合性には バージョン管理と優先度付け が有効
実践的な導入により、Jira と Miro の連携はチームの業務効率を飛躍的に向上させます。公式ドキュメントと併せてご活用ください。
参考リンク
- Atlassian Marketplace: https://marketplace.atlassian.com
- Miro 開発者向けページ: https://miro.com/integrations/
- Jira ドキュメント: https://confluence.atlassian.com/jira-cloud