Servidor MCP da Miro (guia do admin)

Quem pode fazer isso: 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 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 pré-requisitos, ativação, governança e solução de problemas.

Antes de começar

• 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 Servidor MCP

Para habilitar o Servidor MCP:

1. Vá para Configurações do Admin > Aplicativos e integrações > MCP.
2. Escolha o escopo.
   1. Organização: Qualquer usuário na sua organização pode autorizar o MCP para boards aos quais já têm acesso.
   2. Time(s) selecionado(s): Somente usuários nesses times podem autorizar o MCP. As permissões no nível do board ainda se aplicam.
3. Ative. As alterações entram em vigor imediatamente.

Para interromper temporariamente o uso, desative o Miro MCP no mesmo local (interrompe novas chamadas de ferramenta).

NOTA: Se você não vir o botão de alternância do MCP, entre em contato com seu gerente de conta.

Como funcionam o acesso e as permissões

Ao ativar 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 da Miro.
• troca segura de dados entre a Miro e aplicativos de terceiros.

Considerações importantes sobre segurança:

• Todo o acesso é autenticado por OAuth 2.1.
• Os usuários só podem conceder acesso a boards que têm permissão para visualizar.
• A conformidade de segurança do Enterprise é mantida.
• Os limites de taxa padrão da API aplicam-se 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 ou de terceiros leiam e criem conteúdo em um board em nome deles.

Gerenciar o MCP na sua organização

Como admin, você deve considerar:

1. Comunicação: Informe seus times sobre a disponibilidade do MCP da Miro e casos de uso.
2. Treinamento: Forneça orientação sobre como usar o MCP de forma eficaz com diferentes ferramentas de IA.
3. Governança: Estabeleça diretrizes para o uso apropriado de conteúdo gerado por IA.
4. Monitoramento: Revise periodicamente o uso do MCP e ajuste as configurações conforme necessário.

Para mais informações sobre como gerenciar apps no seu ambiente na 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 do MCP.

Controlar quais clientes MCP podem se conectar à Miro

Como Admin da empresa, você pode permitir que todos os clientes acessem a Miro a partir da sua organização ou gerenciar uma lista de clientes permitidos, incluindo seus próprios clientes MCP personalizados.

Siga estas etapas:

1. No console de admin, acesse Apps e integrações > MCP. Se ainda não ativou o MCP, consulte Ativar MCP.
2. Em Controle de acesso, Todos os clientes é a configuração padrão. Para modificar, clique em Todos os clientes, em seguida clique em Clientes específicos.
   O painel Clientes MCP específicos é exibido.
3. Ative os clientes que deseja permitir. Para permitir um cliente MCP personalizado, insira o nome do seu cliente na barra de pesquisa (no topo) e clique em Adicionar. Para mais informações, consulte a documentação para desenvolvedores do Miro MCP.
4. Clique em Salvar.
   O painel fecha e os clientes especificados aparecem em uma linha em Controle de acesso.

DICA: Para desautorizar um cliente, volte para Apps e integrações > MCP > Todos os clientes (em Controle de acesso) e desative o cliente. 

NOTA: Se você adicionar um cliente MCP personalizado e depois o desautorizar, o cliente será removido da lista. Para permitir novamente, você deve adicioná-lo novamente. Veja o passo 3 em Controlar quais clientes MCP podem conectar-se à Miro. 

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 o MCP ativado.
  • Verifique se o cliente oferece suporte ao MCP e está entre os clientes que estamos direcionando/documentando.
• “Acesso negado ao usar o prompt”
  • Garanta que o prompt inclua a URL completa do board; os agentes não vão descobrir 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 de administrador > Apps e integrações > Miro MCP.
• "O cliente de um usuário está bloqueado / retorna um erro de acesso"
  • Verifique se o cliente está ativado em Controle de acesso, ou adicione-o como cliente personalizado.