Relevante para: Admins da empresa e admins do time em planos Enterprise
Como Admin da empresa de uma assinatura Enterprise, você controla se o Miro MCP Server está disponível para sua organização. Essa configuração determina se seus times podem usar integrações de IA que se conectam à Miro.
Use o MCP da Miro (Protocolo de Contexto de Modelo) para conectar seus boards da Miro a ferramentas de IA compatíveis com MCP. Quando ativados e autorizados, agentes de IA podem ler o contexto de boards específicos e, quando permitido, executar ações como resumir conteúdo ou criar diagramas por meio de um conjunto selecionado de ferramentas MCP da Miro. Este guia explica os pré-requisitos, a ativação, a governança e a solução de problemas.
Antes de começar
- Defina o escopo: ativar para toda a organização ou apenas para times selecionados (as permissões no nível do board ainda se aplicam).
Ativar ou desabilitar o Servidor MCP
Para ativar o Servidor MCP:
- Vá para Configurações do Admin > Apps e Integrações > MCP.
- Escolha o escopo.
- Organização: Qualquer usuário da sua organização pode autorizar o MCP para boards aos quais já tem acesso.
- Time(s) selecionado(s): Somente usuários nesses times podem autorizar o MCP. Permissões no nível do board ainda se aplicam.
- Ative. As alterações entram em vigor imediatamente.
Para interromper temporariamente o uso, desative o Miro MCP no mesmo local (impede novas chamadas de ferramenta).
OBSERVAÇÃO: Se você não encontrar a opção do MCP, entre em contato com seu gerente de conta.
Como o acesso e as permissões funcionam
Ao ativar o MCP, você permite:
- que agentes externos de IA leiam o conteúdo do board quando autorizados pelos usuários
- que ferramentas de IA criem ou modifiquem conteúdo em boards da Miro
- que haja troca segura de dados entre a Miro e aplicações de terceiros
Considerações importantes de segurança:
- Todo acesso é autenticado por OAuth 2.1
- Os usuários só podem conceder acesso aos boards que têm permissão para visualizar
- A conformidade de segurança da Enterprise é mantida
- Aplicam-se limites de taxa padrão da API a todas as operações
- Os usuários na sua organização poderão autenticar-se no MCP Server, permitindo que agentes de IA externos/terceiros leiam e criem conteúdo em um board em nome deles
Gerenciar o MCP na sua organização
Como admin, você deve considerar:
- Comunicação: Informe seus times sobre a disponibilidade do MCP da Miro e casos de uso
- Treinamento: Forneça orientações sobre como usar o MCP de forma eficaz com diferentes ferramentas de IA
- Governança: Estabeleça diretrizes para o uso apropriado de conteúdo gerado por IA
- Monitoramento: Revise periodicamente o uso do MCP e ajuste as configurações conforme necessário
Para mais informações sobre o gerenciamento de apps no seu ambiente Miro, consulte a documentação de gerenciamento de apps.
Orientações de implantação
- Comece pequeno: ative para um ou dois times piloto (por exemplo, engenharia e produto) e valide o valor e o controle.
- Reforce a higiene dos prompts: exija que os usuários incluam a URL completa do board em cada prompt MCP.
Solução de problemas
- “Não consigo ver as ferramentas no MCP da Miro no meu cliente”
- Confirme se o MCP está ativado para a organização ou para o time pretendido, e se o usuário pertence a esse time.
- Execute novamente o fluxo OAuth e selecione um time com MCP ativado.
- Verifique se o cliente oferece suporte ao MCP e está entre os clientes que estamos direcionando/documentando.
- “Acesso negado ao enviar prompt”
- Certifique-se de que o prompt inclui a URL completa do board; os agentes não descobrirão boards automaticamente.
- Confirme que o usuário já tem acesso a esse board na Miro.
- “Precisamos pausar o uso agora”
- Desative o MCP em Configurações do Admin > Apps e Integrações > Miro MCP.