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, usted controla si Miro MCP Server está disponible para su organización. Esta configuración determina si sus equipos pueden usar integraciones de IA que se conectan con Miro.

Utilice Miro MCP (Model Context Protocol) para conectar sus 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 requisitos previos, la habilitación, la gobernanza y la resolución de problemas.

Antes de comenzar

• Habilitar para toda la organización o solo para equipos seleccionados (los permisos a nivel de tablero siguen vigentes).

Habilitar o deshabilitar el Servidor MCP de Miro

Para habilitar el Servidor MCP de Miro:

1. Ve a Configuración de administrador > Apps y integraciones > MCP.
2. Selecciona el alcance.
   1. Organización: Cualquier usuario de tu organización puede autorizar MCP para los tableros a los que ya tiene acceso.
   2. Equipo(s) seleccionado(s): Solo los usuarios de esos equipos pueden autorizar MCP. Los permisos a nivel de tablero siguen aplicándose.
3. Activa el interruptor. Los cambios surten efecto de inmediato.

Para detener temporalmente su uso, desactiva Miro MCP en la misma ubicación (detiene las nuevas llamadas a herramientas).

NOTA: Si no ves el interruptor de MCP, contacta a tu gerente de cuenta.

Cómo funcionan el acceso y los permisos

Al habilitar MCP, permites:

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

Consideraciones importantes de seguridad:

• Todo el acceso se autentica mediante OAuth 2.1.
• Los usuarios solo pueden conceder acceso a los tableros que tienen permiso para ver.
• Se mantiene el cumplimiento de seguridad de Enterprise.
• Los límites de uso estándar de la API se aplican a todas las operaciones.
• Los usuarios en tu organización podrán autenticarse en el Miro MCP Server, lo que permitirá que agentes de IA externos o de terceros lean y creen contenido en un tablero en su nombre.

Administrar 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 manera efectiva con distintas herramientas de IA.
3. Gobernanza: Establece lineamientos para el uso adecuado del contenido generado por IA.
4. Supervisión: 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 implementación

• Comienza con un alcance reducido: habilítalo para uno o dos equipos piloto (por ejemplo, ingeniería y producto) y valida su valor y control.
• Refuerza la higiene de las instrucciones: exige a los usuarios que incluyan la URL completa del tablero en cada instrucción 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 MCP.
2. 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.
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 Agregar. 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.

CONSEJO: Vuelve a Aplicaciones e Integraciones > MCP > Todos los Clientes (en Control de Acceso) y desactiva el cliente. 

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

Resolución de problemas

• “No puedo ver las herramientas de Miro MCP en mi cliente”
  • Verifica que MCP esté habilitado para la organización o el equipo previsto y que el usuario pertenezca a ese equipo.
  • Vuelve a ejecutar el flujo de OAuth y selecciona un equipo con MCP habilitado.
  • 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.
  • Verifica que el usuario ya tenga acceso a ese tablero en Miro.
• “Necesitamos pausar el uso ahora”
  • Desactiva MCP en Configuración de administrador > Apps e Integraciones > Miro 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.