Miro MCP Server (guía para admin) – Centro de ayuda de Miro

Quién puede hacerlo: Admins de empresa y admins de equipo en planes Enterprise

Como admin de empresa de una suscripción Enterprise, controlas si Miro MCP Server está disponible para tu organización. Esta configuración determina si tus equipos pueden usar integraciones de IA que se conectan con Miro.

Usa Miro MCP (Model Context Protocol) para conectar tus tableros de Miro con herramientas de IA compatibles con MCP. Cuando esté habilitado y autorizado, los agentes de IA podrán leer el contexto de tableros específicos y (cuando esté permitido) realizar acciones como resumir contenido o crear diagramas mediante un conjunto seleccionado de herramientas Miro MCP. Esta guía explica los prerequisitos, la habilitación, la gobernanza y la solución de problemas.

Antes de comenzar

Habilita MCP para tu organización y luego usa Control de acceso para decidir quién puede usarlo.
Puedes mantener el acceso abierto para todos, o limitarlo a equipos seleccionados y opcionalmente a grupos de usuarios. Las permisos a nivel de tablero siguen aplicando.

Habilitar o deshabilitar MCP Server

Para habilitar MCP Server:

Ve a Configuración de admin > Aplicaciones e integraciones > MCP.
En Habilitar MCP, activa Permitir a los usuarios de tu organización conectar Miro con clientes compatibles con MCP.

Los cambios surten efecto de inmediato.

Para detener temporalmente el uso, desactiva el mismo interruptor (se detendrán las llamadas a nuevas herramientas).

Si no ves la configuración de MCP, contacta a tu gerente de cuenta.

Controlar el acceso con equipos y grupos de usuarios

En Control de acceso > Equipos y grupos de usuarios, elige quién puede usar Miro MCP después de habilitarlo.

Configuración	Quién puede usar MCP
Todos (predeterminado)	Todos los usuarios que sean miembros de equipos habilitados
Equipos y grupos de usuarios específicos	Sólo los usuarios que pertenezcan tanto a los equipos como a los grupos de usuarios que selecciones

Restringir el acceso a equipos y grupos de usuarios específicos

En la Consola de admin, ve a Aplicaciones e integraciones > MCP.
En Control de acceso, abre el desplegable Equipos y grupos de usuarios y luego selecciona Equipos y grupos de usuarios específicos.
Se abre el panel Agregar acceso a MCP.
Seleccionar equipos:
1. Elige Todos los equipos de tu organización, o Equipos específicos.
2. Si eliges Equipos específicos, abre el selector de equipos, busca y selecciona equipos, haz clic en Agregar equipos y luego vuelve al panel.
3. Haz clic en Siguiente.
Filtrar por grupos de usuarios:
1. Elige Todos los usuarios en equipos seleccionados, o Sólo usuarios que también pertenezcan a grupos de usuarios específicos.
2. Si eliges grupos de usuarios específicos, abre el selector de grupos de usuarios, busca y selecciona grupos, haz clic en Agregar grupos de usuarios y luego vuelve al panel.
3. Haz clic en Siguiente.
Revisa y confirma el resumen (por ejemplo, usuarios en 6 equipos que además pertenecen a 1 grupo de usuarios tendrán acceso a Miro MCP). Puedes hacer clic en Editar para cambiar equipos o grupos de usuarios.
Haz clic en Agregar acceso.

Cómo funciona el acceso por equipos y grupos de usuarios

Cuando usas Equipos y grupos de usuarios específicos, un usuario puede autorizar Miro MCP sólo si cumple ambas condiciones que configuraste:

Pertenecer a un equipo seleccionado (o a cualquier equipo, si elegiste Todos los equipos).
Si seleccionaste grupos de usuarios, también pertenecer al menos a uno de esos grupos de usuarios.

Si eliges Todos los usuarios en equipos seleccionados, solo se aplica el requisito del equipo.

La pertenencia a un grupo de usuarios por sí sola no es suficiente. El usuario también debe estar en un equipo seleccionado.

Cuando seleccionas más de un grupo de usuarios, un usuario debe pertenecer a cualquiera de ellos (no a todos).

Ejemplos

Todos: Cualquier usuario en un equipo habilitado puede autorizar MCP.
Equipos específicos (por ejemplo A y B), todos los usuarios en equipos seleccionados: Los usuarios en el Equipo A o el Equipo B pueden autorizar MCP. Los usuarios sólo en el Equipo C no pueden.
Equipos específicos (Equipo A) y grupos de usuarios específicos (Grupo de Usuarios 1): Sólo los usuarios que estén en el Equipo A y en el Grupo de Usuarios 1 pueden autorizar MCP. Por ejemplo, si el Equipo A tiene 100 miembros y el Grupo de Usuarios 1 incluye a 20 de ellos, sólo esos 20 pueden usar MCP.
Todos los equipos y grupos de usuarios específicos: Los usuarios en cualquier equipo que además pertenezcan a un grupo de usuarios seleccionado pueden autorizar MCP.
Volver a Todos: El acceso ya no se limita a los equipos y grupos de usuarios que seleccionaste en el panel.

Cómo funcionan el acceso y los permisos

Al habilitar MCP, permites:

Que agentes de IA externos lean el contenido del tablero cuando los usuarios lo autoricen.
Que las herramientas de IA creen o modifiquen contenido en los tableros de Miro.
Intercambio seguro de datos entre Miro y aplicaciones de terceros.

Consideraciones importantes de seguridad:

El acceso se autentica mediante OAuth 2.1, o mediante enterprise-managed authorization (EMA) para Claude cuando lo habilites. Consulta Configurar enterprise-managed authorization para Miro MCP.
Los usuarios solo pueden otorgar acceso a los tableros que pueden ver.
Se mantiene el cumplimiento de seguridad empresarial.
Se aplican los límites de tasa estándar de la API a todas las operaciones.
Los usuarios de tu organización podrán autenticarse en el MCP Server, lo que permitirá a agentes de IA externos o de terceros leer y crear contenido en un tablero en su nombre.
Si restringes MCP con equipos y grupos de usuarios, los usuarios fuera de esa selección no podrán autorizar MCP mediante OAuth. EMA utiliza en su lugar el equipo predeterminado y los emisores de confianza que configures.

Gestionar MCP en tu organización

Como admin, considera:

Comunicación: Informa a tus equipos sobre la disponibilidad de Miro MCP y sus casos de uso.
Capacitación: Proporciona orientación sobre cómo usar MCP de forma eficaz con distintas herramientas de IA.
Gobernanza: Establece lineamientos para el uso apropiado del contenido generado por IA.
Monitoreo: Revisa periódicamente el uso de MCP y ajusta la configuración según sea necesario.

Para más información sobre la gestión de aplicaciones en tu entorno de Miro, consulta la documentación de gestión de aplicaciones.

Guía de despliegue

Comienza con poco: en Control de acceso, elige Equipos y grupos de usuarios específicos, selecciona uno o dos equipos piloto y deja los grupos de usuarios en Todos los usuarios en equipos seleccionados.
Para un piloto más limitado, también elige Sólo usuarios que también pertenezcan a grupos de usuarios específicos para que solo ese grupo pueda autorizar MCP.
Refuerza la higiene de las instrucciones: exige que los usuarios incluyan la URL completa del tablero en cada instrucción a MCP.

Configurar enterprise-managed authorization para Claude

Enterprise-managed authorization (EMA) permite que tu proveedor de identidad otorgue acceso a Miro MCP para Claude, de modo que las personas no completen un inicio de sesión OAuth de Miro por separado. Otros clientes MCP seguirán usando OAuth.

En la página de MCP, en Enterprise-Managed Authorization, seleccionas un equipo predeterminado, agregas emisores de confianza de tu proveedor de identidad (Okta en el primer lanzamiento) y finalizas la configuración en la consola de admin de Anthropic.

Más información: Consulta Configurar enterprise-managed authorization para Miro MCP.

Controlar qué clientes MCP pueden conectarse a Miro

Como admin de empresa, puedes permitir que todos los clientes accedan a Miro desde tu organización, o gestionar una lista de admitidos de clientes, incluidos tus propios clientes MCP personalizados.

Sigue estos pasos:

En la Consola de admin, ve a Aplicaciones e integraciones > MCP. Si aún no has habilitado MCP, consulta Habilitar o deshabilitar MCP Server.
En Control de acceso, Todos los clientes es la configuración predeterminada. Para modificarla, haz clic en Todos los clientes y luego en Clientes específicos.
Se abre el panel Clientes MCP específicos.
Activa los clientes que quieras permitir. Para permitir un cliente MCP personalizado, introduce el nombre de tu cliente en la barra de búsqueda (arriba) y luego haz clic en Agregar. Para más información, consulta la documentación para desarrolladores de Miro MCP.
Haz clic en Guardar.
El panel se cierra y tus clientes especificados aparecen en una fila debajo de Control de acceso.

Para deshabilitar cualquier cliente, vuelve a Aplicaciones e integraciones > MCP > Todos los clientes (bajo Control de acceso) y desactiva el cliente.

Si agregas un cliente MCP personalizado y luego lo deshabilitas, el cliente se elimina de la lista. Para volver a permitirlo, deberás volver a agregar el cliente. Consulta el paso 3 en Controlar qué clientes MCP pueden conectarse a Miro.

Solución de problemas

“No puedo ver las herramientas Miro MCP en mi cliente”
- Confirma que MCP esté habilitado para la organización.
- En Control de acceso > Equipos y grupos de usuarios, confirma que el usuario esté incluido (en un equipo seleccionado y en un grupo de usuarios seleccionado si configuraste uno).
- Vuelve a ejecutar el flujo OAuth y selecciona un equipo que tenga acceso a MCP.
- Para Claude con enterprise-managed authorization, confirma que EMA esté habilitado, que el usuario esté en el equipo EMA predeterminado, que el emisor de confianza muestre Discovery resolved y Keys reachable, y que EMA esté activado para el conector de Miro en la consola de admin de Anthropic.
- Verifica que el cliente sea compatible con MCP y esté entre los clientes que documentamos.
“Acceso denegado al enviar una instrucción”
- Asegúrate de que la instrucción incluya la URL completa del tablero; los agentes no descubrirán tableros automáticamente.
- Confirma que el usuario ya tenga acceso a ese tablero en Miro.
- Si el usuario tenía acceso anteriormente y dejó de funcionar, verifica si cambió el control de acceso Equipos y grupos de usuarios, o si lo eliminaron de un equipo o grupo de usuarios seleccionado.
“Necesitamos pausar el uso ahora”
- Desactiva MCP en Configuración de admin > Aplicaciones e integraciones > MCP.
"El cliente de un usuario está bloqueado / devuelve un error de acceso"
- Confirma que el cliente esté activado en Control de acceso, o añádelo como cliente personalizado.