Miro AI Developer Tools

Подключайте AI‑ассистентов для кодирования к вашим доскам в Miro. Создавайте диаграммы, извлекайте контекст, генерируйте код по дизайнам и отслеживайте задачи — всё через естественный разговор.

Поделиться вашим отзывом.

Что находится в этом репозитории?

Этот репозиторий предоставляет всё необходимое для подключения инструментов AI к Miro:

Компонент	Что делает
Miro MCP Server	API, который предоставляет AI‑агентам доступ к вашим доскам в Miro
Plugins & Extensions	Готовые интеграции для популярных инструментов AI
Documentation	Руководства по использованию и разработке интеграций

Поддерживаемые AI‑инструменты

AI инструмент	Интеграция
Claude Code	Плагины
Gemini CLI	Расширения
Codex	Локальные плагины
Kiro	Power
Agent Skills	Skills
Cursor, VSCode, Windsurf, и др.	MCP Config

Быстрый старт

Шаг 1: Выберите ваш AI‑инструмент

Выберите ваш AI‑инструмент ниже и следуйте шагам установки.

Шаг 2: Установка

Claude Code (рекомендовано)

/plugin marketplace add miroapp/miro-ai
/plugin install miro@miro-ai

Плагин miro включает все навыки (browse, code-review, code-spec, code-explain-on-board, diagram, doc, table) и сервер Miro MCP.

Перезапустите Claude Code после установки. Если ранее вы настраивали Miro MCP вручную, удалите дубликат MCP‑серверов, чтобы избежать конфликтов — плагин уже управляет подключением MCP за вас.

Полная документация доступна в Claude Code Plugins.

Gemini CLI

gemini extensions install https://github.com/miroapp/miro-ai

Gemini CLI устанавливает репозиторий как расширение, регистрирует сервер MCP из gemini-extension.json и автоматически обнаруживает 7 встроенных навыков из skills/. Перезапустите Gemini CLI и аутентифицируйтесь по запросу.

См. Gemini CLI Extension | Official Docs

Kiro

Откройте панель Power в Kiro
Нажмите Add power from GitHub
Введите: miroapp/miro-ai и выберите powers/code-gen

Для локальной разработки смотрите CONTRIBUTING.md.

См. Kiro Powers | Official Docs

Agent Skills (agentskills.io) Портативные навыки, которые работают с разными AI‑инструментами для кодирования (Claude Code, Cursor, VS Code + Copilot, Codex и т. д.).

npx skills add miroapp/miro-ai                       # Интерактивная установка
npx skills add miroapp/miro-ai --list                # Список доступных навыков
npx skills add miroapp/miro-ai --skill=miro-browse   # Установить конкретный навык

Доступные навыки: miro-browse, miro-code-review, miro-code-spec, miro-diagram, miro-doc, miro-table

См. Agent Skills Overview | agentskills.io

Другие MCP‑клиенты (Cursor, VSCode + Copilot, Windsurf, Lovable, Replit и т. п.) Добавьте в файл конфигурации вашего MCP‑клиента:

{
  "mcpServers": {
    "miro": {
      "url": "https://mcp.miro.com/"
    }
  }
}

Примечание: если в вашем клиенте позже станет доступен плагин или расширение для Miro, переключитесь на него и удалите ручной ввод, чтобы избежать дубликатов серверов.

См. MCP Setup Guide для путей, специфичных для клиента.

Шаг 3: Аутентификация

При первом использовании команды Miro вам предложат пройти аутентификацию:

Откроется окно браузера с Miro OAuth
Войдите в свою учетную запись Miro
Разрешите доступ к запрашиваемым доскам
Вернитесь к вашему AI‑инструменту — вы подключены!

Шаг 4: Попробуйте

Проверьте вашу сборку с этими примерами запросов:

"Что на моей доске Miro https://miro.com/app/board/..."

"Создай блок-схему в Miro, показывающую поток входа пользователя"

"Подвести итог архитектурной диаграмме на моей доске Miro"

Режим разработчика

Хотите изменить плагины, протестировать изменения локально или создать свой собственный инструмент? Смотрите CONTRIBUTING.md для инструкций по настройке разработки.

Плагины Codex генерируются локально в codex-plugins/*/ с репозиторием marketplace в .agents/plugins/marketplace.json. См. Codex Plugins для структуры и CONTRIBUTING.md для регенерации и локального тестирования.

Избежание дубликатов серверов

Если ваш клиент имеет плагин или расширение Miro, используйте только его — не добавляйте вручную https://mcp.miro.com/. Каждое средство установки создаёт отдельное соединение MCP с собственной OAuth‑сессией, и выполнение более одного приводит к дублированию инструментов и путанице с авторизацией.

См. руководство Duplicate MCP Servers в документации разработчика Miro для диагностики и очистки.

Для корпоративных пользователей

Требуется административное утверждение: если ваша организация использует план Miro Enterprise, ваш администратор должен включить MCP Server, прежде чем вы сможете подключиться.

См. Enterprise Guide для инструкций по настройке.

Что вы можете делать?

Навыки (Claude Code)

Навыки активируются автоматически при естественном описании того, что вы хотите сделать. Сами команды типа / не требуются — достаточно указать URL доски Miro.

Навык	Срабатывает на
miro-browse	"List the frames on …", "Что на этом board…"
miro-code-review	"Review PR 123 on …", "Визуальный просмотр этой ветки на …"
miro-code-spec	"Extract specs from …", "Pull the design docs at …"
miro-diagram	"Create a flowchart on …", "Add a sequence diagram to …"
miro-doc	"Add a markdown doc to …", "Write a sprint plan on …"
miro-table	"Make a task tracker table on …", "Sync these rows to …"

Возможности (Все платформы)

Возможность	Описание
Generate Diagrams	Создавать диаграммы (потоки, последовательности, ERD) из кода или описаний
Generate Code	Преобразовывать дизайны доски и вайрфреймы в работующий код
Track Tasks	Синхронизировать задачи между AI‑разговорами и таблицами в Miro
Extract Context	Читать содержимое доски для информирования AI‑рабочих процессов

Доступные плагины

Claude Code

Плагин	Описание
miro	Ядровая MCP‑интеграция с 7 встроенными навыками (browse, code-review, code-spec, code-explain-on-board, diagram, doc, table)

Gemini CLI

Расширение	Описание
miro	Ядровая MCP‑интеграция с встроенными навыками

Codex

Плагин	Описание
miro	Ядровая MCP‑интеграция с нативной активацией $miro: и доступом к MCP

Agent Skills

Навык	Описание
miro-browse	Список, фильтрация и сводка элементов на доске Miro
miro-code-review	Визуальный обзор кода по PR, локальным изменениям или сравнению веток
miro-code-spec	Извлечение спецификаций Miro (документы, диаграммы, прототипы, таблицы, изображения) в .miro/specs/
miro-diagram	Создание диаграмм (flowchart, mindmap, UML, ER) из текста или Mermaid
miro-doc	Создание и редактирование markdown‑документов на доске Miro
miro-table	Создание, заполнение и синхронизация структурированных таблиц на доске Miro

Kiro

Power	Описание
code-gen	Рабочие процессы дизайн‑в‑код

Безопасность

OAuth 2.1 — безопасная авторизация
Соответствие требованиям предприятий — корпоративные стандарты
Доступ на основе разрешений через вашу учетную запись Miro
Защита API с ограничением скорости — защитa от перегрузок

Документация

Начало работы

MCP Setup Guide — Конфигурация, специфичная для клиента
Enterprise Guide — Админ‑настройка для предприятий

Руководства по платформам

Справка

Разработка

Внешние ресурсы

Miro Developer Docs

Поддерживаемые MCP‑клиенты

Claude Code, Cursor, VSCode + GitHub Copilot, Gemini CLI, Lovable, Replit, Windsurf, Kiro, Glean, Devin, OpenAI Codex

Обратная связь и поддержка

Issues & Features: Открыть проблему
Feedback: Поделиться своим мнением
Community: Сообщество разработчиков Miro

Лицензия

MIT — см. LICENSE

С любовью сделано компанией Miro