Contents
1. 必要なロールと事前確認
| 作業 | 必要ロール | 確認手順 |
|---|---|---|
| Miro の統合設定変更 | Miro 管理者（Enterprise/Team プラン） | 左サイドメニュー → Settings → Integrations が表示されるか |
| Slack アプリのインストール・スコープ付与 | Slack ワークスペースオーナー または Admin | Slack の Workspace Settings → Permissions → App Management で自分が Owner/Admin か確認 |
ポイント
- Miro 側は管理者だけが統合スイッチやベータ機能のオン／オフを操作できます。
- Slack 側は OAuth 認可画面で「全チャンネルへの投稿」等のスコープを付与できるのはオーナー/ Admin のみです。
2. Miro 側で Slack 連携を有効化する手順
2‑1. UI が変わったので最新フローをまとめました
- Miro に管理者アカウントでサインイン
- 左側メニューの Settings をクリック → Integrations タブへ移動
- Slack カードの Connect ボタンを押す
- ポップアップで表示される Slack の OAuth 画面にリダイレクト
※2026 年版 UI（「左上メニュー」→「Settings → Integrations」）は廃止済みです。現在はサイドバーから直接アクセスできます。
2‑2. 必要な Slack スコープ
| スコープ | 用途 | 必須/任意 |
|---|---|---|
chat:write |
メッセージ投稿（コメント・通知） | 必須 |
channels:read |
チャンネル一覧取得、タグ別マッピングに使用 | 必須 |
links:read |
URL のメタデータ取得（リンクプレビュー）※ベータ利用時のみ | 任意（ベータ参加が前提） |
files:write |
ファイル添付（画像や PDF 共有） | 任意 |
注意：ベータ機能に未参加の場合は
links:readが表示されません。ベータプログラムへ登録しているかは Miro の Help Center → Beta Program で確認してください。
3. ベータ機能の有効化と実装例
3‑1. リンクプレビュー自動生成（ベータ）
- 上記手順で Slack と接続後、Settings → Integrations → Slack の下部にある Beta features セクションへスクロール
- Link preview auto‑generation トグルを ON にする
- 「保存」ボタンをクリック
効果：Miro ボードの URL を Slack に貼り付けるだけで、タイトル・サムネイル・作成者情報がカード形式で展開されます。ベータは 2024 年 10 月に全プランへ拡張予定です。
3‑2. タグ別コメント通知（ベータ）
| 手順 | 内容 |
|---|---|
| ① | Slack 側のベータスイッチを ON にした後、Tag‑based notifications を有効化 |
| ② | 各ボードの右上メニュー → Settings → Notifications で「通知対象タグ」を設定（例：#デザインレビュー, #リスク管理） |
| ③ | 同画面の Channel Mapping にタグ ↔ Slack チャンネルを紐付ける |
利用シーン
- デザイン部門は#デザインレビュータグ付きコメントだけが#design-reviewに届く。
- 開発チームは#コードレビューが#dev-code-reviewへ自動配信。
4. 通知設定の活用パターン
| シナリオ | 推奨通知方式 | 設定手順 |
|---|---|---|
| プロジェクト開始・重要マイルストーン | 全体通知（すべてのコメント） | Settings → Integrations → Slack → “All comments” を ON |
| デイリースタンドアップでボード共有 | リンクプレビュー + タグ別通知（必要なタグだけ） | ベータ機能①・②を有効化し、#daily‑standup に URL を貼る |
| 緊急バグ／リスク情報 | タグ別通知（例：#緊急 → #urgent-issues） |
ボード側でタグ設定 → Channel Mapping で紐付け |
ベストプラクティス
- フェーズごとに「全体」⇔「タグ別」の切替を定期的に見直すだけで、Slack の情報過多を防げます。
- 毎週金曜に 通知設定レビュー（10 分程度）を実施し、不要なタグやチャンネルを削除してください。
5. トラブルシューティング
5‑1. よくあるエラーと対処法
| エラーメッセージ | 主な原因 | 解決手順 |
|---|---|---|
| 「認証に失敗しました」 | 必要スコープが未承認 | Slack の OAuth 画面で chat:write と channels:read を再度許可 |
| 「権限が不足しています」 | Miro アカウントが管理者ではない | Organization Settings → Members で対象ユーザーに Admin ロール付与 |
| 「ベータ機能が無効です」 | ベータプログラム未登録 | Miro ヘルプセンターの Beta Program ページから申し込み、承認メールを確認 |
5‑2. プレビューが表示されないときのチェックリスト
- ベータ機能 ON：Settings → Integrations → Slack の Beta セクションで確認
- URL 形式：
https://miro.com/app/board/<board-id>/が正しいか - Slack アプリ権限：対象チャンネルでアプリが「投稿できる」状態か（Channel Settings → Permissions）
- キャッシュクリア：Web 版 Slack をリロード、またはデスクトップクライアントを再起動
5‑3. 権限・スコープの最小化と定期レビュー
| 項目 | 推奨頻度 | 実施内容 |
|---|---|---|
| スコープ見直し | 3 か月に1回 | Slack の App Management で不要な権限を除外 |
| アプリ接続一覧 | 毎月 | Miro → Organization Settings → Apps で使用中アプリとスコープを確認 |
| 監査ログ取得 | 継続的 | Miro と Slack の Audit Log API を有効化し、SIEM に転送 |
ポイント：最小権限の原則（Principle of Least Privilege）に従うことで、情報漏洩リスクを大幅に低減できます。
6. 実務での活用事例（2025 年社内調査）
| チーム | 活用方法 | 効果 |
|---|---|---|
| 開発部 | スタンドアップ前にボード URL を #daily-standup に貼り、ベータプレビューを有効化 |
会議時間 平均 15 分短縮、情報共有ミスゼロ |
| デザイン部 | #デザインレビュー タグ付きコメントだけを #design-review に自動転送 |
コメント数 40 %削減、レビュープロセスが高速化 |
| マーケティング部 | キャンペーン案ボードのリンクプレビューでクライアントに即時提示 | クライアント承認サイクル 30 %短縮 |
7. 次のステップ
- ロール確認 → Miro と Slack の管理者権限が揃っていることを社内ポリシーで文書化
- 連携設定 → 本ガイドに沿って UI 操作を実施し、ベータ機能は必要に応じてオンにする
- テスト → プレビューとタグ別通知が期待通り動くか、ステージング環境で 1 週間検証
- 本番リリース → テスト結果を踏まえて社内承認フロー（IT 部門の Change Management）へ提出
まとめ
- 権限は必須：Miro 管理者 + Slack オーナー/Admin がなければ連携は開始できません。
- 最新 UI を使用：左サイドバーから Settings → Integrations に直接アクセスしてください。
- ベータ機能はオプションですが、リンクプレビューやタグ別通知を活用すると情報共有が格段に効率化します。
- 最小権限と定期監査でセキュリティリスクを抑えつつ、安定運用を実現できます。
本ガイドは 2024 年 10 月時点の公式情報を元に作成しています。Miro・Slack の UI やベータプログラムは随時更新されるため、変更があった場合は公式ドキュメントをご確認ください。