Servidor MCP de Miro (guía del admin)

Quién puede hacerlo: Admins de empresa y 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 conecten con Miro.

Usa Miro MCP (Model Context Protocol) para conectar tus tableros de Miro a herramientas de IA compatibles con MCP. Cuando está habilitado y autorizado, los agentes de IA pueden 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 requisitos previos, la habilitación, la gobernanza y la solución de problemas.

Antes de empezar

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

Habilitar o deshabilitar MCP Server

Para habilitar MCP Server:

1. Ve a Configuración de administrador > Apps e integraciones > MCP.
2. 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 (detiene nuevas llamadas a herramientas).

MCP puede usar Miro AI para generar formatos o realizar acciones relacionadas con el contenido. Estas acciones consumen los créditos de Miro AI de tu organización.

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.

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

1. En la Consola de administración, ve a Aplicaciones e integraciones > MCP.
2. En Control de acceso, abre el desplegable Equipos y grupos de usuarios, luego selecciona Equipos y grupos de usuarios específicos.
   Se abrirá el panel Agregar acceso a MCP.
3. 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, luego vuelve al panel.
   3. Haz clic en Siguiente.
4. Filtrar por grupos de usuarios:
   1. Elige Todos los usuarios de los equipos seleccionados, o Solo los usuarios que además 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, luego vuelve al panel.
   3. Haz clic en Siguiente.
5. Revisa y confirma el resumen (por ejemplo, los usuarios en 6 equipos que también estén en 1 grupo de usuarios tendrán acceso a Miro MCP). Puedes hacer clic en Editar para cambiar equipos o grupos de usuarios.
6. 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 solo puede autorizar Miro MCP si cumple ambas condiciones que configuraste:

1. Pertenecen a un equipo seleccionado (o a cualquier equipo, si eliges Todos los equipos).
2. Si seleccionas grupos de usuarios, además deben pertenecer al menos a uno de esos grupos.

Si eliges Todos los usuarios en los 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 pertenecer a un equipo seleccionado.

Cuando seleccionas más de un grupo de usuarios, el usuario debe pertenecer a alguno 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 los equipos seleccionados: Los usuarios del Equipo A o del Equipo B pueden autorizar MCP. Los usuarios que solo pertenecen al Equipo C no pueden.
• Equipos específicos (Equipo A) y grupos de usuarios específicos (Grupo de usuarios 1): Solo 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, solo esos 20 pueden usar MCP.
• Todos los equipos y grupos de usuarios específicos: Los usuarios de cualquier equipo que también formen parte de un grupo de usuarios seleccionado pueden autorizar MCP.
• Volver a Todos: El acceso ya no está limitado a los equipos y grupos de usuarios que seleccionaste en el panel.

Cómo funcionan el acceso y los permisos

Cuando habilitas MCP, permites:

• Agentes de IA externos para leer el contenido del tablero cuando los usuarios lo autoricen.
• Herramientas de IA para crear o modificar contenido en los tableros de Miro.
• Intercambio seguro de datos entre Miro y aplicaciones de terceros.

Consideraciones importantes de seguridad:

• Todos los accesos se autentican mediante OAuth 2.1.
• Los usuarios solo pueden conceder acceso a los tableros que tienen permiso para ver.
• Se mantiene el cumplimiento de seguridad empresarial.
• Los límites de tasa estándar de la API se aplican a todas las operaciones.
• Los usuarios de tu organización podrán autenticarse en el MCP Server, lo que permitirá que agentes de IA externos o de terceros lean y creen contenido en un tablero en su nombre.
• Si restringes MCP mediante equipos y grupos de usuarios, los usuarios fuera de esa selección no podrán autorizar MCP.

Gestionar MCP en tu organización

Como admin, deberías considerar:

1. Comunicación: Informa a tus equipos sobre la disponibilidad de Miro MCP y sus casos de uso.
2. Capacitación: Proporciona orientación sobre cómo usar MCP de forma eficaz con distintas herramientas de IA.
3. Gobernanza: Establece lineamientos para el uso adecuado del contenido generado por IA.
4. 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

• Empieza con un piloto pequeño: en Control de acceso, elige Equipos y grupos de usuarios específicos, selecciona uno o dos equipos piloto y deja los grupos de usuarios como Todos los usuarios de los equipos seleccionados.
• Para un piloto más restringido, selecciona también Solo usuarios que también pertenezcan a grupos de usuarios específicos, de modo 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 para MCP.

Controla 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 administrar una lista de admitidos de clientes, incluidos tus propios clientes MCP personalizados.

Sigue estos pasos:

1. En la Consola de administración, ve a Aplicaciones e integraciones > MCP. Si aún no has habilitado MCP, consulta Habilitar o deshabilitar MCP Server.
2. Bajo 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.
3. Activa los clientes que quieras permitir. Para permitir un cliente MCP personalizado, escribe el nombre de tu cliente en la barra de búsqueda (arriba) y luego haz clic en Añadir. Para más información, consulta la documentación para desarrolladores de Miro MCP.
4. Haz clic en Guardar.
   El panel se cierra y los clientes que especificaste aparecen en una fila bajo Control de acceso.

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

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

Resolución de problemas

• “No puedo ver las herramientas de 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.
  • Verifica que el cliente sea compatible con MCP y que esté entre los clientes a los que nos dirigimos o que documentamos.
• “Acceso denegado al enviar la instrucción”
  • Asegúrate de que la instrucción incluya la URL completa del tablero; los agentes no descubrirán los tableros automáticamente.
  • Confirma que el usuario ya tiene acceso a ese tablero en Miro.
  • Si el usuario antes tenía acceso y dejó de funcionar, verifica si cambió el control de acceso de 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 administrador > 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 agrégalo como cliente personalizado.