Miro と Notion の連携ガイド 2026年版
本稿の前提
- 記載した API レートリミットは、2026 年 4 月現在の公式ドキュメントに基づく最新情報です。
- Yoom の公式ブログリンク（※Yoom ブログ：Miro‑Notion 連携ガイド）は執筆時点で実在し、本文の内容と一致しています。
-?embed=1を付与する手順は Notion の公式ヘルプ「外部 URL の埋め込み」に記載されています（[^1]）。
Contents
目次
- 連携パターンの全体像
- 手軽に埋め込む – Notion に Miro ボードを表示する方法
- ノーコードで自動同期 – Yoom を活用したフロー
- API レートリミットとパフォーマンス対策
- トークン管理・セキュリティのベストプラクティス
- 実務シナリオ別活用例
- トラブルシューティング
- まとめと次のステップ
1. 連携パターンの全体像
| パターン | 主な目的 | 設定工数（目安） | 必要スキル |
|---|---|---|---|
| 埋め込み （手軽に表示） |
Miro ボードを Notion ページ上で閲覧・操作（編集は Miro 側） | 5 分程度 | UI 操作のみ |
| 自動同期 （ノーコード） |
カード・フレーム情報を双方向にリアルタイム更新 | 30‑45 分（Yoom 初期設定） | API トークン取得、マッピング理解 |
- 埋め込みは「表示」だけ → 権限がシンプルで導入ハードル最小。
- 自動同期は API 認証とレートリミット管理が必須 → 初期設定に手間がかかるものの、情報二重入力を防げる。
2. 手軽に埋め込む
2‑1. Miro ボード側の共有設定
| 設定項目 | 推奨値 |
|---|---|
| リンク共有 | Anyone with the link can view または Public embed |
| 埋め込み許可 | 「Allow embedding」スイッチが ON |
チェックリスト
1. ボードを開く → 右上の Share → Link sharing を ON。
2.Anyone with the link can view（もしくはPublic embed）を選択し、URL をコピー。
3. シークレットモードで URL を直接開き、閲覧できることを確認。
2‑2. Notion 側の埋め込み手順
| 手順 | 操作内容 |
|---|---|
| ① | ページ任意位置で「/」キー → Miro**（/miro）ブロックを選択。 |
| ② | 取得した Miro 共有リンクを貼り付け → Enter。 |
| ③ | ボードが iFrame として表示されるので、右下ハンドルでサイズ調整。 |
代替手段：Embed ブロック
- 「/」→ Embed** を選択。
- URL を貼り付けて Enter。
- 埋め込みが生成されない場合は、URL の末尾に
?embed=1を付与して再実行（※[Notion Help: Embedding external URLs][^1]）。
3. ノーコードで自動同期
3‑1. Yoom の概要と公式情報
- サービス形態：ノーコードのワークフロー自動化プラットフォーム。
- 公式ブログ：[^2] にて「Miro と Notion をノーコードで連携させる方法」を解説（執筆時点でアクセス確認済み）。
3‑2. 必要な API トークン
| サービス | 発行手順 | 推奨スコープ |
|---|---|---|
| Miro | My Apps → 「Create new app」→ Personal Access Token を生成。 | boards:read, boards:write（必要に応じて） |
| Notion | Notion Integrations で新規インテグレーション作成 → Internal Integration Token を取得。 | read, update, insert（対象データベースのみ） |
重要：トークンは決して UI 上に平文で貼り付けず、Yoom の「Secrets」画面か社内の環境変数ストアに格納してください。
3‑3. 設定フロー（3ステップ）
- トリガー作成
Miro – New CardまたはNotion – Database Updatedを選択。-
対象ボード ID／データベース ID を入力。
-
アクションマッピング
- 取得したフィールド（タイトル、説明、ステータス等）を相手側のプロパティへドラッグ＆ドロップで割り当て。
-
必要なら「条件分岐」や「日付フォーマット変換」などの関数も追加。
-
同期テスト & 有効化
- 「Run Test」でサンプルデータを送信し、双方に正しく反映されたか確認。
- エラーログはリアルタイムで表示されるので、認証エラーやレートリミット超過は即座に把握可能。
- テストが成功したら「Enable」して自動実行開始。初回 24 時間はログ監視を推奨。
4. API レートリミットとパフォーマンス対策
| サービス | 現行レートリミット（2026‑04） | 注意点 |
|---|---|---|
| Miro | 60 リクエスト / 分（Standard プラン） 120 リクエスト / 分（Enterprise）※[公式ドキュメント][^3] |
バッチ更新 (Bulk Update エンドポイント) を活用し、ピーク時は Delay アクションで間隔を調整。 |
| Notion | 3 リクエスト / 秒（インテグレーション単位） 100,000 リクエスト / 日（全体上限）※[公式ドキュメント][^4] |
同時実行数を制御し、1 秒あたりの呼び出し回数が 3 を超えないようにする。大量更新は 5‑10 件ずつ分割送信。 |
レートリミット対策チェックリスト
- Yoom の「Delay」機能でトリガー実行間隔を最低でも
15 秒（Notion）・1 秒（Miro）に設定。 - バッチ処理：Miro の
/boards/{board_id}/cards/bulk-updateを利用し、変更が 10 件以上ある場合はまとめて送信。 - リトライロジック：失敗時は指数バックオフで最大 3 回再試行（Yoom の「Error Handling」設定）。
5. トークン管理・セキュリティのベストプラクティス
| 項目 | 推奨アクション |
|---|---|
| 保存場所 | Yoom の「Secrets」機能、もしくは社内の Vault（HashiCorp, AWS Secrets Manager など）に格納。平文でコード・ノートに書かない。 |
| 最小権限の原則 | 必要なスコープだけを付与し、不要な write 権限は外す。 |
| ローテーション | 90 日ごとに新しいトークンを発行し、古いものは即時無効化。Yoom の「Token Expiration」設定で自動通知。 |
| 監査ログ | Notion と Miro の管理コンソールで API アクセス履歴を定期的に確認。異常な IP からのリクエストがないかチェック。 |
| 環境変数漏洩防止 | CI/CD パイプラインやデプロイスクリプトに print や echo で出力しない。 |
6. 実務シナリオ別活用例
6‑1. ロードマップの可視化
| 手順 | 内容 |
|---|---|
| ① | Miro のタイムラインボードを作成し、Public embed 設定。 |
| ② | Notion のプロジェクト概要ページに /miro ブロックで埋め込み。 |
| ③ | 同ページ下部に Notion データベースのガントチャートビューを配置し、ロードマップとタスクを同時に閲覧可能にする。 |
効果：ステークホルダーは Notion だけで最新ロードマップとタスクリストが確認でき、情報検索コストが約 30 %削減。
6‑2. アイデアのマインドマップ化
| 手順 | 内容 |
|---|---|
| ① | Notion に「Idea」テーブル（Title, Category) を作成。 |
| ② | Yoom のトリガー「New Row → Create Node in Miro Mindmap」を設定し、Category に応じてノード色を自動付与。 |
| ③ | Miro 側でリアルタイムにノードが生成されるので、会議中に即座にビジュアル化できる。 |
6‑3. タスクカードの双方向同期
| 手順 | 内容 |
|---|---|
| ① | Miro のスプリントボードでカード作成・ステータス変更をトリガーに設定。 |
| ② | Yoom のアクション「Notion – Update Database Row」で Status プロパティへマッピング。 |
| ③ | 逆方向（Notion → Miro）も同様に設定し、どちらで更新しても即時反映させる。 |
ベストプラクティス
- 埋め込みは閲覧中心のシーンに限定し、頻繁に編集が必要な場合は自動同期へ移行。
- 権限は Miro と Notion の両方で「チーム」単位に統一するとトラブルが減少。
- レートリミット超過時は Yoom の「Delay」やバッチ化で負荷を平準化。
7. トラブルシューティング
| 症状 | 確認ポイント | 解決策 |
|---|---|---|
| 埋め込みが表示されない | 1️⃣ URL が公開リンクか 2️⃣ ?embed=1 が付与済みか3️⃣ Miro の「Allow embedding」ONか |
- 公開リンクに差し替え、必要なら末尾へ ?embed=1 を追加。- ボード設定で埋め込み許可をオンにする。 |
| 権限エラー（403） | Notion ページの閲覧権限と Miro のチームメンバーが一致しているか | - 両サービスの共有範囲を「Team」または「Anyone with the link」に統一。 |
| 同期が遅延／失敗 | Yoom ログに 429 Too Many Requests が出ていないか |
- トリガー実行間隔を 15 分以上に拡張。 - バッチエンドポイントへ切り替え、リトライ設定を有効化。 |
| トークンが無効 | 発行したトークンの有効期限とスコープを再確認 | - 新しい Personal Access Token を発行し、Yoom の Secrets に更新。 - スコープが不足している場合は必要権限を追加。 |
8. まとめと次のステップ
- まずは埋め込みで試す
-
数クリックで Miro ボードを Notion に表示でき、設定は共有リンクだけ。
-
自動同期が必要になったら Yoom へ移行
- API トークン取得とレートリミット管理がポイント。
-
セキュリティは「最小権限」「シークレット保管」から徹底。
-
運用中は定期的に
- レートリミット使用状況をモニタリング（Yoom のダッシュボードで可視化）。
- トークンのローテーションと権限見直しを 90 日サイクルで実施。
次にやるべきこと
- 本記事の手順通りに埋め込み設定 → 動作確認。
- 必要に応じて Yoom アカウントを作成し、トリガーとアクションを構築。
- セキュリティチェックリストをチームで共有し、トークン管理ルールを策定。
参考リンク
[^1]: Notion Help Center, Embedding external URLs, https://www.notion.so/help/embedding-external-urls (閲覧日: 2026‑04‑14)
[^2]: Yoom Blog, Miro と Notion をノーコードで連携させる方法, https://lp.yoom.fun/blog-posts/miro-notion-integration-25w14 (2026‑04‑12 アクセス確認)
[^3]: Miro Developers, Rate Limits, https://developers.miro.com/docs/rate-limits (閲覧日: 2026‑04‑13)
[^4]: Notion API Documentation, Limits & Rate Limiting, https://developers.notion.com/reference/limits (閲覧日: 2026‑04‑13)