---
title: "连接 Miro 插件与 MCP"
summary: "在插件目录中添加 Miro，选择团队完成 OAuth。也可单独配置 https://mcp.miro.com/，避免与插件重复连接。"
category: mcp
level: starter
surfaces: [cli, app, ide]
tags: ["MCP", "Miro", "plugins", "OAuth"]
canonical: /tips/miro-codex-plugin/
---

# 连接 Miro 插件与 MCP

在插件目录中添加 Miro，选择团队完成 OAuth。也可单独配置 https://mcp.miro.com/，避免与插件重复连接。

Miro 先 Plugins 搜 Miro，远程 MCP 走 mcp.miro.com，带尾斜杠。官方给 Codex 的主路径是公共插件目录：桌面左侧 Plugins 搜 Miro，点 Add，浏览器里走 Miro OAuth，并选中画板所在的团队。开发者总览写成「从 ChatGPT 插件目录加 Miro，再 Connect」。官方没给出 `codex plugin add miro@…` 那种 marketplace id，不要自己编 `miro@openai-curated`。

MCP 按团队授权，一次只连一个团队。画板必须属于你刚勾的那个团队；换团队要重新 OAuth。FAQ 写明 Last One Wins：同一个 Miro 用户即使在多个 MCP 客户端登录，也只有最近一次授权有效，其它客户端会掉线。企业计划要管理员先在 Admin settings → Apps & Integrations → MCP 打开，并可按组织或指定团队、按客户端放行。免费团队也能用 MCP；看板摘要还要开 Miro AI，会扣 AI credits。

0.154 起可先在当前会话查看 `/plugins`；未显示插件时再新开会话。IDE 扩展没有 `/plugins`，用桌面或下面的 MCP。装完新开会话，问它能看到哪些 Miro 画板，或贴一个 `https://miro.com/app/board/…` 链接。插件已经带了托管 MCP 时，不要再 `mcp add` 重复的服务配置。

只要 MCP、不要整包插件时，托管地址是 `https://mcp.miro.com/`，**带**尾斜杠（官方 JSON 也这么写，不要丢掉尾斜杠，也不要再加 `/mcp`）：

```bash
codex mcp add miro --url https://mcp.miro.com/
codex mcp login miro
codex mcp get miro
```

```toml
[mcp_servers.miro]
url = "https://mcp.miro.com/"
enabled = true
```

用户层表名用 `miro`。没弹浏览器再 `mcp login miro`。这是 Streamable HTTP + OAuth 2.1，不要 API key，不要 `--bearer-token-env-var`。

网页 Cloud 不读取 `~/.codex/config.toml`。Cloud 也走 Plugins 搜 Miro。配置后重新打开会话。用 `codex plugin list` 看插件是否已装；手写 MCP 用 `codex mcp get miro` 看传输是 streamable_http，url 是 `https://mcp.miro.com/`。

## 来源

- [Miro Marketplace · Miro MCP for OpenAI Codex](https://miro.com/marketplace/miro-mcp-for-openai-codex/)
- [Miro Developers · MCP Server](https://developers.miro.com/docs/miro-mcp)
- [Miro Developers · Connecting to Miro MCP](https://developers.miro.com/docs/connecting-to-miro-mcp)
- [Miro Help · How to enable Miro's MCP Server](https://help.miro.com/hc/en-us/articles/31625301583890-How-to-enable-Miro-s-MCP-Server-user-guide)
- [miroapp/miro-ai](https://github.com/miroapp/miro-ai)