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

• Ative o MCP para sua organização e, em seguida, use Controle de acesso para decidir quem pode usá-lo.
• Você pode manter o acesso aberto a todos ou limitá-lo a times selecionados e, opcionalmente, a grupos de usuários. As permissões em nível de board ainda se aplicam.

Ativar ou desativar o MCP Server

Para ativar o MCP Server:

1. Vá para Configurações do administrador > Aplicativos e integrações > MCP.
2. Em Ativar MCP, ative Permitir que os usuários da sua organização conectem a Miro a clientes compatíveis com MCP.

As alterações entram em vigor imediatamente.

Para interromper temporariamente o uso, desative a mesma opção (impede novas chamadas de ferramentas).

O MCP pode usar a Miro AI para gerar formatos ou executar ações relacionadas ao conteúdo. Essas ações consomem os créditos da Miro AI da sua organização.

Se você não vir as configurações do MCP, entre em contato com seu gerente de conta.

Controlar o acesso com times e grupos de usuários

Em Controle de acesso > Times e grupos de usuários, escolha quem pode usar o Miro MCP após ativá-lo.

Restringir o acesso a times e grupos de usuários específicos

1. No console de admin, vá para Apps e integrações > MCP.
2. Em Controle de acesso, abra o menu suspenso Times e grupos de usuários e selecione Times e grupos de usuários específicos.
   O painel Adicionar acesso ao MCP é exibido.
3. Selecionar times:
   1. Escolha Todos os times da sua organização ou Times específicos.
   2. Se escolher Times específicos, abra o seletor de times, pesquise e selecione os times, clique em Adicionar times e retorne ao painel.
   3. Clique em Próximo.
4. Filtrar por grupos de usuários:
   1. Escolha Todos os usuários dos times selecionados ou Somente usuários que também estão em grupos de usuários específicos.
   2. Se você escolher grupos de usuários específicos, abra o seletor de grupos de usuários, pesquise e selecione grupos, clique em Adicionar grupos de usuários e depois volte ao painel.
   3. Clique em Próximo.
5. Revisar e confirmar o resumo (por exemplo, usuários em 6 times que também estão em 1 grupo de usuários terão acesso ao Miro MCP). Você pode clicar em Editar para alterar times ou grupos de usuários.
6. Clique em Adicionar acesso.

Como funciona o acesso por times e grupos de usuários

Quando você usa Times e grupos de usuários específicos, um usuário só pode autorizar o Miro MCP se cumprir ambas as condições que você configurou:

1. Pertence a um time selecionado (ou a qualquer time, se você escolheu Todos os times).
2. Se você selecionou grupos de usuários, o usuário também deve pertencer a pelo menos um desses grupos.

Se você escolher Todos os usuários em times selecionados, apenas o requisito de time se aplica.

Apenas pertencer a um grupo de usuários não é suficiente. O usuário também precisa estar em um time selecionado.

Quando você selecionar mais de um grupo de usuários, o usuário precisa pertencer a qualquer um deles (não a todos).

Exemplos

• Todos: Qualquer usuário em um time habilitado pode autorizar o MCP.
• Times específicos (por exemplo A e B), todos os usuários nos times selecionados: Usuários no Time A ou no Time B podem autorizar o MCP. Usuários apenas no Time C não podem.
• Times específicos (Time A) e grupos de usuários específicos (Grupo de Usuários 1): Apenas usuários que estejam no Time A e no Grupo de Usuários 1 podem autorizar o MCP. Por exemplo, se o Time A tem 100 membros e o Grupo de Usuários 1 inclui 20 deles, apenas esses 20 podem usar o MCP.
• Todos os times e grupos de usuários específicos: Usuários em qualquer time que também pertençam a um grupo de usuários selecionado podem autorizar o MCP.
• Voltar para Todos: O acesso não está mais limitado aos times e grupos de usuários que você selecionou no painel.

Como o acesso e as permissões funcionam

Ao ativar o MCP, você permite:

• Agentes externos de IA para ler o conteúdo do board quando autorizados pelos usuários.
• Ferramentas de IA para criar ou modificar conteúdo em boards da Miro.
• Troca segura de dados entre a Miro e aplicativos de terceiros.

Considerações importantes sobre segurança:

• Todo acesso é autenticado por OAuth 2.1.
• Os usuários só podem conceder acesso a boards que possam visualizar.
• A conformidade de segurança empresarial é mantida.
• Aplicam-se limites de taxa padrão da API a todas as operações.
• 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.
• Se você restringir o MCP por time e grupos de usuários, usuários fora dessa seleção não poderão autorizar o MCP.

Gerenciar o MCP na sua organização

Como admin, considere:

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

Para obter mais informações sobre como gerenciar aplicativos no seu ambiente Miro, consulte a documentação de gerenciamento de aplicativos.

Orientações para implantação

• Comece pequeno: em Controle de acesso, escolha Times e grupos de usuários específicos, selecione um ou dois times piloto e deixe os grupos de usuários como Todos os usuários nos times selecionados.
• Para um piloto mais restrito, escolha também Apenas usuários que também fazem parte de grupos de usuários específicos, assim somente esse grupo poderá autorizar o MCP.
• Reforce a higiene de prompts: exija que os usuários incluam a URL completa do board em cada prompt do MCP.

Controle 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, vá para Apps e integrações > MCP. Se você ainda não ativou o MCP, consulte Ativar ou desativar o servidor MCP.
2. Sob Controle de acesso, a opção Todos os clientes é a configuração padrão. Para modificar, clique em Todos os clientes e depois em Clientes específicos.
   O painel Clientes MCP específicos é exibido.
3. Ative os clientes que deseja permitir. Para permitir um cliente MCP personalizado, digite o nome do 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 sob Controle de acesso.

Retorne a Apps e integrações > MCP > Todos os clientes (em Controle de acesso) e desative o cliente.

Se você adicionar um cliente MCP personalizado e depois o desautorizar, ele será removido da lista. Para autorizar novamente, é preciso adicioná-lo novamente. Veja o passo 3 em Controle quais clientes MCP podem se conectar à Miro.

Solução de problemas

• “Não consigo ver as ferramentas no MCP da Miro no meu cliente”
  • Confirme que o MCP está ativado para a organização.
  • Em Controle de acesso > Times e grupos de usuários, confirme que o usuário está incluído (em um time selecionado e em um grupo de usuários selecionado, se você configurou um).
  • Execute novamente o fluxo OAuth e selecione um time com acesso ao MCP.
  • Verifique se o cliente suporta MCP e está entre os clientes que documentamos.
• “Acesso negado ao enviar o prompt”
  • Garanta que o prompt inclua 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.
  • Se o usuário antes tinha acesso e parou de funcionar, verifique se o controle de acesso em Times e grupos de usuários foi alterado ou se o usuário foi removido de um time ou de um grupo de usuários selecionado.
• “Precisamos pausar o uso agora”
  • Desative o MCP em Configurações do Admin > Aplicativos e integrações > MCP.
• "O cliente de um usuário está bloqueado / retorna um erro de acesso"
  • Confirme se o cliente está ativado em Controle de acesso, ou adicione-o como cliente personalizado.