Relevante para: Admins da empresa e 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 ao Miro.
Use o Miro MCP (Protocolo de Contexto de Modelo) para conectar seus boards do Miro a ferramentas de IA compatíveis com MCP. Quando ativados e autorizados, agentes de IA podem ler contextos de boards específicos e (quando permitido) realizar ações como resumir conteúdo ou criar diagramas através de um conjunto de ferramentas MCP da Miro. Este guia explica os pré-requisitos, habilitação, governança e solução de problemas.
Antes de começar
- Decidir o escopo: habilitar para a organização inteira ou apenas para times selecionados (as permissões em nível de board ainda se aplicam).
Habilitar ou desabilitar MCP Server
Para habilitar o MCP Server:
- Vá para Configurações do Admin > Apps e Integrações > MCP.
- Escolha o escopo.
- Organização: Qualquer usuário na sua organização pode autorizar o MCP para boards aos quais já têm acesso.
- Time(s) selecionado(s): Somente usuários nesses times podem autorizar o MCP; permissões a nível de board ainda se aplicam.
- Ativar. As alterações entram em vigor imediatamente.
Para suspender temporariamente o uso, desative o MCP da Miro no mesmo local (interrompe novas chamadas de ferramentas).
Como funcionam o acesso e as permissões
Ao ativar o MCP, você permite:
- Agentes externos de IA para ler o conteúdo dos boards quando autorizados pelos usuários
- Ferramentas de IA para criar ou modificar conteúdo nos boards da Miro
- Troca segura de dados entre a Miro e aplicações de terceiros
Considerações importantes de segurança:
- Todo acesso é autenticado através do OAuth 2.1
- Os usuários só podem conceder acesso a boards que têm permissão para visualizar
- A conformidade de segurança Enterprise é mantida
- Os limites padrão de taxa da API se aplicam a todas as operações
- Os usuários da 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 seu nome
Gerenciando o MCP na sua organização
Como admin, você deve considerar:
- Comunicação: Informe seus times sobre a disponibilidade do Miro MCP e casos de uso
- Treinamento: Ofereç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 aplicativos no seu ambiente Miro, consulte a documentação de gerenciamento de aplicativos.
Orientações para implantação
- Comece pequeno: ative para um ou dois times piloto (por exemplo, engenharia e produto) e valide o valor/controle.
- Reforce a higiene no prompt: exija que os usuários incluam um URL completo do board em cada prompt MCP.
Solução de problemas
- “Não consigo ver as ferramentas MCP do Miro no meu cliente”
- Confirme que o MCP está ativado para a organização ou time pretendido, e que o usuário pertence a esse time.
- Execute novamente o fluxo OAuth e selecione um time com MCP ativado.
- Verifique se o cliente suporta MCP e está entre os clientes que estamos mirando/documentando.
- "Acesso negado ao solicitar prompt"
- Garanta que o prompt inclua uma URL completa do board; os agentes não irão descobrir os boards automaticamente.
- Confirme que o usuário já tem acesso a esse board no Miro.
- "Precisamos pausar o uso agora"
- Desative o MCP em Configurações de Admin > Aplicativos e Integrações > Miro MCP.