MCP 経由で Miro を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Miro をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Miro + Cursor

AI に Miro のボードで作業させます。ボードの検索、ボード上の内容の読み取り、付箋、図形、テキスト、カード、フレームの追加と編集、線による接続、タグによる整理、アクセスできる人の確認ができます。Miro アカウントでサインインします。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

MIRO_CLIENT_ID, MIRO_CLIENT_SECRET

ステップ 1 — 認証情報を取得

1. Miro でアバターをクリックし、Settings → Your apps を開いて（または miro.com/app/settings/user-profile/apps を開いて）、+ Create new app をクリックします。developer team がまだない場合は、先に作成するよう Miro から求められます。作成は無料です。
2. アプリに名前を付け（たとえば「AnythingMCP」）、developer team を選び、Expire user authorization token にチェックを入れて Create app をクリックします。この設定は後から変更できません。チェックしない場合、トークンは失効しません。それでも動作しますが、安全性は下がります。
3. アプリのページで Redirect URI for OAuth2.0 に https://cloud.anythingmcp.com/api/mcp-oauth/callback を追加し、Add をクリックします。AnythingMCP をセルフホストしている場合は、代わりに https://your-anythingmcp-host/api/mcp-oauth/callback を入力します。URI は 1 文字単位で完全に一致している必要があります。
4. Permissions で boards:read と boards:write にチェックを入れます。
5. App Credentials にある Client ID と Client secret を、MIRO_CLIENT_ID と MIRO_CLIENT_SECRET にコピーします。Client ID は長い数字です。
6. コネクターをインストールし、コネクターのページで Authorize with Provider をクリックして、AI に作業させたいボードがある Miro のチームを選び、Install & authorize をクリックします。
7. まず miro_get_token_info を実行して、ユーザー、チーム、付与された権限を確認します。そのあと miro_list_boards で AI にボードを探させます。

サインイン状態の維持: AI が閲覧、変更できるのは、承認した Miro ユーザーが開けるボードのうち、承認時に選んだチームのボードです。別のチームのボードを扱うには、もう一度承認してそのチームを選んでください。アクセストークンの有効期間は 1 時間で、自動的に更新されます。リフレッシュトークンの有効期間は 60 日で、使うたびに延長されます。そのため、2 か月使われなかったコネクターは、もう一度 Authorize with Provider が必要です。

権限と読み取り専用の設定: boards:read だけにチェックを入れて再度承認し、作成、変更、削除を行うツールをすべてオフにします。対象は miro_create_board、miro_update_board、miro_copy_board、miro_create_sticky_note、miro_update_sticky_note、miro_create_shape、miro_update_shape、miro_create_text、miro_update_text、miro_create_card、miro_update_card、miro_create_frame、miro_update_frame、miro_move_item、miro_delete_item、miro_create_connector、miro_update_connector、miro_delete_connector、miro_create_tag、miro_update_tag、miro_delete_tag、miro_attach_tag、miro_remove_tag_from_item です。

インストール時はオフ: ボード全体を中身ごと削除する miro_delete_board、指定した相手に Miro から招待メールを送る miro_share_board、そしてユーザーのアクセス権を変更または削除する miro_update_board_member と miro_remove_board_member。AI にボードの削除やアクセス管理をさせる場合だけオンにしてください。

削除は元に戻せません: miro_delete_item はアイテムを完全に削除し、API からは元に戻せません。フレームを削除しても、その中身はボード上に残ります。miro_delete_tag は、そのタグが付いたすべてのアイテムからタグを外します。AI は、自分が直前に作成したもの以外を削除する前に確認を求めます。

タグとプラン: タグを付けられるのはカードと付箋だけで、1 つにつき最大 8 個です。タグの変更は、開いているボードでは再読み込みすると表示されます。Miro の API は無料で使えますが、無料のチームで編集できるボードは 3 つまでのため、miro_create_board と miro_copy_board が失敗することがあります。developer team のボードには透かしが入ります。

よくあるエラー: 401（tokenNotProvided）は、承認の期限が切れたか取り消されたことを示します。もう一度 Authorize with Provider をクリックしてください。アプリを削除した場合やシークレットを再発行した場合は、先に MIRO_CLIENT_SECRET を更新します。403 は、権限が足りない（変更には boards:write が必要）か、そのボードへのアクセス権がないことを示します。アプリの設定で権限にチェックを入れ、もう一度承認してください。404 は、ボードまたはアイテムの ID が間違っていることを示します。400（invalidParameters）は、誤っているフィールドを示します。409 は、同じタイミングでアイテムが変更されたことを示します。読み直してから再試行してください。429 は、Miro がこのユーザーのリクエストを制限していることを示します。1 分待ってください。フレームの作成が数分間 500「Internal error occurred」で失敗することがありますが、少し待てば同じリクエストがまた通ります。

このコネクターは、画像、ドキュメント、埋め込み（一覧表示のみ）、アプリカード、コメント、マインドマップ、エクスポート、チームや組織の管理は扱いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Miro のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「「Q3 振り返り」ボードを探して、フレームごとに付箋の内容を要約して。」
• 「「Checkout リデザイン」ボードにアクセスできるのは誰で、それぞれのロールは何？」
• 「「プロダクトロードマップ」ボードに「次のスプリント」というフレームを追加して、ログイン修正、検索フィルター、オンボーディングメールの 3 枚の黄色い付箋を貼って。」
• 「「スプリント計画」ボードで「ブロック中」タグが付いたカードを、担当者と期限付きですべて見せて。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Gemini に接続
• Meta Muse に接続