Relevante para: Admins da empresa e do time nos planos Enterprise
Como admin da empresa para uma assinatura Enterprise, você controla se o Miro MCP Server está disponível para sua organização. Este ajuste determina se seus times podem usar integrações de IA que se conectam ao Miro.
Use o Miro MCP (Protocolo de Contexto do Modelo) para conectar seus boards do Miro a ferramentas de IA compatíveis com o MCP. Quando ativados e autorizados, agentes de IA podem ler contexto de boards específicos e (quando permitido) tomar ações como resumir conteúdo ou criar diagramas através de um conjunto selecionado de ferramentas do Miro MCP. Este guia explica os pré-requisitos, a ativação, governança e solução de problemas para o Beta Público.
Antes de começar
- Reveja e reconheça os termos beta. Durante a beta, os SLAs padrão, as obrigações de segurança, as obrigações de suporte e as indenizações sob seu MCA (ou outro acordo) podem não se aplicar.
- Decida o escopo: habilitar para toda a organização ou apenas para times selecionados (as permissões no nível do board ainda se aplicam).
Habilitar ou desabilitar o MCP Server
Para habilitar o MCP Server:
- Acesse as configurações do admin → Aplicativos e Integrações → MCP (Beta).
- Revise o aviso beta dentro do produto e a documentação vinculada; reconheça os termos beta.
- Escolha o escopo.
- Organização: Qualquer usuário na sua organização pode autorizar o MCP para os boards aos quais já tem acesso.
- Time(s) selecionado(s): Apenas usuários nesses times podem autorizar o MCP; permissões a nível de board ainda se aplicam.
- Ativar. As mudanças entram em vigor imediatamente.
Para interromper temporariamente o uso, desative o Miro MCP no mesmo local (interrompe novas chamadas de ferramenta).
Como funcionam o acesso e as permissões
Quando você habilita o MCP, você permite:
- Agentes de IA externos lerem o conteúdo do board quando autorizados pelos usuários
- Ferramentas de IA criarem ou modificarem conteúdo em boards do Miro
- Troca segura de dados entre Miro e aplicativos de terceiros
Considerações importantes de segurança:
- Todo o acesso é autenticado pelo OAuth 2.1
- Os usuários só podem conceder acesso a boards que têm permissão para visualizar
- A conformidade com a segurança Enterprise é mantida
- Os limites padrão da API se aplicam a todas as operações
- Os usuários na sua organização poderão autenticar-se no MCP Server, permitindo que agentes externos/terceiros de IA leiam e criem conteúdo em um board em seu nome
Gerenciar MCP na sua organização
Como admin, você deve considerar:
- Comunicação: Informe suas equipes sobre a disponibilidade do Miro MCP e casos de uso
- Treinamento: Forneça orientação sobre como usar eficazmente o MCP 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 gerenciar aplicativos no seu ambiente Miro, consulte a documentação de gerenciamento de aplicativos.
Orientação para implementação
- Comece pequeno: ative para uma ou duas equipes piloto (por exemplo, engenharia e produto) e valide o valor/controle.
- Reforce a higiene do prompt: exija que os usuários incluam uma URL completa do board em cada prompt do MCP.
Solução de problemas
- “Não consigo ver as ferramentas do Miro MCP 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.
- Re-execute o fluxo OAuth e selecione um time com o MCP habilitado.
- Verifique se o cliente suporta MCP e se está entre os clientes que estamos direcionando/documentando.
- “Acesso negado ao enviar um prompt”
- Garanta que o prompt inclua a URL completa do board; agentes não descobrem 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 (Beta).