Miro工作流程
把自然语言变成米罗板
描述你想要什么。AI创建了董事会。MCP与Cursor IDE完全集成，无需拖放。
快速开始 · 特性 · 自定义MCP服务器 · 提示库 · 文档
______________________________________________________________________
______________________________________________________________________
问题
创建Miro板是手动、重复和缓慢的。每一次冲刺计划会议、架构审查或复古都以同样的拖放仪式开始。当您需要将代码转换为可视化图表时，您会在IDE和白板工具之间切换。
解决方案
Miro工作流让您 用自然语言描述任何电路板 并通过模型上下文协议（MCP）立即创建它。它直接在Cursor IDE中工作，无需上下文切换，也无需拖放。只需描述你需要什么，AI就会在你的Miro板上构建它。
该项目包括 官方米罗MCP 集成（零设置）和a 自定义MCP服务器 通过精确定位、自定义颜色、所有项目类型和专业布局，为您提供完整的REST API v2控制。
*创建一个包含待办事项、进行中、审查和完成列的冲刺计划板。添加5个示例用户故事* 完成。董事会成立。贴上贴纸。列已组织。
______________________________________________________________________
特性
- Miro MCP官方集成 --连接到Miro的托管MCP服务器（零本地设置）
- 自定义MCP服务器 -具有精确定位、颜色和所有项目类型的完整REST API v2控制
- AI驱动的电路板创建 --使用自然语言生成图表、工作流和架构可视化
- 代码↔ 图表转换 --将代码转换为可视化图表，反之亦然
- 团队协作 --多个开发人员同时在同一个Miro团队板上工作
- 精心策划的即时图书馆 --预先构建的架构图、冲刺计划、回溯、SWOT分析等提示
- 验证工具 --内置安装验证脚本，用于验证您的配置
- 完全样式控制 --自定义颜色、边框、填充、字体、大小和精确（x，y）定位
快速开始
先决条件
安装
- 克隆存储库
git clone https://github.com/YOUR_USERNAME/miro-workflows.git
cd miro-workflows- 安装依赖项
bun install- 验证您的设置
bun run validate- 在Cursor中连接到Miro MCP
- 打开光标设置(
Ctrl + ,) - 引导到 特性 → MCP服务器
- 找到“miro”并单击 连接
- 完成OAuth身份验证
- 选择您的Miro团队
第一步
在Cursor中尝试此提示以验证您的连接：
Create a new Miro board called "Test Board" with a simple architecture diagram showing a frontend, backend, and database项目结构
miro-workflows/
├── .cursor/
│ └── mcp.json # MCP server configuration
├── docs/
│ ├── SETUP.md # Detailed setup instructions
│ ├── PROMPTS.md # Curated prompt library
│ └── WORKFLOWS.md # Workflow documentation template
├── examples/
│ └── sample_prompts.md # Ready-to-use example prompts
├── scripts/
│ └── validate_setup.ts # Environment validation script
├── .env.example # Environment template
├── .gitignore
├── package.json
├── tsconfig.json
├── bunfig.toml
└── README.md文档
- 设置.md：新团队成员的完整设置指南
- PROMPTS.md：Miro MCP的有效提示和模式
- 工作流.md：用于记录董事会和工作流程的模板
- sample_prompts.md：常见场景的复制粘贴示例
使用示例
生成架构图
Create a microservices architecture diagram with:
- API Gateway
- Auth Service
- User Service
- Product Service
- PostgreSQL database
- Redis cache将代码转换为图表
Analyze this repository [github-url] and create a class diagram showing component relationships从Board生成代码
Based on the API design at [miro-board-url], generate FastAPI endpoints with Pydantic models创建Sprint董事会
Create a sprint planning board with Backlog, In Progress, Review, and Done columns. Add 5 sample user stories.协作工作流
团队成员
- 两位开发人员都使用自己的Miro帐户进行身份验证
- 选择 同一支米罗队 OAuth期间
- 协同创建和编辑板
- 文件板
docs/WORKFLOWS.md - 在推动更改时使用常规提交
Git工作流
# Pull latest changes
git pull origin main
# Create feature branch
git checkout -b feature/new-workflow
# Make changes and commit (use conventional commits)
git commit -m "feat(docs): add new workflow template"
# Push and create PR
git push origin feature/new-workflow常规承诺
该项目如下 常规承诺:
feat:新功能fix:错误修复docs:文档更改chore:维护任务refactor:代码重构test:测试更新
示例：
git commit -m "feat(prompts): add database schema generation prompts"
git commit -m "fix(scripts): resolve validation script path issue"
git commit -m "docs: update setup guide with troubleshooting steps"脚本
| 命令 | 描述 |
|---|---|
bun run validate | 验证开发环境设置 |
bun install | 安装依赖项 |
能力
官方Miro MCP服务器支持：
| 特性 | 描述 |
|---|---|
| 生成图表 | 创建系统架构、工作流、ERD等 |
| 生成代码 | 将图表和PRD转换为工作代码 |
| 阅读董事会背景 | AI可以分析现有的电路板 |
| OAuth 2.1安全 | 企业级认证 |
| 团队协作 | 同一团队板上的多个用户 |
支持的AI客户端
- 光标✓
- 克劳德代码
- VSCode+GitHub副本
- Gemini CLI
- 可爱的
- 回复
- 帆板运动
- 以及更多兼容MCP的客户端
故障排除
连接问题
问题：无法连接到Miro MCP
解决方案:
- 验证网络访问权限
https://mcp.miro.com/ - 将游标更新到最新版本
- 断开并重新连接MCP服务器
团队选择错误
问题：无法访问板或权限被拒绝
解决方案：重新验证并确保您选择了正确的Miro团队（必须与您的合作者团队匹配）
OAuth令牌已过期
解决方案：在光标设置中断开连接并重新连接→ MCP服务器
有关更多故障排除，请参阅 docs/SETUP.md.
资源
安全
- OAuth 2.1身份验证
- 存储库中未存储API密钥
- Miro提供的企业级安全保障
- 基于权限的板访问
- 速率限制保护
贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 遵循常规承诺
- 提交拉取请求
许可证
MIT许可证-有关详细信息，请参阅许可证文件
支持
- 为bug或功能请求打开问题
- 检查 docs/SETUP.md 获取设置帮助
- 审查 docs/PROMPTS.md 使用指南
自定义MCP服务器
官方的Miro MCP只创建基本的流程图。附带的自定义MCP服务器(miro-custom-mcp/)让您完全控制：
| 功能 | 官方MCP | 自定义MCP服务器 |
|---|---|---|
| 基本流程图 | 是 | 是 |
| 精确（x，y）定位 | 否 | 是 |
| 自定义十六进制颜色 | 否 | 是 |
| 便签、形状、框架、卡片 | 有限 | 满 |
| 更新和删除项目 | 否 | 是 |
| 专业布局（SWOT、仪表板） | 否 | 是 |
| 全边框/填充/字体样式 | 否 | 是 |
看 miro自定义mcp/README.md 有关设置说明。
______________________________________________________________________
路线图
- \[\]常见电路板布局的模板市场
- \[\]自动板到代码生成流水线
- \[\]实时板同步Git提交
- \[\]VS代码扩展名（游标之外）
- \[\]板版本控制和差异可视化
- \[\]用于创建董事会的Slack/Discord机器人
______________________________________________________________________
*别拖了。开始描述。*